Appearance
报错码
| 状态码 | 常见原因 | 怎么处理 |
|---|---|---|
| 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,模型名不存在 | OpenAI 协议用 https://xtemai.com/v1,Anthropic 协议用 https://xtemai.com;模型名从模型广场复制 |
| 429 | 请求太频繁,或上游该模型暂时限流 | 降低并发后重试,必要时换一个模型 |
| 500 / 502 / 503 | 上游模型服务异常或网关临时故障 | 稍后重试;查看 服务状态;持续出现请发邮件反馈 |
| 504 / 连接中断 | 生成时间过长或网络中断 | 使用流式输出(stream: true),检查本地代理设置 |
反馈问题时请附上:时间、模型名、状态码和返回的错误信息,发送至 support@xtemai.com。不要在邮件中附上完整令牌。
