# 錯誤排查

先核對位址、驗證、模型與餘額，再判斷上游狀態。

## HTTP 狀態

| 狀態 | 優先檢查 |
| --- | --- |
| `400` | JSON、必要欄位、參數範圍及素材 |
| `401` | 金鑰有效性及 `Bearer` 標頭 |
| `403` | 權限、IP、模型及群組 |
| `404` | 端點、模型/任務 ID、歸屬及 `/v1/v1` |
| `429` | 頻率、併發、token 或上游限流 |
| `5xx` | 平台/上游可用性、渠道及逾時 |

餘額不足可能使用不同狀態或業務碼，請看回應體。SSE 開始後仍可能報錯，初始 `200` 不是完整成功證據。

## 模型無法呼叫

檢查金鑰群組、模型限制、有效期及額度；使用完整 API ID，不要用顯示別名。

## 遲遲沒有輸出

檢查串流與代理緩衝。長上下文及推理可能延後首字；合理設定逾時、保留請求 ID，避免無限重試。

## 素材讀取失敗

檢查公網存取、有效期、權限及大小。已登入瀏覽器能開啟，不保證上游能下載；分享頁不一定是原始檔。

## 影片未立即回傳

依[影片任務](/zh-TW/video/)使用原任務 ID 查詢，不要重新生成來刷新進度。

## 提供客服的資訊

- 時間、時區及請求、訂單或任務 ID。
- 模型、端點、HTTP 狀態及錯誤碼。
- 脫敏參數與截圖。

勿提供密碼、驗證碼、完整金鑰、雲端密鑰或仍有效的私有素材簽名 URL。