Skip to content
AI Blog

GPT Image API 與 Platform 入門

最後更新：2026-09-09· 17 分鐘閱讀

🚀 快速通道

  • GPT Image 2 國內版：點擊直達↗
  • 文生圖工作台：開啟鏡像↗
  • 官方 ChatGPT：chatgpt.com ↗

GPT Image API 與 Platform 入門

更新時間：2026-08-21。端點、模型 ID、配額與價格以 Images 文件、API 參考 與 定價頁 當日內容為準；下文不寫死易過期單價、限流數字與請求欄位列舉。

導讀

「GPT Image API」「gpt-image-2 API」對應的是把圖像生成接到網站、設計流水線或內部工具。可上線的接入不只是「跑通一次生成」，還要管：金鑰不進前端、模型 ID 可設定、失敗可重試、用量可觀測、輸出可審核。 網頁 ChatGPT 適合探索；產品整合走 OpenAI Platform，並先在文件裡核對你要用的是 Images API 還是 Responses 裡的圖像能力。型號產品敘事見 GPT Image 2 指南 與 家族解析。

這篇解決什麼問題？

  • 分清 ChatGPT App 體驗與 Platform API 兩條路徑
  • 正確對待產品名（GPT Image 2／1.5 等）與文件中的模型 ID
  • 理解 Images API 與 Responses 圖像工具的分工，避免抄過期參數
  • 建立金鑰、日誌去識別與成本告警的最低安全基線
  • 上線前用檢查清單驗收，而不是只看一張樣圖

App ≠ Platform API

路徑適合做什麼不適合做什麼
ChatGPT App快速試構圖、對話改圖、人工驗收高併發生產、金鑰託管、穩定 SLA
OpenAI Platform伺服端自動化、產品功能、用量計量在瀏覽器暴露長期 Key
第三方網頁入口國內便捷試用（非官方）預設當作官方計費與合規等價物

國內使用者若先走第三方網頁入口，請記住：第三方 ≠ OpenAI 官方，帳號與帳單體系可能完全分離。存取路徑見 國內使用完全指南。

Images API 與 Responses 圖像工具：先選對入口

OpenAI 側常見兩類整合方式（名稱與能力邊界以文件當日為準）：

  1. Images API（圖像專用介面族）
    面向「文生圖／編輯／（部分型號的）變體」等圖像流水線。適合明確的出圖任務、佇列化作業、把提示與尺寸檔位寫進任務中繼資料。站內開發向說明見 Image Generation。

  2. Responses（或對話式介面）裡的圖像能力／工具
    適合「模型先推理再決定是否出圖」、多步工具呼叫、與文字回覆混排的產品形態。參數名、工具開關、輸出解析路徑可能與純 Images 呼叫不同。

不要從舊部落格或過期 SDK 範例裡抄死 size／quality／tool 欄位名當永久真理；發版前用官方文件與控制台「可用模型」清單核對。教學只固定工程原則：伺服端呼叫、可設定模型 ID、分類錯誤處理、輸出轉存與審核。

模型 ID：產品名與文件名不要混用

對外溝通可用 GPT Image 2、GPT Image 1.5 等產品稱呼；寫進程式碼時，以文件列出的 model id 為準。清單會更新，禁止把某一天的字串寫死在多處業務程式碼裡。

選型速記（細節見專題文）：

Images 2.5 API 雙檔（Flare／Sunburst）

2026-09 起，OpenAI 在 API 側將 2.5 拆為兩檔（產品網頁側多為 ChatGPT Images 2.5）：Flare 偏預設吞吐與延遲；Sunburst 偏精密多輪編輯、更慢。寫入設定時從文件複製完整 model id，並保留回退到 gpt-image-2 的開關。選型與工作流見 2.5 指南。

設定建議：模型名放環境變數或遠端設定，發版不必改程式碼。提示詞版本號與風格卡 ID 一併記錄，方法見 提示詞指南。

建議落地順序

  1. 在 ChatGPT 或文件範例環境用同一提示跑通目標型號，保存成功參數。
  2. 閱讀官方圖像文件：鑑權方式、回應裡如何取圖像（URL／base64 等）、安全過濾說明。
  3. 明確走 Images API 還是 Responses 圖像工具；在伺服端用官方 SDK 或 HTTPS 呼叫。
  4. 本機用環境變數注入 Key；為「生成成功／安全攔截／逾時／配額」分類打日誌（禁止記錄完整 Key）。
  5. 生成結果立即轉存自有物件儲存；暫時連結勿當永久 CDN。
  6. 加預算告警與每使用者速率限制，避免提示詞被刷爆帳單。
# 本機開發範例（名稱以你專案約定為準）
export OPENAI_API_KEY="your-secret-here"
export GPT_IMAGE_MODEL="/* 從文件複製當日 model id */"
$env:OPENAI_API_KEY = "your-secret-here"
$env:GPT_IMAGE_MODEL = "/* 從文件複製當日 model id */"

硬性規則： Key 只出現在伺服端金鑰系統；不要寫進前端套件、Git、截圖或共用試算表。外洩後立即在 API keys 輪換。

成本與品質可觀測

記錄每次呼叫的：模型 ID、解析度／品質檔位、是否帶參考圖、走的是 Images 還是 Responses 路徑、延遲、是否被安全策略攔截、人工是否採用。
這樣你才能回答「草稿檔節省了多少」「成稿通過率多少」，而不是憑感覺選型。

自動化流水線常見模式：低成本檔批次出候選 → 人工或規則初篩 → 主力型號精修 → 設計工具疊字與匯出。入門操作見 新手入門；風格分流見 風格與情境實戰。

價格與配額以 openai.com/api/pricing 與控制台當日資料為準，本教學不複製易過期數字。

完成檢查清單

  • 已確認使用的是文件中的當前模型 ID（可設定）
  • 已明確 Images API 與 Responses 圖像工具的選型，未抄過期欄位
  • API Key 僅存伺服端，倉庫無金鑰
  • 逾時、重試、錯誤分類已實作
  • 日誌無 Key、無未去識別使用者圖
  • 用量／預算告警已打開（若控制台提供）
  • 輸出有人工或自動審核閘門再對終端使用者展示
  • 生成圖已轉存自有儲存，並保留提示與參考圖授權紀錄

快速通道／存取入口

常見問題

網頁裡能選的模型，API 一定有嗎？

不一定同步。以 API 文件與控制台「可用模型」清單為準；不要假設 ChatGPT 按鈕名等於可呼叫 ID。

可以在瀏覽器直連 OpenAI API 出圖嗎？

不建議。瀏覽器無法安全持有長期 Key，且容易被盜刷。應透過自有後端代理。

Images API 和 Responses 出圖可以混用同一套參數嗎？

不要假設欄位一一對應。以你選定路徑的當日文件為準分別實作；共用的是提示詞版本與業務中繼資料，而不是抄同一份過期 JSON。

第三方國內站的「API」能當官方用嗎？

不能預設等價。協議、日誌、模型路由與合規責任都可能不同；正式產品整合優先官方 Platform 路徑，並單獨評估第三方條款。

價格和 RPM 限流寫在哪？

以 OpenAI 定價與配額頁面的當日資料為準；本教學不複製易過期數字。

官方資源

延伸閱讀

總結

GPT Image 的工程接入，關鍵是把探索（ChatGPT App）與生產（Platform 伺服端）分開：先選對 Images API 或 Responses 圖像路徑，模型 ID 可設定、金鑰不出前端、成本與攔截可觀測、輸出經審核再上線。先讀官方圖像文件核對當日型號與欄位，再把提示詞與風格卡版本化，流水線才能既快又可控。

相關內容