Theme
Create DALL·E 3
POST
https://www.kkiai.com/v1/images/generations
Given a prompt and/or input image, the model will generate new images.
Related guide: Image generation
Create images based on a prompt.
Request Parameters
Header Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
Authorization | string | Optional | Bearer {{YOUR_API_KEY}} |
Body Parameters (application/json)
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | A text description of the desired image. Maximum length is 1000 characters. |
model | string | Optional | The model to use for image generation. |
n | integer | Optional | The number of images to generate. Must be between 1 and 10. |
quality | string | Optional | The quality of the generated images. hd creates images with finer details and higher consistency. This parameter is only supported for dall-e-3. |
response_format | string | Optional | The format in which the generated images are returned. Must be one of url or b64_json. |
style | string | Optional | The style of the generated images. This parameter is only supported for dall-e-3. Must be one of vivid or natural. Vivid causes the model to lean towards generating hyper-real and dramatic images. Natural causes the model to generate more natural, less hyper-real looking images. |
user | string | Optional | A unique identifier representing your end-user, which can help OpenAI monitor and detect abuse. |
size | string | Optional | The size of the generated images. Must be one of 1024x1024, 1536x1024 (landscape), 1024x1536 (portrait), or auto (default) for gpt-image-1; one of 256x256, 512x512, or 1024x1024 for dall-e-2; and one of 1024x1024, 1792x1024, or 1024x1792 for dall-e-3. |
Request Example
json
{
"model": "dall-e-3",
"prompt": "A cute baby sea otter",
"n": 1,
"size": "1024x1024"
}cURL Example
bash
curl --location --request POST 'https://www.kkiai.com/v1/images/generations' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "dall-e-3",
"prompt": "A cute baby sea otter",
"n": 1,
"size": "1024x1024"
}'Response
🟢 200 Create image
Response Body
| Parameter | Type | Required | Description |
|---|---|---|---|
created | integer | Required | |
data | array[object] | Required | |
└ url | string | Required |
Response Example
json
{
"created": 1749819664,
"data": [
{
"content_filter_results": {
"hate": {
"filtered": false,
"severity": "safe"
},
"self_harm": {
"filtered": false,
"severity": "safe"
},
"sexual": {
"filtered": false,
"severity": "safe"
},
"violence": {
"filtered": false,
"severity": "safe"
}
},
"prompt_filter_results": {
"hate": {
"filtered": false,
"severity": "safe"
},
"profanity": {
"detected": false,
"filtered": false
},
"self_harm": {
"filtered": false,
"severity": "safe"
},
"sexual": {
"filtered": false,
"severity": "safe"
},
"violence": {
"filtered": false,
"severity": "safe"
}
},
"revised_prompt": "A young, adorable sea otter floating in the ocean",
"url": "https://dalleproduse.blob.core.windows.net/private/images/6b0ee3bd-fe24-46c7-8ab8-85be87b00eaf/generated_00.png?se=2025-06-14T13%3A01%3A13Z&sig=9pLM1cLo1Af6FKRZc2AZSVxfSQBBBIyzfg0cOiT7C%2B0%3D&ske=2025-06-13T23%3A43%3A31Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2025-06-06T23%3A43%3A31Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02"
}
]
}