图像编辑

POST

/v1/images/edits

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.uniapi.io/v1/images/edits' \
--form 'image=""' \
--form 'prompt="A cute baby sea otter wearing a beret"'

响应示例

{
    "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
        }
    }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data

image

必需

要编辑的图像。必须是支持的图像文件或图像数组。

对于 gpt-image-1，每个图像应为小于25MB的 png、webp 或 jpg 文件。您最多可以提供16张图像。

对于 dall-e-2，您只能提供一张图像，且应为小于4MB的正方形 png 文件。

Any of

string<binary>

array[string <binary>]

prompt

string

必需

所需图像的文字描述。dall-e-2的最大长度为1000个字符，gpt-image-1的最大长度为32000个字符。

示例值:

A cute baby sea otter wearing a beret

mask

file

可选

一个额外的图像，其完全透明的区域（例如，alpha为零的地方）表示应编辑image的位置。如果提供了多个图像，掩码将应用于第一个图像。必须是有效的PNG文件，大小小于4MB，并且与image具有相同的尺寸。

model

可选

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

Any of

allOf {2}

One of

null

string

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

默认值:

dall-e-2

示例值:

gpt-image-1

integer | null

可选

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

>= 1<= 10

默认值:

示例值:

size

enum<string> | enum<null>

可选

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

枚举值:

256x256512x5121024x10241536x10241024x1536auto

默认值:

1024x1024

示例值:

1024x1024

response_format

enum<string> | enum<null>

可选

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

枚举值:

urlb64_json

默认值:

url

示例值:

url

user

string

可选

表示您的终端用户的唯一标识符，有助于 OpenAI 监控和检测滥用行为。

示例值:

user-1234

quality

enum<string> | enum<null>

可选

将生成的图像质量。high、medium 和 low 仅支持 gpt-image-1。dall-e-2 仅支持 standard 质量。默认值为 auto。

枚举值:

standardlowmediumhighauto

默认值:

auto

示例值:

high

返回响应

🟢200成功

application/json

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

必需

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

修改于 2025-05-18 07:36:21

向量接口

图像生成