错误排查

先记录完整错误内容，再按地址、令牌、模型、额度和网络的顺序排查。HTTP 状态码用于缩小范围，具体原因以响应中的错误说明为准。

先检查四项接入信息

1. 使用的是本站真实 API 地址，而不是文档地址。
2. API Key 是完整且有效的模型调用令牌。
3. 模型 ID 与本站提供的名称完全一致。
4. 当前模型支持客户端使用的接口类型。

如果通过代码调用，先用最小 cURL 示例验证，减少历史上下文和额外参数带来的影响。

根据状态码排查

状态码	常见方向	建议先做什么
400	参数不合法、格式错误或模型不支持某参数	使用最小请求，检查错误中指出的字段
401	凭据缺失、无效、到期或被停用	重新复制令牌，检查状态和请求头
403	权限或限制条件不满足	检查模型、分组、IP 限制和返回说明
404	路径错误、模型不存在等	核对最终 URL 与模型 ID
429	速率、并发、额度或上游限制等	阅读具体错误，降低频率或检查额度
5xx	网关或上游服务异常	记录请求信息，查看站点公告和调用记录

不同站点和上游可能对错误进行映射，不要把某个状态码固定理解为单一原因。

鉴权失败

检查令牌内容

使用控制台复制功能重新复制，检查是否混入空格或换行，是否遗漏字符。

检查填写位置

客户端的 API Key 字段一般只填写令牌。直接 HTTP 调用则需要：

Authorization: Bearer your-api-key

检查状态和限制

确认令牌没有到期、被停用或删除，并核对模型与 IP 限制。

请求路径错误

对于本文的 Chat Completions 示例，目标路径应为：

https://api.example.com/v1/chat/completions

重复出现 /v1

如果最终路径为 /v1/v1/chat/completions，说明客户端和填写的地址可能都追加了版本前缀。

返回网页而不是 JSON

可能请求到了站点首页、登录页、文档页或代理错误页。检查请求 URL、响应类型和实际状态码。

模型不可用

确认模型 ID、接口类型和令牌权限。若错误明确表示没有可用服务或上游异常，请查看站点公告，等待恢复或选择本站提供的其他兼容模型。

额度或限流问题

额度不足

依次检查账号余额、令牌剩余额度和套餐限制。更换 API 地址一般不能解决额度不足。

请求过于频繁

降低并发，暂停循环重试。如果响应提供 Retry-After，按提示等待。程序可以采用逐步延长等待时间的方式，并限制总重试次数。

谨慎自动重试

超时、网络断开或部分服务端错误不一定表示请求未执行。自动重试可能产生重复请求及费用，请先检查调用记录。

流式回复中途停止

先确定影响范围

尝试一次简短的非流式请求。如果只有某个客户端失败，检查客户端版本、流式设置和代理配置。

再检查网络和超时

长时间请求可能受到网络断开、代理超时或上游服务影响。客户端停止显示，不足以判断服务端是否已经完成处理。

核对记录后反馈

保留出错时间、模型、客户端版本及错误内容，并检查对应调用记录。

联系支持时提供什么

通过本站实际提供的支持入口提交以下信息。无需发送完整令牌、账号密码或私密对话内容。

问题描述：
发生时间和时区：
客户端名称与版本：
使用的 API 域名和路径（不要附带密钥）：
模型 ID：
令牌名称（不是完整令牌）：
HTTP 状态码：
错误响应：
请求 ID（如果有）：
是否可以稳定复现：
已经尝试的排查步骤：

反馈充值问题时，可以补充订单号、支付时间和订单状态。请先遮住与核查无关的个人信息。