GPT Image 2.5 Sunburst API
GPT Image 2.5 Sunburst 是 OpenAI 官方面向 API 推出的质量优先 base model：画质高于 GPT Image 2，适合品牌素材、产品成稿与多轮精修。Roko API 当前开放文生图、参考图编辑以及 1K $0.02、2K $0.03、4K $0.04 三档价格。
- 公开模型 ID
gpt-image-2.5-sunburst- 输出档位
1K / 2K / 4K（默认 1K）- 计费方式
按输出张数与分辨率- 生成接口
POST /v1/images/tasks- 目录快照
GPT Image 2.5 Sunburst 是什么？
GPT Image 2.5 Sunburst 是 OpenAI 在 ChatGPT Images 2.5 发布中推出的两款 API 图像模型之一，官方定位是“base model、质量优先”：画质高于 GPT Image 2，面向可直接投放的广告创意与精致的产品图像等需要跨多次编辑保持精准控制的视觉工作流。早期客户评价它“清楚哪些部分不该改”——在保持角色、构图与视觉识别特征的同时完成有效编辑。
OpenAI 上游为 Sunburst 提供图像生成、编辑和透明背景能力；Roko 当前公开表单提供生成与参考图编辑，但尚未开放 background 或 output_format 控件，因此本页不承诺透明通道输出。
Roko API 当前公开 1K、2K、4K 三档输出和 14 个画幅选项（含 auto），1K 每张 $0.02、2K $0.03、4K $0.04。调用走异步任务，提交后轮询任务结果。
核心能力
官方质量档
画质高于 GPT Image 2 的 base model，为要求苛刻的视觉工作流提供更精细的控制。
精准编辑与主体保持
官方与早期客户强调“知道什么不该改”：改对地方，同时保住角色、构图与视觉识别。
上游透明背景能力
OpenAI 官方支持透明背景；Roko 当前表单未开放对应控件，实际可用参数以请求校验为准。
品牌级成稿
高质量输出加 $0.02 起的单价，适合品牌素材、产品主图与广告物料成稿。
GPT Image 2.5 Sunburst API 价格
价格由当前 Roko 模型目录生成。结算按输出张数乘以所选分辨率单价；提交任务前请再次确认控制台估价。
| 分辨率 | 价格 | 计费单位 |
|---|---|---|
| 1k | $0.02 | 每张输出 |
| 2k | $0.03 | 每张输出 |
| 4k | $0.04 | 每张输出 |
费用怎么算？
用于品牌审稿与精细构图的入门成本。
品牌与产品素材批量成稿的典型开销；失败图片不计入生成数量。
参数与支持范围
以下字段来自当前公开 generation_config。quality 当前仅公开 auto；表单之外的能力以实际请求校验为准。
| 参数 | 可用值 | 说明 |
|---|---|---|
prompt | textarea | 描述要生成的画面，或说明要对参考图做哪些修改。 · 必填 |
image_urls | url / base64 | 参考图可使用 URL 或 Base64；编辑时说明要保持和改变的部分。 · 可选 |
size | auto / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 5:4 / 4:5 / 21:9 / 9:21 / 2:1 / 1:2 / 1:3 / 3:1 | 按模型配置选择宽高比、分辨率档位或明确的像素尺寸。 · 默认: auto · 可选 |
resolution | 1K / 2K / 4K | 选择当前模型配置的输出分辨率档位；该值可能直接影响价格。 · 默认: 1K · 可选 |
quality | auto | 画质档位由模型配置决定（如 auto / low / medium / standard / hd），并可能直接影响价格。 · 默认: auto · 可选 |
用 Roko API 调用 GPT Image 2.5 Sunburst
走异步任务流程：提交任务拿到 task_id，再轮询查询结果。不要在前端代码中暴露 API Key。
发起图片生成
curl https://api.rokoapi.com/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
-d '{
"model": "gpt-image-2.5-sunburst",
"prompt": "Premium skincare bottle campaign image, restrained typography, accurate label text, soft studio light, preserve the brand mark",
"size": "16:9",
"resolution": "2K",
"quality": "auto"
}'查询恢复任务
curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
-H "Authorization: Bearer $API_KEY"POST /v1/images/tasks 返回 202 与 task_id，生成完成后通过 GET /v1/tasks/{task_id} 查询结果或失败原因。Idempotency-Key 需唯一；相同 Key 的重放会返回原任务而不重复计费。
适合哪些场景？
品牌广告成稿
质量优先，适合需要准确文字、品牌标识与精致构图的投放素材。
Luxury watch campaign key visual, preserve the exact logo and dial details, dramatic controlled lighting.
产品图精修
按参考图编辑并明确保留项，适合产品主图和包装细节迭代。
Replace only the background with warm travertine, keep the bottle, label, cap, and shadows unchanged.
多轮局部修改
Sunburst 强调跨多次编辑保持主体、构图与视觉识别的一致性。
Keep the character and layout unchanged; revise only the headline to “Autumn Collection”.
高要求营销素材
$0.02 起的 1K 单价可用于先审稿、再按需升级 2K 或 4K 的成稿流程。
Polished launch poster for a premium speaker, clean grid, realistic materials, precise headline placement.
使用前要知道的限制
- 它是 OpenAI 为品牌成稿与多轮精修场景准备的官方模型。
- quality 字段当前仅公开 auto；表单之外的能力以请求校验为准。
- 异步任务提交成功不等于生成成功，以任务查询结果为准。
- OpenAI 对其图像产品使用 C2PA 元数据与隐形水印等溯源手段；输出权利取决于输入素材与适用条款。
Flare、Sunburst 与 GPT Image 2 怎么选？
追求极致画质与多次编辑一致性选 Sunburst；日常与大批量选 Flare（更快更省）；已验证达标的存量工作流可留在 GPT Image 2（1K $0.016 更便宜）。
全部模型 →GPT Image 2.5 Sunburst 常见问题
GPT Image 2.5 Sunburst API 的模型 ID 是什么？
Roko API 当前公开模型 ID 是 gpt-image-2.5-sunburst。请原样传入 model 字段。
GPT Image 2.5 Sunburst API 多少钱？
当前目录价格为 1K 每张 $0.02、2K 每张 $0.03、4K 每张 $0.04。价格可能调整，请以任务提交时的控制台估价和最终结算记录为准。
Flare 和 Sunburst 有什么区别？
官方定位：Sunburst 是 base model、质量优先，画质高于 GPT Image 2；Flare 是 small model、速度优先，画质与 GPT Image 2 相当。两者都支持生成、编辑与透明背景，能力面一致，差别在速度与精度的取舍。
什么时候应该选择 Sunburst？
当 GPT Image 2 或 Flare 无法满足画质、精确编辑或多轮一致性要求时选择 Sunburst。若 Flare 已达到质量门槛，通常优先保留更快的 Flare，并用同一组提示词做实测。
支持透明背景吗？
OpenAI 上游支持，但 Roko 当前公开表单没有 background 或 output_format 字段，因此本页不承诺透明通道输出；请以实际请求校验和响应为准。
支持哪些宽高比？
当前表单有 14 个可选值：auto、1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9、9:21、2:1、1:2；默认 auto，以请求校验为准。
通过哪个接口调用？
通过 POST /v1/images/tasks 提交异步任务并拿到 task_id，再用 GET /v1/tasks/{task_id} 轮询结果或失败原因。
从 GPT Image 2 迁移到 Sunburst 要改什么？
把 model 字段换成 gpt-image-2.5-sunburst 即可，Roko 当前表单结构基本一致。请用相同提示词与参考图比较质量；只有 Sunburst 的画质或编辑稳定性确有优势时再切换。