编辑 OpenAI 图片

POST

/v1/images/edits

一、gpt-image-2 文生图

文生图使用共用生成路径 /v1/images/generations，请求体中的 model 固定为 gpt-image-2。

二、gpt-image-2 图片编辑

当前接口使用 multipart/form-data 上传原图并编辑。image 为必填图片文件，mask 为可选蒙版；蒙版透明区域表示需要编辑的位置。

Seedream 的 URL/Base64 单图编辑和多图融合使用 /v1/images/generations，请查看 Seedream 章节。

请求参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/images/edits' \
--form 'model="gpt-image-2"' \
--form 'prompt=""' \
--form 'image=@""' \
--form 'mask=@""' \
--form 'n="1"' \
--form 'size="1024x1024"' \
--form 'quality="high"' \
--form 'response_format="url"' \
--form 'stream="false"'

返回响应

🟢200成功

application/json

图片编辑结果。

Bodyapplication/json

示例

{
    "created": 1786400000,
    "data": [
        {
            "url": "https://assets.example.com/generated/edited-image.png"
        }
    ],
    "usage": {
        "prompt_tokens": 32,
        "completion_tokens": 1024,
        "total_tokens": 1056
    }
}

🟠400请求有误

🟠401没有权限

🟠429

🔴500服务器错误

修改于 2026-08-11 07:04:03

gpt-image-2 图片生成

ModelListResponse