KingAI

错误排查:401、模型不可用、429 与超时

使用 KingAI API 时常见报错的原因和处理方法:401 鉴权失败、模型不存在或不可用、429 频率与并发限制、请求超时。

401 或 403

  • 确认请求头中没有多余空格或引号。
  • 确认 Key 尚未被删除或过期。
  • OpenAI 风格入口优先使用 Authorization: Bearer ...。
  • Gemini 原生入口优先使用 x-goog-api-key。

模型不存在或不可用

不要猜测模型 ID。重新请求 GET /v1/models;Gemini 原生入口使用 GET /v1beta/models。返回列表由当前 Key 的账户分组、白名单和实时调度范围决定。

429

429 通常表示当前请求超过了适用的速率或并发限制。降低并发并采用带抖动的指数退避,不要立即无限重试。

超时或 5xx

  • 先用模型列表接口确认基础连接。
  • 缩短单次请求,确认不是客户端自身超时。
  • 保留响应状态码和请求时间,但不要在工单中粘贴完整 Key。
  • 通过站点配置的联系入口请求支持。

地址检查

当前文档使用的 API 根地址是 https://kingai.top。Claude Code(ANTHROPIC_BASE_URL)和 Gemini CLI 直接填它;Codex 和其他 OpenAI 兼容客户端填 https://kingai.top/v1。不要重复拼接 /v1:/v1/v1/... 会返回 404。