图像变体 - UniAPI API Doc

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data

image

file

必需

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

model

可选

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

Any of

allOf {2}

One of

null

string

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

默认值:

dall-e-2

示例值:

dall-e-2

n

integer | null

可选

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

>= 1<= 10

默认值:

1

示例值:

1

response_format

enum<string> | enum<null>

可选

返回生成的图像的格式。必须是 url 或 b64_json 之一。URL 仅在图像生成后 60 分钟内有效。

枚举值:

urlb64_json

默认值:

url

示例值:

url

size

enum<string> | enum<null>

可选

生成的图像大小。必须是以下之一：256x256、512x512或1024x1024。

枚举值:

256x256512x5121024x1024

默认值:

1024x1024

示例值:

1024x1024

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

返回响应

🟢200成功

application/json

OK

Body

来自图像生成端点的响应。

created

integer

必需

图片创建时的Unix时间戳（以秒为单位）。

data

array[object (Image) {3}]

生成的图像列表。

可选

b64_json

string

可选

生成图像的 base64 编码 JSON。gpt-image-1 的默认值，仅当 dall-e-2 和 dall-e-3 的 response_format 设置为 b64_json 时存在。

url

string

可选

使用 dall-e-2 或 dall-e-3 时，如果将 response_format 设置为 url（默认值），生成图像的 URL 将被返回。gpt-image-1 不支持此功能。

revised_prompt

string

可选

仅针对 dall-e-3，用于生成图像的修订提示。

usage

object

可选

仅针对 gpt-image-1，图像生成的令牌使用信息。

total_tokens

integer

必需

用于图像生成的令牌总数（图像和文本）。

input_tokens

integer

必需

输入提示中的标记数量（图像和文本）。

output_tokens

integer

必需

输出图像中的图像标记数量。

input_tokens_details

object

必需

输入令牌的详细信息用于图像生成。

示例

{
    "created": 0,
    "data": [
        {
            "b64_json": "string",
            "url": "string",
            "revised_prompt": "string"
        }
    ],
    "usage": {
        "total_tokens": 0,
        "input_tokens": 0,
        "output_tokens": 0,
        "input_tokens_details": {
            "text_tokens": 0,
            "image_tokens": 0
        }
    }
}