文档中心/API 参考/错误码说明

错误码说明

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 - 服务商错误

上游服务商返回错误

解决:检查服务商状态,或切换到其他服务商