Create image variations

Depending on the model, you can control the number of variations, size, and response format.

POST/v1/images/variations

Generate one or more visual variants based on a single input image. Input images must meet the format, size, and size requirements supported by the selected model. Whether the model supports image variants depends on the actual capability of the model visible in the current API Key

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Request Body

multipart/form-data

Use Multipart to submit the variant source image. The client should automatically generate the Content-Type boundary from the request library.

TypeScript Definitions

Use the request body type in TypeScript.

image*file

Images as the basis for the variant. Please use a square PNG smaller than 4 MB; Actual file limits are based on the selected model.

Formatbinary

model?string

The image variant model ID to use. Please select the model that is visible to the current API Key and supports image variants.

Length1 <= length

n?integer|null

Number of image variants to return, ranging from 1 to 10, with actual supported numbers depending on the selected model.

Range1 <= value <= 10

Default1

response_format?string|null

Image response format. url returns an image URL that remains valid for 60 minutes after generation; b64_json returns Base64-encoded image data.

Default"url"

Value in

"url"
"b64_json"
null

size?string|null

Image size, supporting 256x256, 512x512, and 1024x1024.

Default"1024x1024"

Value in

"256x256"
"512x512"
"1024x1024"
null

user?string

Unique identifier for the end user, used to help monitor and detect abuse.

Length1 <= length

Response Body

`application/json`

curl -X POST "https://example.com/v1/images/variations" \  -F image="otter.png" \  -F model="MODEL_ID" \  -F n="2" \  -F size="1024x1024"

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/image-variation-1.png"
    },
    {
      "url": "https://example.com/image-variation-2.png"
    }
  ]
}

Authorization

Request Body

Response Body

200application/json

401application/json

`application/json`

`application/json`