gpt-image-2 API — 文字與參考圖共用一個 REST 呼叫
用 Bearer token 呼叫 gpt-image-2 API，約 45 秒內取得託管 PNG。文生圖與圖生圖共用同一個端點。每張圖 2 credits，不綁方案，不用裝 SDK。咖啡還沒送上桌，你就能建好 key 並 curl 出第一張成品。
已有 10,000+ 位開發者用 gpt-image-2 API 出貨
gpt-image-2 API 是什麼？
一個端點、Bearer 驗證、託管輸出。沒有多餘的接線工作。
gpt-image-2 API 是一個 REST 介面，把一段 prompt（以及最多四張參考圖）轉成可上線的 PNG。你用 Bearer token 對 /api/v1/images/generate 發 POST，拿到一組 task_id，再輪詢 /api/v1/images/task/[id] 直到圖片生成完成。每個回應都是 JSON — 2xx 成功時回標準 envelope，4xx 與 5xx 錯誤時附上穩定錯誤碼與 request_id。每張算圖成品都存放在我們的 R2 CDN，透過 HTTPS 提供服務，你可以直接 hotlink URL 或鏡像到自己的 bucket。Credits 會在提交當下以原子操作扣除，任務失敗時自動退還，帳務永遠對得上你實際產出的內容。整個介面以使用者為範圍：API key 會繼承所屬帳號的 credit 餘額，只看得到經程式呼叫建立的任務，看不到網頁 studio 建立的任務。所有送出的資料都是 JSON — 沒有 multipart 上傳、沒有 SDK 綁定、沒有隱藏重試。
單一 REST 端點
POST /api/v1/images/generate 在 gpt-image-2 API 同時處理文生圖與圖生圖。加上參考圖會自動切換模式，其餘 request body 保持一模一樣。
Explore
僅支援 Bearer 驗證
以 Authorization: Bearer YOUR_API_KEY 驗證。gpt-image-2 API 拒絕 query string 傳入的 key，確保你的 token 不會外洩到 CDN 或 proxy 紀錄。
Explore
託管 PNG 輸出
每個完成的 gpt-image-2 API 任務都會回傳一組穩定的 https://file.gptimg.co URL。沒有 signed-URL 過期問題、不需要下載再轉存、沒有臨時連結。
Explore
13 種 aspect ratio
gpt-image-2 API 涵蓋正方形、直幅、橫幅、寬螢幕與超寬螢幕。挑選你平台需要的比例直接出貨，不必生成後再做 letterbox 裁切。
Explore
原子化 credit 退款
若 gpt-image-2 API 回傳任務失敗，系統會自動退還扣除的 credits。你不必額外寫對帳腳本。
Explore
請求關聯 ID
每個 gpt-image-2 API 回應（無論成功或錯誤）都帶有 X-Request-Id header，body 內也有對應的 request_id。客服工單從幾天變成幾分鐘解決。
Explore
產品團隊的 gpt-image-2 API
一個 prompt 端點、無需架設基礎設施、帳務清楚可交代
不必佈建 GPU pod 或談判廠商合約，就能上線新的圖像功能。gpt-image-2 API 採每張固定費率 — 1:1 圖片 2 credits，批次大小呈線性成長。把 client 放進後端，用一個 HTTP 呼叫接通，將功能藏在 flag 後面，讓實際使用量幫你驗證定價。團隊從想法到 staging，通常一個下午內就能跑完。
影像編輯流程中的 gpt-image-2 API
圖生圖最多吃四張參考圖，全部走同一個端點
在 reference_images 傳入 1–4 個 https URL，gpt-image-2 API 會自動切換為圖生圖模式。常見用途包括風格轉換、重新上色、商品置換，以及保留人物身份的編輯。沒有獨立的 edit 端點、沒有 multipart form、沒有 base64 膨脹 — 僅接受 http(s) URL，讓 request body 輕巧、log 清楚可讀。
gpt-image-2 API 回應封包格式
穩定的錯誤碼、request_id 關聯、隱藏上游供應商訊息
每個 gpt-image-2 API 回應都帶一組 request_id，你可以直接貼在客服工單上。錯誤統一使用固定 envelope，欄位包含 error.code、error.message、error.request_id。一小組穩定的錯誤碼涵蓋所有失敗情境 — UNAUTHORIZED、INVALID_REQUEST、INSUFFICIENT_CREDITS、NOT_FOUND、RATE_LIMITED、INTERNAL_ERROR。上游供應商名稱會從每一條訊息中洗掉，你的客戶端不會在任何故障時看到廠商內部細節。
gpt-image-2 API 與原生 OpenAI 呼叫的比較
固定費率 credits、R2 鏡像儲存、兩種模式共用單一介面
gpt-image-2 API 提供每張固定的 credit 價格、不會在 24 小時後失效的託管 PNG URL，以及一個同時涵蓋文生圖與圖生圖的端點。相同的圖片透過 OpenAI 的 images endpoint 需依尺寸與品質收取 $0.01–$0.20，還會配發必須下載後再轉存的臨時 signed URL。批次 n=4 就是 credits 線性計算 — 沒有獨立端點、沒有隱藏的品質分級價格、沒有按使用者授權的費用。
如何使用 gpt-image-2 API
四個步驟，五分鐘內跑出第一個 curl。
1
01建立 API Key
登入後打開 Settings → API Keys，點 Create，把明文 key 複製一次保存起來。gpt-image-2 API 只在建立當下顯示 key — 請妥善存進 secret manager。
2
02POST /api/v1/images/generate
傳入包含 prompt、aspect_ratio、n 以及選填 reference_images 的 JSON。gpt-image-2 API 會立即回傳 task_id 與 processing 狀態。
3
03輪詢 /api/v1/images/task/[id]
提交後等十秒，接著每五秒輪詢一次，直到 gpt-image-2 API 把狀態切換為 completed 或 failed。端到端延遲通常落在 45–60 秒。
4
04使用託管 URL
gpt-image-2 API 完成的回應會附上穩定的 https://file.gptimg.co URL。你可以直接 hotlink、鏡像到自家儲存，或是把它丟回前端顯示。
gpt-image-2 API 常見問題
串接、定價、速率限制
用 gpt-image-2 API 開始出貨
gpt-image-2 API 註冊即送免費 credits，兩下點擊就能拿到 Bearer token，從 prompt 到託管 PNG 只需 45 秒往返。不用裝 SDK，開始用不必綁定信用卡。