# 常見錯誤與排查工單

## 依序排查

| 現象 | 優先檢查 |
| --- | --- |
| 401 / 403 | 是否為本站金鑰、是否啟用或過期、金鑰限制與驗證標頭 |
| 模型不可用 | 模型 ID、帳戶權限、路由是否啟用、端點協定是否匹配 |
| 餘額不足 | 可用與凍結餘額、生成規格與預估費用 |
| 400 / 422 | 模型必填欄位、支援時長與比例、參考圖格式 |
| 429 | 平台或上游限流，遵循 Retry-After，避免集中重試 |
| 5xx / 逾時 | 保存請求編號與時間，重送前先查詢既有任務 |
| 助手能聊天卻無法使用工具 | Responses / Messages、串流事件、工具呼叫往返及客戶端版本 |
| 顯示完成卻沒有下載 | 任務詳情、輸出 URL 與資源有效期，回報原任務編號 |

## 有效工單資訊

開啟[私人工單](/zh-TW/app#tickets)，提供模型 ID、生成模式、請求或任務編號、含時區的時間、工具版本、請求路徑、HTTP 狀態碼與已遮蔽敏感資料的錯誤文字。說明預期與實際結果，必要時附遮蔽後截圖。請勿附完整 Authorization、API 金鑰、Cookie、私鑰或未遮蔽的設定檔。

## 避免重複扣款

網路逾時可能發生於上游接受任務之後。先查詢既有任務詳情，請勿連續點擊生成。除非模型介面明確保證冪等性，否則不要自動重試建立請求。結合請求紀錄、錢包明細與消費分析確認最終結果和費用。