编辑图像 / Edit Images (gpt-image-2)

POST

/v1/images/edits

编辑 / 重绘已有图像。

image: 文件 / http(s) URL / data:image/...;base64,...。不接受裸 base64 或 image_url 字段名

多图: image 重复 / image[] / image[N]，最多 16 张，单图 ≤ 25 MB

格式: png / jpeg / webp（webp 输出当前会降级为 PNG）

耗时 15-180s，建议 timeout ≥ 240s；并发下偶发 524，建议重试

默认 moderation: low

请求参数

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 'image=@""' \
--form 'prompt="add a watercolor border around this image"' \
--form 'size="1024x1024"' \
--form 'quality="auto"' \
--form 'output_format="jpeg"' \
--form 'output_compression=""' \
--form 'background="auto"' \
--form 'response_format="url"' \
--form 'moderation="low"' \
--form 'user=""'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "created": 0,
    "data": [
        {
            "url": "http://example.com",
            "b64_json": "string",
            "revised_prompt": "string"
        }
    ],
    "background": "auto",
    "output_format": "png",
    "quality": "auto",
    "size": "string",
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "total_tokens": 0
    },
    "model": "string"
}

🟢200审核拒绝

🟠400参数错误

🟠401

🟠429

🔴500

🔴502上游错误

修改于 2026-05-07 07:35:52

图像生成

图像生成（Gemini 原生）