图像编辑（统一接口 · 表单上传 / 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-sunburst-c — Sunburst 逆向版，参数一致，编辑质量接近但略有下降。

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

gpt-image-2.5-flare-c — Flare 逆向版，参数一致，编辑质量接近但略有下降。

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

gpt-image-2-c — Image-2 逆向版，参数一致，编辑质量接近但略有下降。

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

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

Content-Type: multipart/form-data

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

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-sunburst-c、gpt-image-2.5-flare、gpt-image-2.5-flare-c、gpt-image-1.5、gpt-image-2-c

厂商官网：OpenAI 模型文档

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

curl --location 'https://4sapi.com/v1/images/edits' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer sk-' \ --header 'Content-Type: application/json' \ --data '{ "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" }'

{ "created": 1762427218, "background": "auto", "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAABQAAAALQAQAAAADmbXm2AAAgAElEQVR4nOyd...", "generation_id": "gen-xxxx-xxxx-xxxx" } ], "output_format": "png", "quality": "high", "safety_identifier": "user-12345", "size": "1024x1024", "usage": { "input_tokens": 1573, "input_tokens_details": { "image_tokens": 1521, "text_tokens": 52 }, "output_tokens": 962, "output_tokens_details": { "image_tokens": 962, "text_tokens": 0 }, "total_tokens": 2535 } }

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