GPT Image 2.6

使用 gpt-image-2.6-flare 或 gpt-image-2.6-sunburst。两个模型独立选择；参数格式相同。请在模型广场查看账户价格与可用性。

接口与认证

所有请求携带 Authorization: Bearer YOUR_API_KEY。

操作	端点	请求格式
文生图、参考图编辑	POST https://apimaster.ai/v1/images/generations	JSON，参考图使用 image_urls
异步生成或参考图编辑	POST https://apimaster.ai/v1/images/generations/async	相同 JSON；返回任务 ID
上传文件编辑	POST https://apimaster.ai/v1/images/edits	multipart，使用 image 或重复 image[]
异步文件编辑	POST https://apimaster.ai/v1/images/edits/async	相同 multipart
查询任务	GET https://apimaster.ai/v1/tasks/{task_id}?model=MODEL_ID	使用提交账号的有效密钥

同步请求等待结果后返回 data[].url。异步请求返回 data[0].task_id，再查询任务。客户端建议预留 600 秒，轮询间隔 3–5 秒。客户端超时不代表生成已取消；不要重复提交。首次提交携带 Idempotency-Key，响应丢失时按图片幂等与恢复指南查询原回执。

curl --fail-with-body --max-time 600 'https://apimaster.ai/v1/images/generations/async' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: unique-image-request-001' \
  -d '{"model":"gpt-image-2.6-flare","prompt":"一只橘猫坐在窗边，水彩风格","size":"1:1","resolution":"1k","quality":"medium","n":1}'

参数

字段	类型 / 默认值	说明
model	string，必填	gpt-image-2.6-flare / gpt-image-2.6-sunburst
prompt	string，必填	1–32,000 字符，包含编辑目标与参考图顺序
n	integer，1	1–4；GIF 表示动图数量。显式 0、负数、小数及大于 4 均拒绝
size	string，可省略	auto、下述比例或精确像素 WIDTHxHEIGHT；GIF 规则单列
resolution	string，1k	1k / 2k / 4k，使用小写；精确像素尺寸优先
quality	string，auto	low / medium / high / xhigh / max / auto
complexity	string，high	low / medium / high，控制规划强度，独立于渲染质量；局部小改动可选 low
output_format	string，png	png / jpeg / webp / gif / svg
output_compression	integer，可省略	0–100，仅 JPEG / WebP 支持
background	string，auto	transparent / opaque / auto；透明背景支持 PNG / WebP / SVG
moderation	string，low	low / auto
image_urls	string[]，可省略	最多 16 张参考图，HTTP(S) 图片直链或图片 Data URL，按数组顺序使用
mask_url	string，可省略	Alpha PNG 图片直链或 Data URL，尺寸等于第一张参考图；透明区域表示修改区域
markup_url	string，可省略	HTTPS PNG 直链或 data:image/png;base64,... 透明标注层，尺寸等于首张参考图
markup	string / object，可省略	markup_url 的替代写法：URL 字符串或 {"image_url":"..."}；不支持 file_id，不要同时传 markup_url
svg	object，SVG 必填	{"model":"gpt-5.4-mini"}；可选 reasoning.effort，详见下文
safety_identifier	string，可省略	最多 128 字符，使用稳定的匿名业务标识
frame_count	integer，9	仅 GIF，2–16
frame_duration_ms	integer，200	仅 GIF，至少 20 毫秒，按 10 毫秒向下取整

不要发送 stream、partial_images、input_fidelity、prompt_rewriter、response_format。svg 对象仅用于 SVG 输出。结果使用图片 URL；不支持流式图片与 Base64 响应格式。

静态图片尺寸

支持比例：1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21、3:1、1:3。

精确像素宽高必须为正的 16 倍数，单边不超过 3840，总像素 655,360–8,294,400，长短边比不超过 3:1。超过 2560×1440 的尺寸属于实验性范围。精确尺寸会覆盖 resolution；例如 1024x1024 配合 resolution=4k 仍为 1024×1024。

图像编辑省略 size 时，按第一张参考图比例与 resolution 选择尺寸；显式 auto 则自动选择。若需要可预测的画幅，请显式指定比例与分辨率。

参考图编辑、蒙版与标注

2.6 支持在 generations JSON 中直接使用 image_urls：

{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "将背景改为浅绿色，保留主体、文字与布局。",
  "image_urls": ["https://your-image-host.example/reference.png"],
  "mask_url": "https://your-image-host.example/mask.png",
  "resolution": "1k",
  "quality": "medium",
  "complexity": "low",
  "output_format": "png",
  "n": 1
}

