APICEX

报错速查

这里不讲协议规范,只回答一件事:看到这个码,第一步该查什么。

状态码含义常见原因第一步
401未认证未认证Key 没带上、拼错、被删或已被撤销;也可能是把「项目 Key」用在了要求「组织 Key」的接口。先看请求头里到底有没有 Authorization,再回控制台确认这把 Key 还是 active。 API Keys →
403无权限 / 不在套餐内无权限 / 不在套餐内Key 有效但没这个模型的权限:套餐不含该模型、地区限制、或需要实名/企业认证。先看错误体里的 code(例如 MODEL_NOT_IN_PLAN),再对套餐和模型清单。 价格与套餐 →
429限速 或 额度用尽限速 或 额度用尽两种完全不同的原因:①短时间并发/请求过多;②账户额度(日/周/月)已耗尽。前者等几秒可恢复,后者要充值或等重置。看响应头有没有 Retry-After;没有就看错误文案里是 rate limit 还是 usage limit。 余额 / 用量 →
400请求本身不合法请求本身不合法最常见三种:模型 id 写错、消息角色顺序不对(tool 结果没配对)、上下文超长(超出该模型窗口)。先把请求缩到一句话复现;再核对 model id 是否在该厂商的模型清单里。 查模型名 →
404路径或模型不存在路径或模型不存在base URL 少了或多了一段(例如少了 /v1,或把 /v1 写了两遍),也可能是模型已下线。对照厂商文档里的 base URL 原样抄,不要自己拼。 服务商文档 →
5xx厂商侧故障厂商侧故障不是你的请求问题。可能是单区域过载、上游模型不可用,或网关超时。先看厂商状态页,再看本站故障记录;两者都正常再怀疑自己的网络。 故障记录 →
timeout超时 / 连接中断超时 / 连接中断流式请求被中间层缓冲、代理读超时、或客户端提前关闭连接。长回答最容易触发。先用非流式请求复现;能过说明是流式链路问题,检查代理缓冲与超时设置。 测速与延迟 →

429 是最容易误判的一个:限速几秒就恢复,额度耗尽要等到重置或充值。看错误文案里的关键词,不要只按状态码重试。

还没解决? 提交一个问题 · 测量方法