OpenAI API | Images › Create Image

The quality of the image that will be generated. hd creates images with finer details and greater consistency across the image. This param is only supported for dall-e-3.

response_format?: "url" | "b64_json"

The format in which the generated images are returned. Must be one of url or b64_json. URLs are only valid for 60 minutes after the image has been generated.

size?: "256x256" | "512x512" | "1024x1024" | 2 more...

The size of the generated images. Must be one of 256x256, 512x512, or 1024x1024 for dall-e-2. Must be one of 1024x1024, 1792x1024, or 1024x1792 for dall-e-3 models.

style?: "vivid" | "natural"

The style of the generated images. 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 produce more natural, less hyper-real looking images. This param is only supported for dall-e-3.

user?: string

A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. Learn more.

Response fields

ImagesResponse

Request example

curl https://api.openai.com/v1/images/generations \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
      "prompt": "A cute baby sea otter",
      "model": "dall-e-3",
      "n": 1,
      "quality": "standard",
      "response_format": "url",
      "size": "256x256",
      "style": "vivid",
      "user": "user-1234"
    }'

200Example

{
  "created": 0,
  "data": [
    {
      "b64_json": "b64_json",
      "revised_prompt": "revised_prompt",
      "url": "url"
    }
  ]
}

Domain types

Image = { b64_json, revised_prompt, url }

ImageModel = "dall-e-2" | "dall-e-3"

ImagesResponse = { created, data }