跳到主要内容

常见问题

请求为什么失败​

优先检查 API Key、Base URL、模型名称、余额、请求格式和网络。大部分接入问题来自这几项配置。

为什么返回 401​

常见原因：

  • API Key 错误；
  • 请求头缺少 Authorization: Bearer sk-...；
  • Key 被禁用或删除；
  • Key 复制时多了空格或换行。

为什么返回 429​

429 通常表示请求过快、并发过高或触发上游限制。建议降低并发、增加重试间隔、缩短任务批次，必要时联系技术支持确认限额。

为什么返回 500 或 502​

这类错误通常与上游模型、网络、代理或临时服务状态有关。请记录请求时间、模型名、错误信息和请求 ID，然后稍后重试或联系技术支持。

为什么余额扣得快​

可能原因包括：

  • 使用了高倍率模型；
  • 上下文过长；
  • 输出长度没有限制；
  • 批量任务重复请求；
  • 流式输出内容较长。

为什么模型不可用​

模型可能被临时维护、上游限流、名称调整或权限未开通。请先查看控制台模型列表，并准备备用模型。

流式输出为什么中断​

常见原因包括客户端超时、网络中断、代理超时、上游中断或输出过长。建议增加客户端超时时间，并记录完整错误日志。