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"
}
}