错误处理

HTTP 状态码

状态码	含义	处理建议
200	成功	-
400	请求参数错误	检查请求体格式和参数
401	认证失败	检查 API Key 是否有效
403	权限不足	检查令牌额度或权限设置
404	模型不存在	确认模型名称正确
429	请求过于频繁	降低请求频率或联系管理员
500	服务器内部错误	稍后重试或联系管理员
502/503	上游服务不可用	稍后重试

错误响应格式

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

常见错误

API Key 无效

401: Invalid API key

• 检查 API Key 是否复制完整
• 确认令牌未过期或被删除

模型不存在

404: The model 'xxx' does not exist

• 检查模型名称拼写
• 确认该模型已在渠道中配置

额度不足

403: Insufficient quota

• 在控制台查看令牌剩余额度
• 联系管理员充值

请求超时

504: Gateway timeout

• 减少请求内容长度
• 检查网络连接
• 稍后重试