Create image variation

POST

https://api.openai.com/v1/images/variations

Creates a variation of a given image.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.openai.com/v1/images/variations' \
--header 'Authorization: Bearer ' \
--form 'image=@"cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjc=/31225951_59371037e9_small.png"' \
--form 'n="2"' \
--form 'size="1024x1024"' \
--form 'response_format="url"' \
--form 'user=""'

Response Example

{
    "created": 1589478378,
    "data": [
        {
            "url": "https://..."
        },
        {
            "url": "https://..."
        }
    ]
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params multipart/form-data

image

file

required

The image to use as the basis for the variation(s). Must be a valid PNG file, less than 4MB, and square.

Example:

cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjc=/31225951_59371037e9_small.png

string

optional

The number of images to generate. Must be between 1 and 10.

Example:

size

string

optional

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

Example:

1024x1024

response_format

string

optional

The format in which the generated images are returned. Must be one of url or b64_json.

Example:

url

user

string

optional

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

Responses

🟢200成功

application/json

Body

created

integer

required

data

array [object {1}]

required

url

string

required

Modified at 2024-12-23 06:20:38

Create image edit

List models