API reference

创建图像变化

POST

/v1/images/variations

最后修改时间：2025-05-28 04:32:29

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

可选

默认值:

Body 参数multipart/form-data

image

file

必需

用作变体基础的图像。必须是有效的 PNG 文件，大小小于 4MB，并且是正方形。

model

string

可选

用于生成图像的模型。目前仅支持 dall-e-2。

示例值:

dall-e-2

integer

可选

要生成的图像数量。必须介于 1 到 10 之间。

示例值:

response_format

string

可选

返回生成图像的格式。必须是 url 或 b64_json 之一。URL 在图像生成后 60 分钟内有效。此参数仅适用于 dall-e-2，因为 gpt-image-1 始终返回 base64 编码的图像。

示例值:

url

size

string

可选

生成图像的尺寸。对于 gpt-image-1，必须为 1024x1024、1536x1024（横向）、1024x1536（纵向）或 auto（默认值）之一；对于 dall-e-2，必须为 256x256、512x512 或 1024x1024 之一。

示例值:

1024x1024

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/v1/images/variations' \
--header 'Authorization: ' \
--form 'image=@""' \
--form 'model="dall-e-2"' \
--form 'n="1"' \
--form 'response_format="url"' \
--form 'size="1024x1024"'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

创建图像编辑

创建嵌入