OpenAI 最新的图像模型,两档:gpt-image-2.5-flare(默认档,延迟约为 GPT Image 2 的一半)与 gpt-image-2.5-sunburst(最高精度)。OpenAI SDK / Codex / Cursor 改一行 base_url 即可直连;文生图 + 参考图编辑 + 原生透明底 PNG,1K/2K/4K 按张计费,同步返回免轮询。
所有请求在 Header 携带 API Key:
Authorization: Bearer YOUR_API_KEY| 分辨率 | low | medium | high | xhigh | max |
|---|---|---|---|---|---|
| 1K | $0.008 | $0.020 | $0.03 | $0.05 | $0.08 |
| 2K | $0.020 | $0.025 | $0.04 | $0.08 | $0.15 |
| 4K · flare | $0.020 | $0.045 | $0.08 | $0.17 | $0.30 |
| 4K · sunburst | $0.020 | $0.085 | $0.16 | $0.28 | $0.47 |
quality 支持 low / medium / high / xhigh / max 五档,**逐档不同价** —— 只为你要的细节付钱:验版式用 1K low 一张 $0.008,要拿去印刷再上 max。1K 档位为 $0.008 / $0.020 / $0.03 / $0.05 / $0.08(对应 low → max),2K 与 4K 见上表。gpt-image-2.5-flare 是默认档(延迟约为 GPT Image 2 的一半,适合社媒 / 电商 / 走量),不传 quality 按 **medium** 计价出图;gpt-image-2.5-sunburst 面向精品商业图像,不传 quality 按 **high** 计价出图 —— 不想按 high 付费就显式传 quality。1K 与 2K 下同一画质档两个模型同价,在这两档分辨率里你选的是速度不是价格;4K 分开定价,sunburst 为 $0.020 / $0.085 / $0.16 / $0.28 / $0.47(low → max),flare 维持 $0.020 / $0.045 / $0.08 / $0.17 / $0.30。分辨率档位按实际出图的总像素量判定(≤1.7MP 记 1K、1.7–4.6MP 记 2K、>4.6MP 记 4K),既不看最长边也不看请求参数 —— 例如 2K 的 2720x1536 是 4.18MP,虽然长边超过 2048,仍按 2K 计费;size 传 auto 或不传时以实际输出为准,要固定档位就显式传 size。参考图、透明底不额外收费;失败不扣费。gpt-image-2.5 是 flare 的别名。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 计费档 | 典型 size | 判定规则 | |
| 1K | 1024x1024 / 1360x768 / 768x1360 | 像素量 ≤ 1.7MP | |
| 2K | 2048x2048 / 2720x1536 / 1536x2720 | 像素量 1.7-4.6MP | |
| 4K | 3840x2160 / 2160x3840 | 像素量 > 4.6MP |
2K 与 4K 按请求 size 精确交付,不做任何吸附:2K 为 2720x1536 / 1536x2720(4.18MP),4K 为 3840x2160 / 2160x3840(8.29MP),横竖两个方向 2026-09-22 共 16 发实测全部原样返回。1K 的 1:1 同样精确(1024² 实测原样返回);1K 的 16:9 / 9:16(请求 1360x768 / 768x1360)实测返回 1360x768 或 1672x941 两种 —— 同一渠道的两种输出,比例不变,都按 1K 计费。也可以不传 size,改传 aspect_ratio + resolution(1K/2K/4K),由服务端算出尺寸。
/api/v1/images/generations·POST/api/v1/images/edits传 OpenAI 风格的 WxH size 即触发同步模式:请求直接返回图片(b64_json + url),与 OpenAI 官方 images.generate() / images.edit() 契约一致。同步等待与超时规则与 GPT Image 2 All 相同(280 秒上限,95 秒后保活;超过 95 秒才失败的请求响应体带 error 字段)。
# Text-to-image — OpenAI Images API shape, SYNC response (no task polling)
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-flare",
"prompt": "a ceramic teapot, product shot, studio light",
"size": "1024x1024",
"background": "transparent",
"output_format": "png",
"n": 1
}'
# → { "created": ..., "data": [{ "b64_json": "...", "url": "https://r2.apimodels.app/..." }] }
# Image edit — multipart, OpenAI images.edit() shape. No mask field: name the
# object to change in the prompt and say the rest stays (see Notes below).
curl -X POST https://api.apimodels.app/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=gpt-image-2.5-sunburst" \
-F "image=@product.png" \
-F "prompt=change the red label to a green label, keep everything else exactly the same" \
-F "size=2048x2048"不传 WxH size(或需要 callback_url)时走平台统一异步契约:创建返回 taskId,轮询到 completed 取结果,支持 webhook 回调。
# Native async contract — pass aspect_ratio + resolution tier instead of size.
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-flare",
"prompt": "a lighthouse on a cliff at dusk",
"aspect_ratio": "9:16",
"resolution": "2K",
"callback_url": "https://your-domain.com/webhook"
}'
# → { "code": 200, "data": { "taskId": "..." } }
curl "https://api.apimodels.app/v1/images/generations?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 字段 | 类型 | 说明 | |
| model | string | gpt-image-2.5-flare / gpt-image-2.5-sunburst(gpt-image-2.5 = flare) | |
| prompt | string | 提示词(必填)。局部编辑请在提示词里点名要改的对象,并写明其余保持不变。 | |
| size | string | WxH,触发同步模式;见上方尺寸表 | |
| aspect_ratio + resolution | string | 异步模式下代替 size:比例 + 1K/2K/4K 档 | |
| image / image_base64 / image_url | string | 参考图 → 自动走编辑端点 | |
| image_urls / images | string[] | 多图参考,最多 16 张 | |
| background | string | transparent / opaque / auto。transparent 返回真带 alpha 的 PNG,1K / 2K / 4K 都可(实测产品图 52-67% 像素透明)。 | |
| output_format | string | png / jpeg / webp(可选)。透明底请传 png;不传时不透明图交付 JPEG q95、带 alpha 的图保持 PNG。 | |
| quality | string | low / medium / high / xhigh / max / auto。auto 或不传 = 各模型缺省档(flare medium、sunburst high),按该格计费。 | |
| response_format | string | b64_json(默认)或 url | |
| stream | boolean | 同步模式下改用 SSE 流式返回 | |
| n | number | 生成数量(计费 × n) |
七个价格格各出一张,2026-09-19 通过 apimodels.app 的接口实跑:提示词原文、请求尺寸、实得尺寸与当次耗时都是那一发的真实值,点图看全尺寸原图;**价目按 2026-09-22 降价后的现价标注**,不是当时的扣费。其中 2K 的两张与 sunburst 4K 那张出自 2026-09-22 换回渠道之前 —— 当时那条渠道会把尺寸吸附到自家网格,所以它们的实得尺寸小于请求值。同样的请求现在交付 2720x1536 / 1536x2720 与 3840x2160,这三张待重拍。
试一试:Playground
Flare 是默认档:2.5 的完整画质、延迟约为 GPT Image 2 的一半,不指定 quality 时按 medium 出图。Sunburst 是最高精度档,面向精品商业图像,缺省按 high 出图。两档参数完全相同。1K、2K 共用同一张价表,这两档分辨率下价格上的区别只是缺省落在哪一格;4K 则 Sunburst 更贵(low → max 为 $0.02 / $0.085 / $0.16 / $0.28 / $0.47,Flare 为 $0.02 / $0.045 / $0.08 / $0.17 / $0.3)。
透明底支持,1K / 2K / 4K 都可以:background=transparent 返回真带 alpha 的 PNG(实测产品图 52-67% 像素透明)。蒙版不支持:/v1/images/edits 收到 mask 会返回 400。蒙版只有当成硬边界才有意义,而我们测过的上游渠道没有一家守这条线 —— 保护区照样被重画 —— 所以我们选择明确拒绝,而不是收下再悄悄忽略。改用提示词点名要改的对象(「把红色圆形改成蓝色,其它一切保持不变」),改动就会局限在该处。
按张、按「分辨率 × 画质」两维计价,每个模型十五格。1K $0.008 / $0.020 / $0.03 / $0.05 / $0.08 与 2K $0.020 / $0.025 / $0.04 / $0.08 / $0.15 两个模型相同;4K 分开:Flare $0.02 / $0.045 / $0.08 / $0.17 / $0.3,Sunburst $0.02 / $0.085 / $0.16 / $0.28 / $0.47(low → max)。只为你要的细节付钱。分辨率档位按实际出图的总像素量判定(≤1.7MP 记 1K、1.7–4.6MP 记 2K、>4.6MP 记 4K),既不看最长边也不看请求参数 —— 例如 2K 的 2720x1536 是 4.18MP,虽然长边超过 2048,仍按 2K 计费。quality=auto 或不传按各模型缺省画质计价出图(Flare medium、Sunburst high)—— 不想按 high 付费就显式传 quality。参考图、透明底不额外收费;失败不扣费。
看你用哪一档。OpenAI 对 2.5 按输出 token 计费(每百万图片 token $30),画质越高越贵 —— 同一张 4K 图 low 档官方约 $0.011、max 档约 $0.40。我们同样按画质分档,所以每一格都能直接比:2K high 官方约 $0.107、我们 $0.04;Flare 的 4K high 官方约 $0.100、我们 $0.08,4K max 官方约 $0.40、我们 $0.3。1K / 2K 的 high 和 Flare 的 4K 高画质档都是我们更低;low 档官方更便宜(1K low 官方约 $0.006、我们 $0.008),Sunburst 的 4K 单独定价,也高于官方挂牌折算价(high $0.16、max $0.47)。另外无需组织认证、一把 key 通用、国内可直连。