错误码

DevLens 返回标准 HTTP 状态码和 OpenAI 兼容的错误对象。

状态码

状态码	含义	说明
200	成功	请求成功
400	请求错误	请求格式有误，检查参数
401	未授权	API Key 无效或缺失
403	禁止访问	权限不足
404	未找到	端点不存在
429	请求过多	超出速率限制或余额不足
500	服务器错误	服务端内部错误
502	网关错误	上游供应商不可用
503	服务不可用	暂时性中断

错误响应格式

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

常见错误

401 — API Key 无效

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

1. 确认密钥以 sk- 开头
2. 确认密钥在控制台中为启用状态
3. 检查 header 格式：Authorization: Bearer sk-xxx

429 — 余额不足

{"error": {"message": "Insufficient quota", "type": "insufficient_quota"}}

1. 前往控制台 → 充值
2. 检查密钥级别的配额限制

400 — 模型不存在

{"error": {"message": "Model not found: xxx", "type": "invalid_request_error"}}

1. 确认 model 参数拼写正确
2. 通过 GET /v1/models 查询可用模型
3. 确认该模型在当前密钥的可用范围内