OpenAI API | Images › Create Image Variation

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"

The size of the generated images. Must be one of 256x256, 512x512, or 1024x1024.

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/variations \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -F image=file.txt \
    -F model=dall-e-2 \
    -F n=1 \
    -F response_format=url \
    -F size=256x256 \
    -F user=user-1234

200Example

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

Create Image Edit ->

ImagesResponse

post/images/edits

Creates an edited or extended image given an original image and a prompt.

Create Image ->

ImagesResponse

post/images/generations

Creates an image given a prompt.

Domain types

Image = { b64_json, revised_prompt, url }

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

ImagesResponse = { created, data }