11book / docs

文档中心

从第一次调用到生产排错,按场景找到可直接复制的配置。

文档目录 · 错误排查

▪ troubleshooting

错误排查

按状态码和错误信息定位问题,先检查密钥、余额与请求参数,再决定是否重试。

错误码速查

状态 / 信息原因解决办法
401API Key 无效、被停用或未携带检查 Authorization 头是否为 Bearer + 密钥;到API Keys确认状态为启用
insufficient_quota余额不足(或 Key 的额度上限用尽)到余额充值页充值;或提高该 Key 的额度上限
429触发限流指数退避重试;批量任务降低并发或错峰
400请求参数不合法检查 model 名称拼写、messages 结构、max_tokens 等参数
content_filter内容触发安全策略调整输入内容;这是上游模型的安全策略,与 11book 无关
5xx上游链路异常对可恢复错误做有限次退避重试;持续失败请联系 [email protected] 并附请求标识

排查三步法

  1. 看错误信息:先查看错误响应里的 error.message 或message,结合状态码确认原因。
  2. 看余额与 Key 状态:到控制台确认余额充足、Key 处于启用状态、 Key 的额度上限没被打满。
  3. 最小化请求:用 curl 发一个输入简短、输出受限的请求复现问题, 排除业务代码干扰后再逐项加参数。

流式请求的特别说明

流式(stream=true)请求一旦开始输出,HTTP 状态码已是 200—— 后续的错误以 SSE 事件中的 error 对象送达,解析时别忘了处理事件流里的错误分支。

The Final Page

万万不可

wan wan bu ke · never, ever

用户怕什么,我们万万不可什么。这是我们的承诺,也是名字里「万万」的意思。

01万万不可静默降级
02万万不可泄漏密钥
03万万不可糊涂收费
04万万不可暗改价格
05万万不可让额度过期
06万万不可跑路失联
BASE URLhttps://api.11book.ai/v1