常见错误排查（503 / 401 / 404）

分组不匹配、Base URL 格式、密钥无效、余额不足等问题的快速自查方案。

先记录请求时间、客户端版本、目标模型、使用线路和脱敏错误正文。错误码只能缩小范围，不能单凭它认定原因。

401：认证失败

检查密钥是否复制完整、是否过期或已禁用，以及客户端是否把密钥发给正确的地址。不要把余额不足一律当成 401，也不要将本站密钥发往 OpenAI 官方地址。

查看响应正文，核对账户状态、密钥权限、余额、额度和分组限制。不同接口的错误码可能不同，以实际说明为准。

OpenAI SDK 和 Codex 自定义供应商通常配置 https://api.sfapi.de/v1；Claude Code 的 ANTHROPIC_BASE_URL 通常配置 https://api.sfapi.de。

检查最终请求路径：常见接口为 /v1/responses、/v1/chat/completions、/v1/messages。避免重复 /v1，也不要把完整接口路径填入会自行追加路径的 Base URL 字段。尾部斜杠是否可用取决于客户端，不应盲目来回切换地址。

减少并发，按响应中的重试提示等待。不要连续点击重试或同时切换多个线路重复提交。两条线路共用账户，不会绕过账户限制。

可能原因包括分组没有可用上游、模型或协议不匹配、通道限流、维护与临时故障。先核对分组和模型，再查看状态信息；没有证据表明 99% 的 503 都由密钥分组造成。

核对网络、代理设置和客户端超时时间。长推理或高质量生图可能需要更久；不能据此认定 xhigh 不受支持或必须关闭上下文压缩。

中断等待不等于服务端取消。先查使用记录和生成结果，再决定是否重试。

提供请求时间、请求 ID（若有）、模型、客户端名称和脱敏错误截图。不要发送完整 API Key、密码、登录 Cookie 或带密钥的配置链接。

客服 QQ：2796802957。其他联系方式以控制台支持页面为准。