图像编辑 - API接口调用

请求参数

Body 参数multipart/form-data

image

file

必需

源图像，要编辑的图像 File 对象。必须是有效的 PNG 文件且小于 4MB，并且是正方形。如果未提供 mask，则图像必须具有透明度，该透明度将用作 mask。

prompt

string

必需

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

示例值:

让小狗微笑

mask

file

可选

File对象，一个遮罩图像，其完全透明的区域（例如 alpha 为零的位置）指示应编辑的位置。必须是有效的 PNG 文件，小于 4MB，并且尺寸与 image 一致。

model

string

可选

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

示例值:

dall-e-2

n

number

可选

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

示例值:

1

response_format

string

可选

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

size

string

可选

图片尺寸，生成的图片尺寸，支持的尺寸 256x256、512x512、1024x1024。

示例值:

1024x1024

user

string

可选

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

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v1/images/edits' \
--form 'image=@""' \
--form 'prompt="让小狗微笑";type=multipart/form-data' \
--form 'mask=@""' \
--form 'model="dall-e-2"' \
--form 'n="1"' \
--form 'response_format=""' \
--form 'size="1024x1024"' \
--form 'user=""'

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object {1}]

必需

url

string

必需

示例

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