接入文档 / 计费与排错
错误码与限流
常见错误的含义与处理办法。
错误格式
OpenAI 兼容接口的错误体为 {"error": {"message", "type", "code"}}，请以 HTTP 状态码和 error.message 为准，部分错误的 error.code 为空。
- 状态码
- 400
- error.code
- invalid_request
- 原因与处理
- 请求体无法解析或参数有误（如缺少 model），检查请求格式
- 状态码
- 401
- error.code
- （空）
- 原因与处理
- 令牌无效：密钥不存在、已禁用、已过期或额度已用完。到「API 密钥」页检查状态，必要时续期或调整额度
- 状态码
- 403
- error.code
- （空）
- 原因与处理
- 该密钥无权访问所请求的模型（密钥启用了模型限制），编辑密钥的可用模型或换用其他模型
- 状态码
- 403
- error.code
- access_denied
- 原因与处理
- 请求来源 IP 不在该密钥的 IP 白名单中，编辑密钥的 IP 限制
- 状态码
- 403
- error.code
- insufficient_user_quota
- 原因与处理
- 账户余额（或订阅额度）不足，请充值或购买套餐
- 状态码
- 403
- error.code
- pre_consume_token_quota_failed
- 原因与处理
- 该密钥的剩余额度不足以支付本次请求，提高密钥额度或改为不限额度
- 状态码
- 429
- error.code
- （空）
- 原因与处理
- 超过站点设置的请求频率限制，降低频率后稍后重试
- 状态码
- 503
- error.code
- model_not_found
- 原因与处理
- 当前分组下该模型暂无可用渠道，换用「模型价格」页列出的模型，或稍后重试
- 状态码
- 4xx / 5xx
- error.code
- bad_response_status_code
- 原因与处理
- 上游厂商返回错误，状态码原样透传，稍后重试；请求失败时预扣额度会退回
限流
请求频率限制由站点配置决定，超出后返回 429。请降低频率并退避重试（例如 1s、2s、4s），不要立即重放请求。如需调整请联系 [email protected]。