创建图像变化 - API reference

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Authorization

string

optional

Default:

Body Params multipart/form-data

image

file

required

要编辑的图片。必须是受支持的图片文件或图片数组。对于 gpt-image-1，每张图片应为小于 25MB 的 png、webp 或 jpg 文件。对于 dall-e-2，您只能提供一张图片，并且该图片应为小于 4MB 的方形 png 文件。

Example:

file:///Users/zcz/Downloads/4f73d8b6-7b82-4217-84e2-27f27173f81f.png

model

string

optional

用于生成图像的模型。仅支持 dall-e-2 和 gpt-image-1。除非使用特定于 gpt-image-1 参数，否则默认为 dall-e-2。

Example:

dall-e-2

n

integer

optional

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

Example:

1

response_format

string

optional

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

Example:

url

size

string

optional

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

Example:

1024x1024

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '/v1/images/variations' \
--header 'Authorization: ' \
--form 'image=@"/Users/zcz/Downloads/4f73d8b6-7b82-4217-84e2-27f27173f81f.png"' \
--form 'model="dall-e-2"' \
--form 'n="1"' \
--form 'size="1024x1024"'

Responses

🟢200成功

application/json

Body

object {0}

Example

{}