图像编辑 gpt-image

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data

image

file

必需

源图像（最多传入4张图）
要编辑的图像 File 对象或对象数组。必须是有效的 PNG 文件且小于 4MB。必须是png、jpg、webp 等格式。

prompt

string

必需

提示词，所需图像的文本描述。最大长度为 1000 个字符。

示例:

让小狗微笑

mask

file

可选

File对象，一个遮罩图像，其完全透明的区域将是被编辑的位置。必须是有效的 PNG 文件，小于 4MB，并且尺寸与 image 一致。

model

enum<string>

可选

模型名称，用于图像生成的模型。

枚举值:

chatgpt-image-latestgpt-image-1.5gpt-image-1

示例:

gpt-image-1

n

number

可选

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

示例:

1

background

enum<string>

可选

仅支持 gpt-image-1 模型。允许设置生成图像背景的透明度。仅输出格式为 png、webp 时支持该参数。

枚举值:

autotransparentopaque

默认值:

auto

response_format

string

可选

数据格式， gpt-image-1 不支持该参数。
返回生成图像的数据格式。必须是 url 或 b64_json之一。URL 仅在图像生成后的 60 分钟内有效。

size

string

可选

图片尺寸，生成的图片尺寸
dall-e-2 支持的尺寸 256x256、512x512、1024x1024。
gpt-image-1 支持的尺寸 1024x1024、1024x1536、1536x1024。

设置为 auto 将与原图尺寸一致。

示例:

1024x1024

quality

string

可选

图片质量，可选。参考图片生成

user

string

可选

用户，代表您的最终用户的唯一标识符，可以帮助 OpenAI监控和检测滥用行为。了解更多

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.pawmaas.com/v1/images/edits' \
--header 'Authorization: Bearer <token>' \
--form 'image=@""' \
--form 'prompt="让小狗微笑"' \
--form 'mask=@""' \
--form 'model="gpt-image-1"' \
--form 'n="1"' \
--form 'background=""' \
--form 'response_format=""' \
--form 'size="1024x1024"' \
--form 'quality=""' \
--form 'user=""'

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object]

必需

url

string

可选

示例

{
    "created": 1589478378,
    "data": [
        {
            "url": "https://..."
        },
        {
            "url": "https://..."
        }
    ]
}