故障排查与求助
先保留错误码和请求时间，再做一次小范围对照。不要反复生成 Key、切换多个配置或无上限重试。
按顺序检查
- 地址与协议：OpenAI 通常以
/v1为 Base URL，Anthropic 使用域名根路径，Gemini 以/v1beta为 Base URL。SDK 会拼接端点，不要重复添加路径。 - 认证：确认当前运行的客户端实际发送了 Key；配置保存成功或终端里有环境变量，不证明客户端进程已经读取。
- 权限：检查完整模型 ID、Key 分组、余额和 Key 状态。参考密钥与分组。
- 请求内容：用短文本和最少参数对照，去掉不必要的图片、工具及扩展参数；先保存原配置。
- 服务状态：查看模型对应分组状态；主站若提供渠道监控入口，可辅助判断近期请求情况。统计和状态不是每次请求成功的保证。
状态码速查
HTTP 状态只能提供方向，具体响应错误码与错误信息优先。
| 现象 | 排查方向 | 下一步 |
|---|---|---|
| 400 | 请求格式、参数、上下文长度或上游拒绝 | 阅读具体错误；缩短请求，核对该模型参数，不原样连续重发 |
| 401 / API_KEY_REQUIRED | 请求没有被识别到有效的认证字段 | 检查活动供应商、认证方式与进程环境；不直接认定 Key 已失效 |
| 其他 401 | Key 拼写、撤销状态或认证方式 | 核对错误码与当前 Key 状态 |
| 403 | 权限、余额、账号状态或内容安全策略 | 根据错误正文定位；不要尝试绕过安全策略 |
| 404 | 路径拼接、协议或模型路由 | 检查是否重复 /v1、/responses，确认客户端与模型协议匹配 |
| 429 | 请求频率、并发或上游限流 | 减少频率/并发；有 Retry-After 时遵循；采用有限次数的退避重试 |
| 502 / 503 / 504 | 上游失败、暂时无可调度渠道或网关超时等 | 保存响应正文和时间，查看相关分组状态；不能仅凭状态码认定整站故障 |
| 超时 / 断流 | 本地网络、中间链路、客户端超时或上游中断 | 先查使用记录，再决定是否重新发起请求 |
超时后能直接重试吗？
超时不代表请求没有执行，流式中断也不代表没有生成或计费。 先查「使用记录」是否出现对应请求。记录可能有延迟，暂时没有记录不证明上游未执行。自动重试可能产生新的请求和费用，图片、视频与长上下文尤其要谨慎。
认证、权限或参数错误应先修正，不原样重试。临时限流应尊重服务端提示，设置重试次数上限；重复失败时停止并求助。不要自行添加未确认支持的幂等参数来假设重复请求免费。
提交工单或联系客服
主站若提供工单入口，可登录后提交；也可联系 admin@nekocloud.vip 或 https://t.me/dnalec 。建议提供：
text
请求时间和时区：
客户端及版本：
接口地址（不含密钥或敏感查询参数）：
模型 ID 与分组名称：
HTTP 状态 / 错误码：
请求 ID（如有）：
是否流式、能否复现：
已做的排查：
对应使用记录 / 订单号（如涉及计费或充值）：不要附 API Key、Authorization、Cookie、登录 Token、完整 auth.json 或敏感对话正文。截图也要脱敏；请求 ID 不应替换成密钥。