API 參考

錯誤代碼

TokSpan API 可能返回的每個錯誤代碼的完整參考,包含說明和故障排除步驟。

HTTP 狀態碼

代碼含義處理方式
200成功請求正常完成
400錯誤請求檢查請求主體中是否有格式錯誤的 JSON 或缺少必要欄位
401未授權確認您的 API 金鑰正確且在儀表板中為有效狀態
402需要付款餘額不足 — 請在計費儀表板中儲值
404找不到模型檢查模型 ID — 請參閱可用模型
429速率限制實作指數退避 — 請參閱速率限制
500內部錯誤TokSpan 端問題 — 使用退避策略重試或聯絡支援
502錯誤閘道上游供應商錯誤 — 自動容錯移轉可能啟動
503服務不可用暫時超載 — 在 Retry-After 標頭值之後重試

錯誤回應格式

json
{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}