Skip to main content
POST
本页适用于 GPT Image 2.6。使用 2.5 请查看 GPT Image 2.5 API。 通过 POST https://code.heihuzi.ai/v1/images/edits 上传参考图并描述修改要求。验证日期:2026-11-07。请使用具有 GPT Image 2.6 权限的 API Key,并设置环境变量 HEIHUZI_API_KEY。

输入方式

下载参考图 reference.png到运行目录后,可以直接运行下面的示例。
响应保存为 edits-multipart.json,其中 data[].b64_json 是输出图片。

请求参数

参数名、取值和返回结构与 OpenAI 官方 POST /v1/images/edits 一致。下面只列编辑接口实际调用过的取值,具体组合见已验证的参数组合。
string
required
填写 gpt-image-2.6-flare 或 gpt-image-2.6-sunburst。省略时本站使用 gpt-image-2.5-flare,和官方默认的 gpt-image-2.5-sunburst 不同,要用 2.6 请明确填写。
string
required
描述要怎样修改参考图。
object[]
JSON 参考图数组,已验证一张和两张参考图。multipart 改用 image 文件字段,多张时重复上传 image[]。官方的 images[].file_id 本站不支持,实测返回 400,请改用 image_url。
string
已验证 transparent:配 png 得到透明背景的 PNG。实际背景以响应里的 background 为准。
string
出图前构思的程度,已验证 low、medium、high,输出用量不变。
integer
GIF 的帧数,只用于 output_format: "gif"。已验证 2、4、9、12、16,不填时为 9 帧。
integer
GIF 每帧时长,单位毫秒。已验证 20、100、200、500、2000,不填时为 200。
string
内容审核档位,已验证 low、auto。
integer
default:"1"
返回图片张数,已验证 1、2、10。一次出多张时,参考图的输入用量按张数重复计算:一张 1024×1024 参考图出 10 张,计 10240 个图片输入用量。
integer
已验证 jpeg 填 50。
string
已验证 png、jpeg、webp、gif。GIF 两款型号、multipart 和 JSON 两种写法都验证过,见下方参考图生成 GIF。
integer
流式返回时的预览张数。已验证 1、2:填 2 收到 2 张预览,填 1 没有收到预览。请求 webp 时预览图仍是 PNG,完成图是 WebP。
string
已验证 low、medium、high、xhigh、max、auto。auto 本次实际落在 medium,以响应里的 quality 为准。
string
用于标识你这边的终端用户,响应里会原样返回。同时填写已弃用的 user 时,响应以 safety_identifier 为准。
string
已验证 1024x1024、1536x1024、1024x1536、2048x2048、2880x2880、auto(本次返回 1374x1145)。GIF 不填和填 512x512 都输出 512×512,填 1024x1024 返回 400。
boolean
default:"false"
设置 true 后返回 SSE。Flare、Sunburst,multipart 和 JSON 请求都验证过。完成事件是 image_edit.completed;填了 partial_images 时,之前可能先收到 image_edit.partial_image 预览事件。请以完成事件作为成功依据。

已验证的参数组合

以下每行都在正式环境实际调用,返回 200 并核对了图片文件。 跨行叠加参数会形成新的组合,请先在自己的业务里验证再使用。参数不合法时返回的 400 结构见图像生成的错误返回。

JSON 编辑并保存图片

这段完整代码已真实执行,把蓝色杯子改成红色并保存为 edited-1.png。

参考图生成 GIF

这段完整代码已真实执行,让参考图里的杯子上下跳动,保存为 512×512、9 帧的 cup-bounce.gif。

真实响应节选

下面是页首示例的一次真实响应,图片 base64 已省略。
参考图会计入输入用量:这张 1024×1024 参考图计 1024 个图片输入用量。