Skip to content

Create DALL·E 3

POST https://www.kkiai.com/v1/images/generations

Images

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

ParameterTypeRequiredDescriptionExample
AuthorizationstringOptionalBearer {{YOUR_API_KEY}}

Body Parameters (application/json)

ParameterTypeRequiredDescription
promptstringRequiredA text description of the desired image. Maximum length is 1000 characters.
modelstringOptionalThe model to use for image generation.
nintegerOptionalThe number of images to generate. Must be between 1 and 10.
qualitystringOptionalThe quality of the generated images. hd creates images with finer details and higher consistency. This parameter is only supported for dall-e-3.
response_formatstringOptionalThe format in which the generated images are returned. Must be one of url or b64_json.
stylestringOptionalThe 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.
userstringOptionalA unique identifier representing your end-user, which can help OpenAI monitor and detect abuse.
sizestringOptionalThe 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

ParameterTypeRequiredDescription
createdintegerRequired
dataarray[object]Required
  └ urlstringRequired

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"
        }
    ]
}