移除 mask_url 可编辑整张图；蒙版不能保证区域外像素完全不变。蒙版和标注必须附带参考图，且不能同时使用。

标注引导使用 markup_url 或 markup，在透明 PNG 上以箭头、框选、笔画提示编辑意图。首图与标注层各自最多 16,777,216 像素，标注文件最多 50 MB；标注层需与首图宽高相同。链接必须可访问。

本地文件可通过 edits 上传；HTTP 客户端应自行生成 multipart boundary。每张上传文件最多 10 MB。按顺序重复 image[] 即可上传多张：

curl --fail-with-body --max-time 600 'https://apimaster.ai/v1/images/edits/async' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=gpt-image-2.6-flare' \
  -F 'prompt=按照标注将背景改为浅绿色，保留主体。' \
  -F 'image[]=@reference.png;type=image/png' \
  -F 'markup=@overlay.png;type=image/png' \
  -F 'resolution=1k' -F 'quality=medium' -F 'complexity=low' -F 'n=1'

也可将标注文件字段替换为 mask=@mask.png;type=image/png；不要同时上传两者。

GIF 动图

GIF 仅支持文生图，不支持参考图、蒙版、标注、透明背景或压缩参数。size 表示每帧像素尺寸，省略或 auto 为 512×512；不能传比例名。宽高仍需为正的 16 倍数。

帧会排入整张拼图：2–8 帧为 4×2，9 帧为 3×3，10–12 帧为 4×3，13–16 帧为 4×4，行列可以交换。整张拼图单边最多 3840、总像素最多 8,294,400、长短边比最多 3:1。512×512 支持 2–16 帧；768×768 最多 12 帧；1024×1024 即使 2 帧也超限。

{
  "model": "gpt-image-2.6-flare",
  "prompt": "A small orange cat waves its paw in a smooth loop, fixed camera.",
  "output_format": "gif",
  "size": "512x512",
  "frame_count": 9,
  "frame_duration_ms": 200,
  "quality": "low",
  "n": 1
}

GIF 按整张拼图对应的图片档位计费，而不是每帧单独计费；n 张动图按 n 张计算。

SVG 矢量图

设置 output_format: "svg"，并传入 svg.model: "gpt-5.4-mini"。两个 2.6 模型均支持此格式。返回静态 SVG 文件链接，可在日志中预览并下载源文件。

{
  "model": "gpt-image-2.6-flare",
  "prompt": "A minimalist bakery logo with a wheat stalk, flat colors, clean vector shapes",
  "output_format": "svg",
  "svg": {"model": "gpt-5.4-mini"},
  "size": "1:1",
  "resolution": "1k",
  "quality": "low",
  "n": 1
}

字段	说明
svg.model	必填；当前支持 gpt-5.4-mini
svg.reasoning.effort	可省略，推荐默认；格式允许 none / minimal / low / medium / high / xhigh / max，具体档位受转换模型支持范围约束

SVG 仅支持文生图，n 必须为 1，不接受参考图、蒙版、标注层、压缩参数或 GIF 帧参数。quality 与 complexity 控制生成过程中的参考图。支持静态矢量元素与本地定义引用；输出最多 8 MB，不支持脚本、交互动画、外部资源或嵌入位图。

SVG 沿用对应图片档位和质量配置计费，矢量转换的文本处理已包含在图片费用中，不另收文本费。首次提交仍建议携带 Idempotency-Key；获得任务 ID 后持续查询原任务。

查询结果、日志与费用

curl --fail-with-body 'https://apimaster.ai/v1/tasks/TASK_ID?model=gpt-image-2.6-flare' \
  -H 'Authorization: Bearer YOUR_API_KEY'

处理中继续轮询；succeeded / success / completed 表示完成，failed / error 表示失败。完成后从 data.result.images[].url 读取全部图片；兼容处理字符串或 URL 数组。同步结果从 data[].url 读取。请及时下载文件。

成功任务可在控制台调用日志中查看图片预览。两个 2.6 模型分别配置，基础价格沿用 GPT Image 2 的对应档位，按实际输出张数结算。精确像素尺寸与 GIF 拼图决定分辨率计价档位；auto 质量使用配置的 auto 档位。账户最终价格还受市场路由和账户倍率影响，以控制台价格与调用日志为准。失败任务应查看最终状态及退款记录；提交阶段的预扣不等于最终消费。

参数错误返回 400 时先修正请求。若已经获得任务 ID，持续查询原任务，不要重新生图；若未收到提交响应，先查询幂等回执。