錯誤碼
Lazu 錯誤回應遵循 OpenAI 風格：
{
"error": {
"message": "Human-readable description",
"type": "invalid_request_error",
"code": "missing_required_parameter",
"param": "purpose",
"request_id": "req_lazu_01ABCDEF..."
}
}code 是穩定的機器可讀欄位，程式應匹配 code 而不是 message。
request_id 也會出現在 X-Lazu-Request-Id 回應標頭中；聯絡支援時請帶上它。
HTTP 狀態碼
| 狀態碼 | 類型 | 建議處理 |
|---|---|---|
| 200 | 成功 | 無需處理 |
| 201 | 檔案上傳成功 | 等同成功，部分用戶端需要相容 201 |
| 400 | 請求錯誤 | 修正 request body 或參數後再試 |
| 401 | 認證失敗 | 修正 API Key，不要盲目重試 |
| 403 | 禁止存取 | key 被停用、IP 不在白名單或額度耗盡 |
| 404 | 不存在 | path、model 或 file_id 錯誤 |
| 413 | Payload 過大 | 檔案或引用內容超過限制 |
| 422 | 校驗失敗 | body schema 正確但欄位值非法 |
| 429 | 速率限制 | 按 Retry-After 等待後重試 |
| 500 | Lazu 內部錯誤 | 指數退避重試，持續出現則聯絡支援 |
| 502 | 上游錯誤 | 可重試，Lazu 會盡量切換備用 channel |
| 503 | 上游不可用 | 通常是暫時問題，可重試 |
| 504 | 上游逾時 | 可重試，並檢查請求是否過慢或過大 |
常見錯誤碼
| Code | 含義 |
|---|---|
invalid_api_key | Header 缺失、格式錯誤、key 不存在或已刪除 |
insufficient_quota | 餘額為零，需要儲值 |
ip_not_allowed | 目前請求 IP 不在 key 的白名單內 |
token_disabled | key 被手動停用 |
token_expired | key 超過過期時間 |
bad_request_body | JSON 無法解析，或上游認為請求格式錯誤 |
missing_required_parameter | 缺少必填欄位，param 會指出欄位名稱 |
model_not_found | 模型不存在，或目前 key 沒有存取權限 |
file_not_found | file_id 不存在或不屬於目前 key |
file_too_large | 單檔案或 Responses 解引用總大小超限 |
pricing_not_configured | 模型存在，但目前 lane 沒有設定售價 |
request_rate_limit_exceeded | 觸發帳號層級 RPM 限制 |
token_rate_limit_exceeded | 觸發單一 API Key 的 RPM/TPM 限制 |
upstream_error | 上游返回非 2xx，details.status_code 是原始狀態 |
upstream_timeout | 上游逾時 |
no_available_channel | 沒有可用 channel 服務目前模型和 lane |
重試策略
可重試：429、500、502、503、504、上游 5xx。不可重試：400、
401、403、404、422，需要先修正請求、認證或額度。