先說結論。在 API易 上批量出圖，常規任務默認用 gpt-image-2.5-all，走 Default 分組，按次令牌或按量令牌都能調用，標價 0.025 美元/張。需要鎖定固定尺寸或 4K 時，把模型名換成 gpt-image-2.5-vip 這類 -vip 型號，標價 0.03 美元/張。不過 -all 專頁自己寫明，-vip 的 4K 有穩定性波動，不作爲 4K 首選。需要官方 quality 檔位、蒙版局部重繪或任意合法尺寸時走官轉，新項目優先看 gpt-image-2.6-flare（速度優先）和 gpt-image-2.6-sunburst（編輯與精度優先）。
兜底分兩種情況。官轉在 Default 分組持續報 429 或飽和時，把令牌分組切到 image2Enterprise，模型名不用改。官逆遇到 ChatGPT 網頁版或 Adobe 原廠故障時，不要對同一條逆向線路反覆退避，應把模型名改成官轉型號，並確認令牌是「按量優先」。另外有兩類錯誤不能原樣重試：內容安全拒絕和參數錯誤。還要注意 n 參數，它在 -all 上會按 n 倍扣費，但仍只返回 1 張圖。
GPT 圖像通道的四個名字分別是什麼
同一個 GPT 圖像模型在列表裏會出現幾種後綴，它們分別代表上游來源和計費方式。其中「企業分組」不是模型，而是令牌上的一個路由選項。下面按文檔用詞逐一說明：
- 官轉：官方直連 OpenAI Images API，文檔寫明請求和響應與 OpenAI 官方一致。價格總表裏的官轉圖像型號有
gpt-image-2.6-flare、gpt-image-2.6-sunburst、gpt-image-2.5-flare、gpt-image-2.5-sunburst、兩者的日期快照gpt-image-2.5-flare-2026-09-08與gpt-image-2.5-sunburst-2026-09-08，以及上一代gpt-image-2。文檔建議文生圖優先用 flare，編輯和多圖融合優先用 sunburst。生產環境可以鎖定日期快照，避免別名指向發生變化。 - 官逆 -all：逆向 ChatGPT 網頁版。
gpt-image-2-all和gpt-image-2.5-all同價、行爲一致、可以互換。原因是 ChatGPT 網頁版已整體升級到 Images 2.5，所以gpt-image-2-all出的也是 2.5 的圖。文檔建議新項目直接用gpt-image-2.5-all。 - 官逆 -vip：Adobe 官逆線路（Firefly），型號有
gpt-image-2-vip、gpt-image-2.5-flare-vip、gpt-image-2.5-sunburst-vip。別名gpt-image-2.5-vip指向gpt-image-2.5-sunburst-vip。 - 企業分組
image2Enterprise：官轉在 OpenAI 上游的企業兜底分組。FAQ 明確說明它不是 Google Vertex，也不是用來縮短出圖時間的加速線。它的作用是在默認分組擁塞時提供另一條資源池，但不能保證上游永遠可用。
還有一個分組容易被誤認爲兜底，就是 image2_OSS。它是 1 倍、不加價的分組，用途只有一個：保證返回 URL，不被降級成 base64。它不提升穩定性，適用於 -all 和 -vip。
2.6 目前只有官轉版本。2026-11-10 的價格總表和定價接口裏，都沒有 gpt-image-2.6-all、gpt-image-2.6-vip 或類似名字。型號與價格以平臺型號列表爲準。
按場景選默認圖像通道：價格與能力對照表
選通道時先看三個問題：需不需要官方畫質檔位、對尺寸要求有多嚴、成本要不要按張封頂。可以按下面的順序判斷：
- 批量出圖、成本按張封頂、尺寸長邊在 512 到 1536 之間：用
gpt-image-2.5-all。驗收標準：返回圖片的實際寬高符合預期，控制檯每次扣費等於單價乘以調用次數。 - 需要 30 檔裏的固定尺寸，或者需要 2K、4K：改用 -vip 型號，並顯式傳
size。驗收標準：以返回圖片的實際寬高爲準，不能只看請求參數。 - 需要官方
quality、mask局部重繪、透明背景、任意合法尺寸，或要和 OpenAI 字段對齊：走官轉。新項目用 2.6，需要鎖定行爲時用帶日期的 2.5 快照。驗收標準：請求字段與目標模型的官方參數表一致，不出現 400。
圖像通道價格對照表
下表的計費和標價來自價格總表（2026-11-09 更新），全部是折扣前標價。充值加贈 10% 到 20% 後實際扣費會更低，最終以控制檯爲準。完整型號和價格請查看 docs.apiyi.com/models。
| 型號 | 通道性質 | 計費 | 標價（折扣前） | 可用分組 |
|---|---|---|---|---|
gpt-image-2.6-flare / gpt-image-2.6-sunburst |
官轉（2026-11-05 上線） | 按量 | 每百萬 tokens：文本輸入 5、圖片輸入 8、輸出 30 美元 | Default、image2Enterprise、image2_OSS、SVIP |
gpt-image-2.5-flare / gpt-image-2.5-sunburst 及 2026-09-08 快照 |
官轉 | 按量 | 同上，緩存讀文本 1.25、圖片 2 美元 | Default、image2Enterprise、image2_OSS、SVIP |
gpt-image-2 |
官轉（上一代） | 按量 | 同上 | Default、image2Enterprise、image2_OSS、SVIP |
gpt-image-2.5-all / gpt-image-2-all |
官逆 ChatGPT 網頁版 | 按次 | 0.025 美元/次 | Default、image2_OSS、SVIP |
gpt-image-2.5-vip 等 4 個 -vip 名字 |
官逆 Adobe Firefly | 按次 | 0.03 美元/次 | Default、image2_OSS、SVIP |
定價接口與價格總表有一處不一致，需要分開看。 定價接口裏，gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst 的 quota_type 爲 1、model_price 爲 0.2。而 gpt-image-2.6-flare、gpt-image-2.6-sunburst 和兩個 2026-09-08 快照的 quota_type 爲 0、model_price 爲 0。價格總表則把這些官轉型號全部標爲按量。本文的標價以價格總表的按量口徑爲準，不把 0.2 當作按次價。下單前，請在控制檯覈對該分組的實際折後價。-all 的 0.025 和 -vip 的 0.03 在兩處來源一致，可以當作按次標價使用。
官轉每張圖的成本取決於輸出 tokens。對比頁（文檔自述）給出的典型區間約爲每張 0.03 到 0.2 美元，提示詞越長、size 和 quality 越高，成本越高。文檔裏有一組 2026-09-09 的粗算：1024 方圖用 2.5 的 xhigh 約 0.094 美元（3122 output tokens），用 max 約 0.211 美元（7024 output tokens），不含通常不到 0.001 美元的輸入。文檔的結論是：1K low 草圖走官轉不一定更貴，中高畫質纔是官逆 0.025 到 0.03 美元更划算的區間。
還有一箇舊價格要提醒。幫助中心 2026-04-25 的一篇舊文把 gpt-image-2-all 寫成 0.03 美元/次，那是降價前的數據。-all 在 2026-10-10 降到 0.025 美元，兩個 -all 名字同步調整。文檔給出的降價原因是：-all 比 -vip 更穩，-vip 受原廠風控影響波動較大，但仍在維護、照常可用。
圖像通道能力對照表
| 能力 | 官逆 -all | 官逆 -vip | 官轉 |
|---|---|---|---|
size |
專頁：長邊 512 到 1536 的常見寬高，含非 16 倍數；2K 不列爲精確支持 | 30 檔（10 種比例 × 1K/2K/4K），僅 images 端點生效 | 任意合法尺寸，邊長爲 16 的倍數、比例不超過 3:1，預設含 3840×2160 |
quality |
不接受 | 渠道行爲、不承諾；2.5 兩款 2026-09-10 複測到 max，gpt-image-2-vip 只到 high |
官方承諾檔位；xhigh/max 僅限 2.5 兩款（對比頁） |
n |
不接受，傳了照樣按 n 倍扣費 | 不支持，單次 1 張 | 支持 |
| 蒙版 | 只做整圖重繪 | 只做整圖重繪 | 支持 mask 局部重繪 |
| 透明背景 | 無 background，只能寫進提示詞 |
能出 alpha PNG，文檔不承諾 | 2.5 支持；gpt-image-2 已關停 |
| 速度（文檔自述） | 專頁約 30 到 60 秒；對比頁約 90 秒 | gpt-image-2-vip 90 到 150 秒；flare-vip 22 到 138 秒，sunburst-vip 37 到 120 秒 |
2026-09-09 時 2.5-flare 1K low 約 10 秒，sunburst 約 14 秒；gpt-image-2 100 到 120 秒 |
關於 -all 的速度，兩處文檔的說法不同：專頁寫約 30 到 60 秒，對比頁寫約 90 秒。本文兩個數字都列出，不取平均。-all 的 size 也存在文檔不同步：專頁寫「現已支持 size」，對比頁還寫着不接受。本文以專頁爲準。專頁還提到，1536 方圖可能經過插值，不代表原生細節。2.6 的「生成提速 50%，Flare 低畫質最快 6 秒」來自 2026-11-05 實時動態裏轉述的官方公佈，不是平臺複測的數據。2.6 的新參數（complexity、SVG、GIF 等）以 OpenAI 官方文檔爲準，不能直接套用 2.5 的參數表。
如果 4K 需求很多，-all 專頁還提到另一條路線：API易 上的 Nano Banana。價格總表中，nano-banana-pro 與 gemini-3-pro-image 系列爲 0.09 美元/次，nano-banana-2 與 gemini-3.1-flash-image 爲 0.055 美元/次。這條路線的企業分組是 NanoBananaEnterprise 和 NanoBananaReverse，不能和 image2Enterprise 混用。
圖像通道的令牌類型和分組優先級怎麼配
很多報錯其實不是通道本身有問題，而是令牌類型或分組配錯了。所有通道都走同一個 Base URL：https://api.apiyi.com/v1。端點推薦使用 /v1/images/generations 和 /v1/images/edits。令牌類型的規則只有一條需要特別記住：官轉必須用「按量優先」。用按次令牌調官轉，會因爲計費方式不匹配被拒絕。-all 和 -vip 用「按次計費」或「按量優先」都可以。
| 分組 | 倍率（定價接口 2026-11-10） | 適用通道 | 用途 | 注意 |
|---|---|---|---|---|
Default |
1 | 官轉、-all、-vip | 默認首選 | 官轉高峯期可能併發緊張，出現 429 |
image2Enterprise |
1.2 | 僅官轉 | OpenAI 上游企業兜底 | 不是加速線，不是 Vertex；-all 和 -vip 不在此分組 |
image2_OSS |
1 | 官轉、-all、-vip | 保證 URL 輸出 | 不提升穩定性；URL 約 24 小時失效 |
SVIP |
接口讀到 1，以控制檯令牌頁爲準 | 官轉、-all、-vip | 按控制檯說明 | 2026-10-29 起限時倍率活動結束 |
企業分組的 1.2 倍，文檔的解釋是：按「3000 美金單次充值大客戶加贈 20% 後約等官網原價」設定，平臺不計稅務成本。關於哪些型號在這個分組裏可見，FAQ 正文表列的是 gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2。價格總表和定價接口的 enable_groups 則顯示 2.6 兩款也在其中，FAQ 表格還沒有同步更新。文檔沒有說明這個分組需要單獨申請，如果選不到，以控制檯顯示爲準。
推薦的配置方法是「一把令牌覆蓋兩類模型」。一個令牌可以設 1 個默認分組和最多 2 個兜底分組。按文檔的配法，把第一優先級設爲 image2Enterprise，默認分組設爲 Default。這樣官轉請求優先走企業分組，-all 和 -vip 因爲不在企業分組裏，會留在 Default 正常出圖。具體操作：打開 api.apiyi.com/token，編輯令牌，選擇分組並保存，代碼不用改。驗收標準：用同一個請求分別調用一次官轉型號和一次 -all 型號，兩次都能出圖，並且控制檯裏官轉那次按 1.2 倍計費。
強依賴 URL 的業務需要單獨處理。在默認分組下，文檔記錄 2026-07 時不傳 response_format 會返回 b64_json；顯式傳 response_format 爲 url 可以拿到鏈接，但默認分組不承諾輸出格式。這類業務應把令牌切到 image2_OSS，同時顯式傳 url，拿到鏈接後立即下載轉存。驗收標準：響應裏是 url 字段，而且轉存後的文件可以打開。
出圖遇到 429、飽和、原廠故障分別怎麼兜底
同樣是報錯，背後的原因可能完全不同，所以第一步是讀錯誤體裏的 error.message，再決定怎麼處理。-vip 專頁把 429 拆成了兩種：參數被拒和分組飽和。-all 專頁對 429 的籠統解釋是「限流或額度不足」。實時動態裏還記錄過兩類原廠故障，分別來自 ChatGPT 網頁版和 OpenAI 上游。下表把這些情況整理成「看到什麼錯誤，先做什麼」：
| 看到什麼 | 判斷 | 先做什麼 | 驗收標準 |
|---|---|---|---|
| 官轉在 Default 上持續 429 或提示飽和 | 默認分組擁塞 | 到 api.apiyi.com/token 把分組切到 image2Enterprise，或調高它的優先級，模型名不變 |
同一請求能出圖，計費變爲 1.2 倍 |
-vip 返回 429，message 是 quality must be one of… 這類 |
參數被拒 | 改參數，不要原樣重試 | 改完後第一次請求就成功 |
| -vip 返回 429，message 是「當前分組上游負載已飽和」 | 偶發飽和 | 指數退避重試，同時查看實時動態 | 有限次數內恢復，否則切官轉 |
| -all/-vip 當天集中報錯，實時動態有原廠故障播報 | ChatGPT 網頁或 Adobe 原廠故障 | 停止退避，改模型名切到官轉 | 官轉請求成功，令牌爲按量優先 |
官轉企業分組返回 The server had an error while processing your request. |
OpenAI 上游故障 | 重試 1 到 2 次，仍不行就切到官逆 | 換到 -all 後可以出圖 |
| 401 | 令牌問題 | 檢查令牌，不要重試 | 換成正確令牌後恢復 |
gpt-image-2 帶 background 爲 transparent 返回 400 |
官方已關停該能力 | 透明底改用 2.5 官轉配合 png 或 webp | 返回圖片帶 alpha 通道 |
如果懷疑是原廠故障，先去 docs.apiyi.com/live 看當天有沒有對應播報，再決定是退避還是換通道。從官逆切到官轉的操作很簡單：在 API易 上用同一把令牌、只改模型名就能完成，對比頁原話是「只需更換 model 名即可切到官轉」。但有兩個前提需要逐項覈對：
- 令牌類型：確認令牌是「按量優先」。如果是按次令牌，請求會被拒絕。
- 按目標模型刪減字段：切到
gpt-image-2時，去掉 xhigh、max 檔位和透明背景；從 -all 帶過來的非 16 倍數尺寸，要改成 16 的倍數，且比例不超過 3:1。反方向從官轉切回 -all 時，要刪掉quality、n、aspect_ratio和mask。 - 超時：官轉低畫質和中畫質按 240 秒設置，high 和 xhigh 設 300 秒，max 以及
gpt-image-2的 high 用 600 秒兜底。-all 和 -vip 保守設 300 秒。輸入圖片先壓縮到 1.5MB 以內。
2026 年 4 月到 11 月的歷史播報判斷表
下面這些事件只用來說明「曾經出現過哪類故障、當時是怎麼處理的」，不代表 2026-11-10 的現狀。當前是否飽和，以當次的錯誤體和實時動態爲準。
| 日期 | 事件（歷史播報） | 當時的處理 | 今天怎麼用 |
|---|---|---|---|
| 2026-04-29 | 官轉默認分組仍報 429，只有 image2Enterprise 穩定，-all 與 -vip 都穩定 | 官轉走企業分組 | 作爲「官轉默認分組擁塞」的典型案例 |
| 2026-05-07 | 官轉企業分組也返回 server error，根因是 OpenAI 上游 | 等上游恢復或換通道 | 企業分組也不能保證上游永遠可用 |
| 2026-05-13 | 默認分組飽和，image2Enterprise 仍能出圖 | 切企業分組 | 支持優先級配法 |
| 2026-05-23 | 默認分組補充資源，文檔寫無需特意切企業分組 | 回到 Default | 擁塞是階段性的 |
| 2026-09-21 | 2.5 官轉默認分組併發緊張，企業分組穩定 | 切企業分組 | 同上 |
| 2026-10-15 | gpt-image-2-vip 負載過高；-all 因 ChatGPT 網頁原廠故障報錯；gpt-image-2 透明背景關停（對比頁記爲 2026-09-30） |
官逆先用官轉兜底；透明底改用 2.5 官轉 | 原廠故障時應換通道，不要死磕 |
| 2026-11-05 | 2.6 官轉上線，Default 分組可用 | 新項目可以使用 | 這是一條上線播報，不是故障播報 |
出圖報錯哪些該重試，哪些不該
判斷是否重試，標準只有一個：錯誤原因會不會隨着時間自己消失。負載類 429、5xx 和超時可能自行恢復，可以做有限次退避；參數錯誤、令牌錯誤和內容拒絕不會自己消失，原樣重試只會浪費時間，有時還會多扣費。選題歸檔 2026-08-25 的運維口徑是「429 可重試、內容安全無需重試」，和這個標準一致。
- 可以退避重試：負載類 429 用指數退避；5xx 重試 1 到 2 次；超時先把客戶端超時調到建議值。記錄響應頭裏的
request-id，方便排查。-vip 文檔寫 RPM 500 以內不必先考慮併發問題。 - 改了再發：參數被拒先改參數；401 先檢查令牌；400 先對照目標模型的字段表。鑑權失敗和參數校驗失敗不計費。
- 不要自動重試：內容拒絕分兩種。一種返回明確錯誤，例如「沒有按照預期生成圖片，請重新調整提示詞後重試」，這種不計費，應該修改提示詞。另一種返回 200，但正文是「我不能做到這個需求」之類的軟拒絕。協議上它算正常返回，會計費，官逆也無法在協議層提前識別。同一條提示詞不要自動重新提交。
問：-all 傳了 n=4，爲什麼只拿到 1 張卻扣了 4 次？
-all 不接受 n，但傳了仍會按 n 倍扣費。專頁舉的例子是 n=3 扣 0.075 美元，仍只返回 1 張圖。需要 N 張時，應並行調用 N 次。驗收標準：控制檯扣費次數等於實際拿到的圖片張數。
問：對比頁說 -all 不接受 size，到底能不能傳？
以 -all 專頁爲準，可以傳。顯式傳入的 size 優先於提示詞裏的尺寸描述；不傳或傳 auto 時保持原生行爲。對比頁是還沒同步更新。
問：企業分組能讓出圖變快嗎？
不能。FAQ 明確寫了它不是加速線，作用只是在默認分組擁塞時提供另一條資源池。官逆模型放在 Default 分組即可。
問：定價接口裏官轉的 0.2 是按次價嗎？
不應該這樣理解。價格總表標的是按量，本文也以按量爲準。接口對部分沒有日期的別名返回 model_price 0.2，兩處口徑不一致，下單前請在控制檯覈對實際折後價。
問：2.6 有 -all 或 -vip 版本嗎？
2026-11-10 的價格總表和定價接口裏都沒有，本文也不對上線時間做任何推測。
照做的默認配置
- 模型名：
gpt-image-2.5-all；需要尺寸或 4K 時改爲gpt-image-2.5-vip；需要官方參數時改爲gpt-image-2.6-flare或gpt-image-2.6-sunburst - 分組：第一優先級
image2Enterprise，默認分組Default；強依賴 URL 的業務另建一把令牌，使用image2_OSS - 令牌類型：按量優先（官轉和官逆都能調用）
- 超時秒數：-all/-vip 設 300；官轉低、中畫質 240，high/xhigh 300，max 600
- Base URL：
https://api.apiyi.com/v1
按這套配置跑起來後，平時只需要關注兩件事：錯誤體裏的 error.message 寫的是什麼，以及當天的實時動態有沒有相關播報。參考上面兩張表，就能判斷該退避重試、修改請求還是切換通道。
作者：APIYI 技術團隊
技術交流：遇到文中沒有覆蓋的報錯，歡迎通過 API易 官網首頁聯繫我們，並附上request-id和完整的錯誤體。
