错误码

本文档列出了 AI2API 平台可能返回的 HTTP 状态码和错误信息。

HTTP 状态码

状态码状态说明处理方式
200success请求成功无需处理
400bad_request请求参数错误检查请求参数
401unauthorized未认证或认证失败检查 API 密钥
403forbidden权限不足稍后重试
404not_found资源不存在稍后重试
429too_many_requests请求频率过高降低请求频率
500internal_error服务器内部错误稍后重试
503service_unavailable服务暂时不可用稍后重试

错误响应格式

{
  "success": false,
  "data": null,
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "details": "The provided API key is not valid or has been revoked."
  }
}

常见错误处理

API Key 无效

请检查密钥是否正确复制,是否包含多余空格。如仍无法解决,请重新创建密钥。

请求频率限制

请降低请求频率,或使用指数退避策略重试。如需更高限额,请联系管理员。

余额不足

请前往 开发者控制台 充值。