图片编辑 (gpt-image-2)

令牌分组请选择openai分组

基于一张或多张参考图 + 提示词，生成编辑后的图片，支持局部蒙版重绘（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.

请避免生成以下类型内容：

未成年人相关不当内容，包括色情、性暴力、非自愿亲密内容、明显以性满足为目的的成人内容

血腥暴力、恐怖主义、极端主义、武器制作、违法或危险行为

自伤、自杀、进食障碍、危险挑战等可能造成现实伤害的内容

仇恨、骚扰、威胁、欺凌、诽谤或针对受保护群体的攻击

未授权真人肖像、名人肖像/公众人物、证件照、监控照或可能混淆真实性的人像内容

隐私信息、敏感个人信息、金融/医疗/法律等可能影响个人权益的内容

版权角色、品牌 Logo、水印移除、CAPTCHA或规避平台安全审核的请求

否则接口会拒绝请求

🎯 关键提示

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。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "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
        }
    }
}

请避免生成以下类型内容：#

请求参数

请求示例代码

返回响应

请避免生成以下类型内容：