錯誤碼QA限流
錯誤碼與開發者 QA
預留錯誤碼、限流、鑑權和任務失敗排查入口。
更新於 2026-06-29 3 分鐘閱讀
本文目錄
錯誤響應形態
建議所有 API 錯誤保持穩定結構,至少包含 code、message、request_id 和可選 details,方便開發者定位問題並聯系客服。
json
{
"code": "invalid_request",
"message": "model is required",
"request_id": "req_demo_123",
"details": {}
}常見問題
- 1401 未認證檢查 API Key 是否存在、是否過期、是否用於正確環境。
- 2429 限流降低併發,或使用後臺任務隊列做重試和退避。
- 3任務失敗讀取 task error 字段,區分參數錯誤、模型拒絕、資源下載失敗和系統異常。
