先保存这些信息
- 请求发生的日期、时间和时区；
- 请求端点、HTTP 方法和模型标识；
- HTTP 状态码与完整错误响应体；
- 响应头中的
X-Request-ID（如有）； - Key 名称或脱敏标识，不要提供完整 API Key。
按 HTTP 状态码排查
| 状态 | 常见方向 | 建议检查 |
|---|---|---|
400 | 请求格式或参数 | 核对 JSON、必填字段、端点、模型标识和协议格式；以响应体说明为准。 |
401 | API Key 鉴权 | 检查 Bearer 或 x-api-key 请求头、Key 是否完整、启用且属于正确分组。 |
403 | 访问条件或余额 | 检查账户余额、Key、账户或分组的可用范围，以及响应体给出的限制原因。 |
404 | 路径或模型 | 核对 Base URL、是否重复拼接 /v1、端点和模型标识。 |
429 | 请求频率或 Key 额度 | 检查响应体与 Key 状态；降低并发，并按响应提示决定是否稍后重试。 |
5xx | 临时服务或上游异常 | 保留请求 ID，采用有上限的退避重试；持续失败时提交工单。 |
同一状态码可能对应不同原因，响应体中的错误类型和说明优先于上表的通用分类。
分组和协议不匹配
API Key 与创建时选择的模型分组绑定。应按客户端使用的 OpenAI 兼容协议或 Anthropic Messages 兼容协议选择当前分组。跨协议使用同一把 Key，或请求不属于该分组的模型，都可能失败。
OpenAI 兼容
推荐 Base URL 为 https://api.xmapi.me/v1，Chat Completions 路径为 /v1/chat/completions。
Anthropic Messages
完整 Messages 端点为 https://api.xmapi.me/v1/messages，需使用相应请求格式和分组。
如何核对费用
- 定位调用。登录控制台，按时间、模型或请求记录找到对应调用。
- 核对计费项。文本模型通常分别记录输入 Token 与输出 Token；图片、缓存或其他能力可能使用不同计费项。
- 核对当时价格。模型单价可能调整，应结合调用发生时的站内记录，而不是用当前价格倒推历史费用。
- 提交异议。整理时间、模型、用量、费用和请求 ID，通过站内客服工单申请核对。
只有实际调用才会产生调用费用。每笔模型、用量和费用可在控制台查询；具体规则见计费与定价说明。
安全地联系支持
可从首页“服务与支持”区域查看当前公开的服务渠道，或登录后使用站内客服工单。反馈时不要发送完整 API Key、密码、支付凭证敏感字段或含私密提示词的完整请求正文。
不要为了排查而反复高频重试失败请求。对于可重试的临时错误，应限制次数并逐步延长等待时间；对参数、权限或余额类错误，先修正原因再重试。