Roko API
控制台
上代旗艦 · 全檔解析度 · 高性價比 ● 可用

GPT Image 2 API

GPT Image 2 是 OpenAI 圖像系列的成熟主力，Roko API 以 1K $0.016、2K $0.024、4K $0.032 的檔位提供文生圖、圖生圖與多圖參考編輯，14 種寬高比覆蓋從豎屏短片到寬幅橫版的常見場景。

取得 API Key 查看完整 API 文件
公開模型 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每張輸出

費用怎麼算？

生成 1 張 1K 圖片1 × $0.016 = $0.016

社群與網頁配圖的標準成本，批次場景優勢明顯。

生成 1 張 4K 圖片1 × $0.032 = $0.032

印刷級輸出檔；失敗圖片不計入生成數量。

參數與支援範圍

以下欄位來自目前公開 generation_config。quality 目前僅公開 auto；表單之外的能力以實際請求驗證為準。

參數可用值說明
prompttextarea描述要產生的畫面，或說明要對參考圖做哪些修改。 · 必填
image_urlsurl / base64參考圖可使用 URL 或 Base64；編輯時說明要保持和改變的部分。 · 可選
sizeauto / 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 · 可選
qualityauto畫質檔位由模型設定決定（如 auto / low / medium / standard / hd），並可能直接影響價格。 · 預設: auto · 可選
resolution1K / 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 不額外添加可見浮水印，輸出以實際回傳為準。