错误处理指南

TLDR：了解常见错误码及其解决方法，快速排查和解决问题。

错误响应格式

当 API 调用失败时，会返回以下格式的错误响应：

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "错误描述"
  }
}

常见错误码

401 Unauthorized

错误信息：

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "invalid x-api-key"
  }
}

原因：

API Key 无效或已删除

API Key 格式错误

未提供认证头

解决方法：

检查 API Key 是否正确

确认 API Key 未被删除

检查请求头格式：

使用 x-api-key: sk-xxx 或

使用 Authorization: Bearer sk-xxx

403 Forbidden

错误信息：

{
  "type": "error",
  "error": {
    "type": "permission_error",
    "message": "insufficient_quota"
  }
}

原因：

账户余额不足

Token 权限不足

解决方法：

登录控制台充值

检查 Token 权限设置

使用余额查询 API 确认余额

429 Too Many Requests

错误信息：

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded"
  }
}

原因：

超过速率限制

解决方法：

降低请求频率

使用指数退避重试策略

联系客服提升限额

重试示例：

400 Bad Request

错误信息：

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "messages: field required"
  }
}

原因：

请求参数缺失或格式错误

模型名称错误

解决方法：

检查必需参数是否提供

验证参数格式是否正确

确认模型名称拼写正确

500 Internal Server Error

错误信息：

{
  "type": "error",
  "error": {
    "type": "api_error",
    "message": "Internal server error"
  }
}

原因：

服务器内部错误

解决方法：

稍后重试

如果持续出现，联系技术支持

错误处理最佳实践

1. 实现重试机制

2. 捕获特定错误

3. 记录错误日志

排障步骤

检查错误信息：仔细阅读错误消息

验证认证：确认 API Key 正确且有效

检查余额：确保账户有足够余额

验证参数：检查请求参数格式

查看文档：参考 API 文档确认用法

联系支持：如果问题持续，联系技术支持

技术支持

QQ 群：574897157

官网：https://buzzai.cc

错误处理指南

错误处理指南#

错误响应格式#

常见错误码#

401 Unauthorized#

403 Forbidden#

429 Too Many Requests#

400 Bad Request#

500 Internal Server Error#

错误处理最佳实践#

1. 实现重试机制#

2. 捕获特定错误#

3. 记录错误日志#

排障步骤#

技术支持#

错误处理指南

错误响应格式

常见错误码

401 Unauthorized

403 Forbidden

429 Too Many Requests

400 Bad Request

500 Internal Server Error

错误处理最佳实践

1. 实现重试机制

2. 捕获特定错误

3. 记录错误日志

排障步骤

技术支持