错误处理

当 API 请求失败时，NexusModels 会返回对应的 HTTP 状态码和错误信息。

错误响应示例

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

常见状态码

HTTP 状态码	说明
200	请求成功
400	请求参数错误
401	API Key 无效或缺失
403	无权访问指定模型或接口
404	接口或模型不存在
429	超过速率限制或预算额度
500	服务内部错误
502	上游模型服务异常
503	服务暂时不可用

预算超限

当虚拟 Key、用户或 Team 超过预算时，请求可能返回：

HTTP/1.1 429 Too Many Requests

应用程序应停止继续重试，并检查账户预算或剩余额度。

请求重试建议

对于 429、500、502 和 503，可以使用指数退避策略进行有限次数重试：

第一次重试：等待 1 秒
第二次重试：等待 2 秒
第三次重试：等待 4 秒

不要对认证失败、模型无权限或预算耗尽进行无限重试。