Body
Required
-
The image to use as the basis for the variation(s). Must be a valid PNG file, less than 4MB, and square.
-
The number of images to generate. Must be between 1 and 10. For
dall-e-3
, onlyn=1
is supported.Minimum value is
1
, maximum value is10
. Default value is1
. -
The format in which the generated images are returned. Must be one of
url
orb64_json
. URLs are only valid for 60 minutes after the image has been generated.Values are
url
orb64_json
. Default value isurl
. -
The size of the generated images. Must be one of
256x256
,512x512
, or1024x1024
.Values are
256x256
,512x512
, or1024x1024
. Default value is1024x1024
. -
A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. Learn more.
POST
/images/variations
curl \
--request POST 'https://api.openai.com/v1/images/variations' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: multipart/form-data" \
--form "image=@file" \
--form "model=dall-e-2" \
--form "n=1" \
--form "response_format=url" \
--form "size=1024x1024" \
--form "user=user-1234"
Response examples (200)
{
"created": 42,
"data": [
{
"b64_json": "string",
"url": "string",
"revised_prompt": "string"
}
]
}