跳到主要内容
Protokener
进入控制台
API 参考错误码与排查

Protokener / DOCUMENTATION

错误码与排查

先区分认证、额度、限流与上游故障，再决定是否重试。

示例使用占位密钥；模型与价格以实时目录为准。

HTTP 状态与处理

400请求参数、模型 ID 或模型与协议不匹配；修正请求后再试
401密钥无效、过期或客户端凭证失效；检查凭证，不反复重试
403账户、套餐、IP 或模型权限不足；核对账户与密钥设置
429 · insufficient_quota账户或密钥额度不足；retryable: false 时不要自动重试
429 · rate_limit_errorRPM、TPM 或并发限流；降低并发，按 Retry-After（如返回）退避
5xx平台或上游异常；保留请求 ID，避免无上限重试与重复计费

错误响应示例

下面展示本地网关额度拒绝的结构示例，不是实际用户错误；上游透传错误的字段可能不同。HTTP 429 并不一定意味着请求过快。

{
  "type": "error",
  "error": {
    "type": "insufficient_quota",
    "code": "insufficient_quota",
    "message": "额度不足，请检查账户积分与密钥上限。",
    "retryable": false
  }
}

提交问题前收集

  1. 发生时间与时区、客户端版本、精确模型 ID。
  2. HTTP 状态、error.type、error.code、服务端错误说明与请求 / Trace ID。
  3. 在金融控制台检查账户积分与当前密钥上限；上游限额不能直接推断为用户余额不足。
  4. 脱敏日志与截图，不发送 API Key、配置包授权、密码或短信验证码。

资料来源：server/src/relay/relay-error.filter.ts · server/src/relay/api-key.guard.ts

← 积分状态