错误码

HTTP 状态码

状态码	含义	处理方式
200	成功	请求已成功完成
400	请求错误	检查请求体和参数
401	未授权	API 密钥无效或缺失
403	禁止访问	API 密钥缺少所需权限
404	未找到	端点或资源不存在
429	请求过多	请求频率过高，请退避重试
500	服务器错误	使用指数退避策略重试
503	服务不可用	上游模型暂时不可用

错误响应格式

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

常见错误

invalid_api_key

API 密钥缺失、已过期或不正确。请前往 控制台 → API 密钥 检查。

insufficient_quota

账户余额不足。请前往 控制台 → 充值 充值。

model_not_found

请求中的模型名称与可用模型不匹配。请查看 模型概览 了解有效的模型名称。

rate_limit_exceeded

请求发送过快。请实现指数退避策略：

import time

for attempt in range(5):
    response = make_request()
    if response.status_code == 429:
        time.sleep(2 ** attempt)
        continue
    break

content_policy_violation

提示词被模型的安全过滤器拒绝。请修改提示词以符合使用政策。