接入出错时，先记录请求时间、HTTP 状态、模型、接口路径和返回的错误代码。保留请求 ID，但不要公开 Authorization 头或完整密钥。以下是排查方向，最终原因以具体返回信息为准。
按状态码定位问题
| 状态 | 优先检查 | 建议动作 |
|---|---|---|
| 401 | 密钥缺失、错误或失效 | 检查 Bearer 认证、复制空格、客户端是否使用了旧密钥 |
| 403 | 分组、模型或策略权限 | 核对该 Key 的分组和可用模型，按响应说明处理 |
| 404 | 端点或模型名 | 检查 /v1 是否重复，确认请求路径与模型 ID |
| 429 | 并发、请求频率或额度限制 | 读取错误说明，降低并发；有 Retry-After 时按其等待 |
| 502 / 503 | 服务暂不可用或网络故障 | 短暂等待、限制重试次数；持续失败时联系本站支持 |
看到 SVC_1001 怎么办
这是本站用于提示服务暂不可用的错误代码。它不能单独证明你的密钥余额不足。先查看本站余额与用量，再携带时间、模型和请求 ID 联系支持；不要持续自动提交同一请求。
地址错误与模型错误如何区分
使用 GET /v1/models 核对密钥能看到的模型；聊天请求使用 POST /v1/chat/completions。Claude Code 使用 Messages 配置，见接入教程。如果返回 HTML 而非 JSON，优先检查是否访问了网页路径、登录页或代理错误页。
流式输出中途断开
记录已收到的内容、持续时间和客户端超时。中断可能发生在客户端、网络或服务端；仅凭一个错误不能确定原因。先用更短的输入和更小的输出限额复现，再比较非流式请求。不要立刻重复长任务，先核查是否已有用量记录。
提交问题前准备哪些信息
- 请求时间与时区、接口路径、HTTP 状态及错误代码。
- 模型 ID、是否流式、客户端名称与版本。
- 脱敏后的最小请求，以及返回的请求 ID（如有）。
- 是否能通过短请求复现；切勿附带真实密钥和无关聊天内容。