重新提交前，先診斷圖片 API 錯誤
分開連線、認證、輸入、餘額、政策與上游錯誤；HTTP 成功本身不代表任務成功。
技術核對日期:
先找出失敗的層級
DNS、TCP 或 TLS 在收到 HTTP 回應前失敗時，根本沒有 HTTP 狀態可解讀。記錄時間、主機名稱與去敏的網路錯誤，不要直接認定模型失敗。收到回應後，記錄 HTTP 狀態、error.code、request ID 與任務 ID；非同步請求還要檢查任務狀態。支援工單不要附上金鑰、原始參考圖、私人提示詞或未遮蔽的客戶資料。
400、401、402、403：檢查輸入與帳號
400 通常需要根據詳細訊息修正 payload：未知模型、無效尺寸、不支援欄位與無效參考圖是不同問題。401 應確認 Bearer 金鑰存在且有效，但不要輸出金鑰。402 檢查可用餘額、預留款與預算控制；403 檢查模型與路由權限，在 JSON 填入受限路由名稱不會自動取得權限。反覆提交相同錯誤設定並非修復。
不要把 429、451 與 5xx 當成同一原因
429 需要調查限流來源並使用有限重試策略。圖片流程中的 451 應查看詳細錯誤與政策背景，不能直接改判成檔案格式錯誤，更不能為了繞過限制而反覆重送。5xx 可能涉及服務、上游、容量或逾時，但狀態碼本身不足以判斷是哪個元件出錯。先保留既有任務與請求 ID、確認最終狀態，再決定是否建立新工作。
準備最小診斷紀錄
有效報告應包含 UTC 時間、端點、公開模型 ID、指定路由、尺寸與品質、參考圖數量、HTTP 狀態、錯誤碼、request ID 與任務狀態。註明發生於提交或輪詢、是否曾收到結果，以及能否用單張授權且非敏感圖片重現。這足以開始調查，不必分享秘密。GET /healthz 成功僅驗證健康端點，不代表帳號權限或完整生成流程正常。
各模型參數
這是公開設定快照，不代表即時可用性。參數、支援路由與參考圖限制請查看各模型頁面。
- Gemini 3.1 Flash Lite Image
google/gemini-3.1-flash-lite-image - Gemini 3.1 Flash Image Preview
google/gemini-3.1-flash-image-preview - GPT Image 2
openai/gpt-image-2