图片编辑 (gpt-image-2)

基于一张或多张参考图 + 提示词，生成编辑后的图片，支持局部蒙版重绘（mask）与保真度控制（input_fidelity）。gpt-image-2 的编辑接口在 中文字符 / 非拉丁字符渲染、高分辨率（最高 2K）、多图融合 三个方面相比 gpt-image-1.5 有显著提升。

官方文档：https://platform.openai.com/docs/api-reference/images/createEdit

⚠️ 注意事项

请求体为 multipart/form-data，不是 JSON；请在 Apifox 的 Body 类型里选 form-data。

image 字段支持一次传多张参考图，最多 16 张（OpenAI 官方上限）。多张的做法是重复同名字段 image，或写作 image[]。

涉及在世艺术家姓名（如「宫崎骏」「新海诚」）、受版权保护的角色 / 品牌标志 / 名人肖像，会触发 moderation_blocked 报错。

如果请求里有任意一张参考图被判定违反平台策略，整个请求都不会被返回。

transparent 背景本网关暂不支持，会返回：Transparent background is not supported for this model.

🎯 关键提示

image：参考图，支持 png / jpeg / webp，单张最大 25 MB；多张建议不超过 6 张以保证可控性。

mask：可选的蒙版，和 image[0] 尺寸必须一致，PNG 带 alpha 通道；

alpha=0 的区域会被重绘

alpha=255 的区域保留原像素

input_fidelity：

low（默认）：允许模型大幅改动原图，更适合"把风格换掉"的场景

high：尽量保留原图主体特征（人脸、商品细节），更适合"微调衣着 / 背景替换"的场景

size / quality / output_format / n 的取值规则与 /v1/images/generations 完全一致，参考图片生成接口文档。

n 支持 1-10，单次返回多张；想批量生图优先用 n，不要客户端并发。

💡 实用提示

想做 "保留人物 / 替换背景"，推荐组合：input_fidelity=high + mask（把人物区域 alpha=255 锁住）。

想做 "风格迁移"（把写实照片转成插画风），推荐组合：input_fidelity=low，不传 mask。

多图融合（比如把两张参考图合成一张新构图），直接把两张都传进 image 字段即可，不需要 mask。

中文文字渲染在 edits 下同样稳定；若想保留参考图上的原始文字，请显式在 prompt 中写「保留图中文字『XXX』，不要修改文字内容」。

响应固定返回 data[].b64_json（base64），不返回 URL。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "created": 1745260998,
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSUhEUgAA......（base64 省略）"
        }
    ],
    "size": "1024x1024",
    "quality": "medium",
    "output_format": "png",
    "background": "opaque",
    "usage": {
        "total_tokens": 512,
        "input_tokens": 84,
        "output_tokens": 428,
        "input_tokens_details": {
            "text_tokens": 24,
            "image_tokens": 60
        }
    }
}

图片编辑image2

图片编辑 (gpt-image-2)

⚠️ 注意事项

🎯 关键提示

💡 实用提示

请求参数

请求示例代码

返回响应

图片编辑image2

图片编辑 (gpt-image-2)#

⚠️ 注意事项#

🎯 关键提示#

💡 实用提示#

请求参数

请求示例代码

返回响应

图片编辑 (gpt-image-2)

⚠️ 注意事项

🎯 关键提示

💡 实用提示