核心概念
报错码
常见报错码与处理方式。
报错不扣费
每次请求先预扣额度，返回下表任何错误时预扣的额度都会自动退回，只有成功的请求按实际 tokens 扣费。可以在控制台「日志」页核对。
| 状态码 | 常见原因 | 怎么处理 |
|---|---|---|
| 400 | 请求格式不对：缺少 model 或 messages、参数超出模型限制、上下文过长 | 对照示例检查请求体；缩短输入或调低 max_tokens |
| 401 | 令牌无效：填错、已删除、已过期，或请求头写法不对 | OpenAI 协议用 Authorization: Bearer sk-...；Anthropic 协议用 x-api-key 或 Claude Code 的 ANTHROPIC_AUTH_TOKEN |
| 403 | 余额不足、令牌额度用完、令牌限制了可用模型或 IP | 在「钱包」查看余额，在「令牌」页检查额度和模型限制 |
| 404 | 地址或模型名不对：Base URL 多写或漏写 /v1，模型名不存在，或用了本站没有的 Claude / GPT 官方模型名 | OpenAI 协议用 https://xtemapi.com/v1，Anthropic 协议用 https://xtemapi.com；模型名从模型广场复制 |
| 429 | 请求太频繁，或上游该模型暂时限流 | 降低并发后重试，必要时换一个同类模型 |
| 500 / 502 / 503 | 上游模型服务异常或网关临时故障 | 稍后重试 |
| 504 / 连接中断 | 生成时间过长或网络中断 | 使用流式输出（stream: true），检查本地代理设置 |
反馈问题时请附上：时间、模型名、状态码和返回的错误信息。不要在邮件中附上完整令牌。
模型即将下线
模型广场里带「即将下线」标签的模型，下线前仍可调用，下线后调用会报错。按控制台公告换成替代模型即可，只需改模型名。