GPT Image 2 API
GPT Image 2 是 OpenAI 图像系列的成熟主力，Roko API 以 1K $0.016、2K $0.024、4K $0.032 的档位提供文生图、图生图与多图参考编辑，14 种宽高比覆盖从竖屏短视频到宽幅横版的常见场景。
- 公开模型 ID
gpt-image-2- 输出档位
1K / 2K / 4K（默认 1K）- 计费方式
按输出张数与分辨率- 生成接口
POST /v1/images/tasks- 目录快照
GPT Image 2 是什么？
GPT Image 2 是 OpenAI 图像系列的成熟主力模型，支持文生图、图生图与多图参考编辑，官方在 GPT Image 2.5 发布时将其作为对比基准：2.5 Flare 画质与它相当但延迟更低，2.5 Sunburst 画质高于它。对已经在用 GPT Image 2 且质量达标的工作流，官方也建议保留现方案。
Roko API 当前公开 1K、2K、4K 三档输出和 14 种宽高比（auto 到 21:9），1K 每张 $0.016、2K $0.024、4K $0.032，是 Roko 目录中单价最低的 GPT 图像档位之一。
调用走异步任务：POST /v1/images/tasks 提交后拿到 task_id，轮询 GET /v1/tasks/{task_id} 获取结果。表单中的 quality 字段当前仅公开 auto，可用参数以请求校验为准。
核心能力
全档分辨率
1K、2K、4K 三档输出，4K 每张 $0.032，同价位段中覆盖高分辨率需求。
14 种宽高比
从 9:21 竖屏到 21:9 宽幅、1:2 与 2:1 特殊比例，短视频与横版物料一次配齐。
多图参考编辑
传入参考图即进入图生图/编辑模式，支持多张参考图融合与局部修改。
成熟的性价比档
画质经过大规模生产验证，价格低于 2.5 系，适合预算敏感的批量场景。
GPT Image 2 API 价格
价格由当前 Roko 模型目录生成。结算按输出张数乘以所选分辨率单价；提交任务前请再次确认控制台估价。
| 分辨率 | 价格 | 计费单位 |
|---|---|---|
| 1k | $0.016 | 每张输出 |
| 2k | $0.024 | 每张输出 |
| 4k | $0.032 | 每张输出 |
费用怎么算？
社媒与网页配图的标准成本，批量场景优势明显。
印刷级输出档；失败图片不计入生成数量。
参数与支持范围
以下字段来自当前公开 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 · 可选 |
quality | auto | 画质档位由模型配置决定（如 auto / low / medium / standard / hd），并可能直接影响价格。 · 默认: auto · 可选 |
resolution | 1K / 2K / 4K | 选择当前模型配置的输出分辨率档位；该值可能直接影响价格。 · 默认: 1K · 可选 |
用 Roko API 调用 GPT Image 2
走异步任务流程：提交任务拿到 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",
"prompt": "Minimal flat-illustration banner of a reading nook, warm palette, clean vector shapes",
"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 的重放会返回原任务而不重复计费。
适合哪些场景？
社媒与内容配图
14 种宽高比直接覆盖竖屏、方图与横版，一次提示词多比例出图。
Cozy autumn reading corner, flat illustration, warm oranges and creams, 9:16 for stories.
产品视觉与电商素材
图生图编辑保持产品特征，适合快速出商品场景图。
Place the reference skincare bottle on a sunlit bathroom counter, soft shadows, editorial style.
批量原型与 A/B 测试
1K 每张 $0.016 的成本适合大批量风格探索与素材筛选。
Four variations of a fitness app onboarding illustration, same style guide, different poses.
4K 展示与印刷物料
需要更高分辨率时直接升 4K，无需外挂放大工具。
Conference booth key visual at 4K: abstract gradient waves, brand blue and white, generous negative space.
使用前要知道的限制
- quality 字段当前仅公开 auto，其余取值以请求校验为准。
- 它是上一代模型：追求更低延迟选 2.5 Flare，追求更高质量选 2.5 Sunburst。
- 异步任务提交成功不等于生成成功，以任务查询结果为准。
- 生成结果仍可能出现文字、手部或细节偏差，正式发布前应人工复核；输出权利取决于输入素材与适用条款。
GPT Image 2 与 2.5 系怎么选？
已验证质量达标就留在 GPT Image 2（1K 每张 $0.016）；要更快选 2.5 Flare（延迟降 50%），要更高质量选 2.5 Sunburst。三者表单几乎一致，切换成本低。
全部模型 →GPT Image 2 常见问题
GPT Image 2 API 的模型 ID 是什么？
Roko API 当前公开模型 ID 是 gpt-image-2。请原样传入 model 字段。
GPT Image 2 API 多少钱？
当前目录价格为 1K 每张 $0.016、2K 每张 $0.024、4K 每张 $0.032。价格可能调整，请以任务提交时的控制台估价和最终结算记录为准。
GPT Image 2 和 GPT Image 2.5 有什么区别？
官方定位上，2.5 Flare 画质与 GPT Image 2 相当但延迟低约 50%，2.5 Sunburst 画质更高。如果 GPT Image 2 的质量已满足需求，官方建议可继续使用并比较切换后的延迟与质量。
支持哪些宽高比？
14 种：auto、1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9、9:21、1:2、2:1，默认 auto。
支持图像编辑吗？
支持。传入参考图（image_urls，URL 或 Base64）即进入图生图/编辑模式，可做局部修改与多图融合。
通过哪个接口调用？
通过 POST /v1/images/tasks 提交异步任务并拿到 task_id，再用 GET /v1/tasks/{task_id} 轮询结果或失败原因。
4K 输出值得加钱吗？
1K 到 4K 每张差 $0.016。网页与社媒场景 1K/2K 通常够用；印刷、大幅展示或需要后期裁切的素材建议 4K。
Roko 上的 GPT Image 2 有官方水印吗？
OpenAI 为其图像产品使用 C2PA 元数据与隐形水印等溯源手段；Roko 不额外添加可见水印，输出以实际返回为准。