图片编辑接口，multipart/form-data 格式，不推荐

将废弃

POST

/v1/images/edits

OpenAI 兼容的 multipart/form-data 图片编辑格式。该接口保留兼容，但不推荐优先使用。

不推荐原因：

multipart 调试成本更高。

URL 图片需要先下载成文件再上传。

与 JSON 格式相比，在中转场景中更容易出现超时或链路问题。

推荐替代：

使用 /v1/images/generations。

在 JSON 请求体中传 image: [url1, url2]。

兼容字段名：

image

image[]

images

images[]

image_0 / image_1

mask

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/images/edits' \
--header 'Authorization: Bearer <token>' \
--form 'model="gpt-image-2"' \
--form 'prompt="把背景换成海滩，保留人物姿势和服装"' \
--form 'image="";type=image/png, image/jpeg, image/webp' \
--form 'mask=@""' \
--form 'n="1"' \
--form 'size="1024x1024"'

返回响应

🟢200

application/json

图片编辑成功响应。可能返回图片 URL，也可能返回 base64 图片数据。

Bodyapplication/json

示例

{
    "created": 1776768940,
    "data": [
        {
            "url": "https://example.com/generated/example.webp",
            "b64_json": "iVBORw0KGgo...",
            "revised_prompt": "",
            "property1": "string",
            "property2": "string"
        }
    ],
    "property1": "string",
    "property2": "string"
}

🟠400ErrorResponse

🟠401ErrorResponse

🔴500ErrorResponse

修改于 2026-04-22 02:51:52

图片生成/图生图接口，支持 image 数组传 URL 或 base64

创建图像