错误码说明
AItiktak API 使用标准 HTTP 状态码和错误格式,便于排查问题。
错误响应格式
{
"error": {
"code": "invalid_request_error",
"message": "Invalid 'model': qwen-invalid. No such model exists.",
"type": "invalid_request_error",
"param": "model"
}
}错误码列表
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 400 | 请求参数错误 | 检查请求参数格式和必填字段 |
| 401 | 认证失败 | 检查 API Key 是否正确 |
| 403 | 配额不足/无权限 | 充值或升级套餐 |
| 404 | 模型不存在 | 检查模型名称是否正确 |
| 429 | 请求频率超限 | 降低请求频率或升级套餐 |
| 500 | 服务器内部错误 | 联系技术支持 |
| 503 | 服务暂时不可用 | 稍后重试或切换服务商 |
常见错误处理
quota_exceeded - 配额不足
当前 API Key 的配额已用完
解决:在控制台增加配额或充值
rate_limit_exceeded - 速率超限
请求频率超过了限制
解决:降低请求频率、实现重试机制、或升级套餐
upstream_error - 服务商错误
上游服务商返回错误
解决:检查服务商状态,或切换到其他服务商