图像编辑（统一接口 · 表单上传 / JSON 双模式）

图像编辑 · 统一接口

通过 /v1/images/edits 端点，上传源图片并配合提示词进行元素修改、风格重绘或多图融合。
支持 Multipart 表单上传 与 JSON Payload 两种提交模式，所有模型参数透传兼容。

🔗 接口参考文档：https://platform.openai.com/docs/api-reference/images/edits

📊 编辑接口支持的模型

gpt-image-2.5-sunburst（推荐精细编辑）— 编辑精准度最强，严格限制仅修改指定区域，主体保持度极高。支持 quality 全档位含 xhigh/max，最高分辨率 3840×2160，支持 safety_identifier。

gpt-image-2.5-flare（推荐快速编辑）— 高质量快速编辑，速度快约 50%。参数支持与 Sunburst 一致。

gpt-image-2 — 上代编辑模型，quality 支持到 high，不支持 safety_identifier。

-c 后缀为逆向版本，请求参数与原版完全一致，只需替换 model 值。

📤 模式一：Multipart 表单上传（适合本地文件调试）

Content-Type: multipart/form-data

model (text，必填)
模型名称：gpt-image-2.5-sunburst、gpt-image-2.5-flare、gpt-image-2

image / image[] (file，必填)
源图片文件。支持 PNG / WebP / JPEG（单张不超过 50MB）。可多次添加 image[] 字段传入多张参考图进行融合。

prompt (text，必填)
修改指令与提示词，最高 32,000 字符。清晰描述需要改动或保留的内容。

mask (file，可选)
遮罩图片文件，全透明区域为允许被编辑重绘的区域，尺寸须与源图一致。

quality (text，可选)
画质细节档位，默认 auto。

2.5 系列（含 -c）：auto、low、medium、high、xhigh、max

gpt-image-2 / 2-c：auto、low、medium、high

background (text，可选)
背景模式：transparent（透明）、opaque（不透明）、auto（默认）。

output_format (text，可选)
输出格式：png、webp、jpeg。

output_compression (text，可选)
压缩等级 0~100，仅 webp / jpeg 格式生效。

moderation (text，可选)
审核严格度：auto（标准）、low（宽松）。

n (text，可选)
生成数量，范围 1~10，默认 1。

size (text，可选)
输出分辨率，如 1024x1024。2.5 系列最高支持 3840x2160。

safety_identifier (text，可选)
安全追踪标识，传入用户哈希值。仅 2.5 系列（含 -c）支持。

📤 模式二：JSON Payload（适合云端 API 链路调用）

Content-Type: application/json

model (string，必填)
模型名称，可选值同上。

prompt (string，必填)
修改要求或融合提示词，最高 32,000 字符。

images (array，必填)
图片对象列表，每项支持传入公网 image_url 或 Base64 Data URL（如 data:image/png;base64,...）。

mask (object，可选)
遮罩图，格式同 images 中的单项。

quality (string，可选)
画质档位，默认 auto。档位差异同表单模式说明。

background (string，可选)
背景模式：auto（默认）、opaque、transparent。

output_format (string，可选)
输出格式：png、webp、jpeg。

output_compression (integer，可选)
压缩等级 0~100，仅 webp / jpeg 格式生效。

moderation (string，可选)
审核严格度：auto、low。

n (integer，可选)
生成数量，范围 1~10，默认 1。

size (string，可选)
输出分辨率。2.5 系列最高支持 3840x2160。

safety_identifier (string，可选)
安全追踪标识。仅 2.5 系列（含 -c）支持。

response_format (string，可选)
返回格式：b64_json（推荐）或 url。

🔍 两种模式如何选择？

Postman / 本地调试，需选择本地图片文件 → 表单上传模式

后端微服务 / Serverless / 已有图片 URL → JSON Payload 模式

✍️ 实用提示：

gpt-image-2.5-sunburst 在编辑场景下精准度最强，严格限制仅修改用户指定的区域，主体保持度极高

文本描述与参考图特征越匹配，融图与修图效果越自然

-c 后缀版本参数完全一致，替换 model 值即可切换

未来新模型支持 edits 端点时，只需更换 model 值，参数同样透传兼容

模型与官方文档

示例模型：gpt-image-2.5-sunburst

本站在架模型（图像）：gpt-image-2.5-sunburst、gpt-image-2、gpt-image-1、gpt-image-2.5-flare、gpt-image-1.5

厂商官网：OpenAI 模型文档

说明：模型名称需与【模型广场】完全一致；不同令牌分组可用的模型不同，以控制台展示为准。

请求参数

Header 参数

Body 参数application/json

示例

{
  "model": "gpt-image-2.6-flare",
  "prompt": "Turn this cat into a blue cartoon dragon, keep the pose",
  "images": [
    { "image_url": "https://example.com/photo1.jpg" },
    { "image_url": "data:image/png;base64,iVBORw0KGgoAAA..." }
  ],
  "mask": { "image_url": "data:image/png;base64,iVBORw0KGgoAAA..." },
  "background": "auto",
  "quality": "high",
  "size": "1024x1024",
  "n": 1,
  "output_format": "png",
  "output_compression": 80,
  "moderation": "auto",
  "safety_identifier": "user-12345",
  "response_format": "b64_json"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "created": 0,
    "background": "string",
    "data": [
        {
            "b64_json": "string",
            "generation_id": "string"
        }
    ],
    "output_format": "string",
    "quality": "string",
    "safety_identifier": "string",
    "size": "string",
    "usage": {
        "input_tokens": 0,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 0
        },
        "output_tokens": 0,
        "output_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 0
        },
        "total_tokens": 0
    }
}

图像编辑（统一接口 · 表单上传 / JSON 双模式）