创建图片变体

可按模型能力控制变体数量、尺寸和返回格式。

POST/v1/images/variations

根据一张输入图片生成一个或多个视觉变体。输入图片必须符合所选模型支持的格式、大小和尺寸要求。

模型是否支持图片变体，以当前 API Key 可见模型的实际能力为准。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

multipart/form-data

使用 Multipart 提交变体来源图片。客户端应由请求库自动生成 Content-Type 的 boundary。

TypeScript Definitions

Use the request body type in TypeScript.

image*file

作为变体基础的图片。请使用小于 4 MB 的正方形 PNG；实际文件限制以所选模型为准。

Formatbinary

model?string

要使用的图片变体模型 ID。请选择当前 API Key 可见且支持图片变体的模型。

Length1 <= length

n?integer|null

要返回的图片变体数量，取值范围为 1 到 10，实际支持数量取决于所选模型。

Range1 <= value <= 10

Default1

response_format?string|null

图片返回格式。url 返回图片地址，该地址在生成后 60 分钟内有效；b64_json 返回 Base64 编码图片数据。

Default"url"

Value in

"url"
"b64_json"
null

size?string|null

图片尺寸，支持 256x256、512x512 和 1024x1024。

Default"1024x1024"

Value in

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

user?string

代表最终用户的唯一标识符，可用于监控和检测滥用行为。

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`