錯誤

錯誤採 OpenRouter 封包：HTTP 狀態等於 error.code，error.metadata.error_type 是穩定的機器可讀分類。

封包

所有非 2xx 回應（與串流中途失敗）皆為此結構：

JSON

{
  "error": {
    "code": 402,
    "message": "Insufficient credits",
    "metadata": {
      "error_type": "insufficient_credits",
      "limit_source": "nxio_credits",
      "balance_usd": "0.0000000000",
      "required_usd": "0.0138600000"
    }
  }
}

狀態碼

狀態	error_type	意義
400	invalid_request	請求格式錯誤、缺 model / messages、不支援的參數。
400	context_length_exceeded / max_tokens_exceeded	prompt 或要求的輸出超過模型上限。
401	unauthorized	API key 缺少、格式錯誤、已停用或已撤銷。
402	insufficient_credits	餘額或 key 上限不足，見 limit_source。
403	forbidden / content_policy_violation	帳號停用，或供應商拒絕該內容。
404	not_found	未知或已停用的模型；未知的 generation id。
408	timeout	供應商未在時限內回應。
429	rate_limit_exceeded	供應商或 NXIO 速率限制，請遵守 Retry-After。
502	server / provider_overloaded	供應商錯誤，可退避重試。
503	provider_unavailable	該模型目前無可用容量。

重試建議

408、429、502、503 以指數退避加抖動重試；400、401、402、404 不要在未修改請求的情況下重試。每個回應都帶 X-Request-Id，聯絡支援時請附上。