检查状态页
确认所选分组当前探测正常。
按状态码定位
| 状态码 | 通常原因 | 处理方式 |
|---|---|---|
| 401 | Key 无效、格式错误或已停用 | 重新复制 Key，确认 Authorization 格式 |
| 403 | 分组权限、上游权限或额度限制 | 检查 Key 分组和状态页 |
| 429 | 请求频率或上游额度限制 | 降低并发并稍后重试 |
| 500 | 请求处理异常、字段组合不兼容 | 保存 request id，用最短请求复现 |
| 502 | 网关无法获得有效上游响应 | 有限退避后重试并查看状态页 |
| 503 | 模型在当前分组没有可用渠道 | 从 /v1/models 复制模型名或切换分组 |
| 超时/断流 | 读取超时、网络中断或客户端取消 | 先测试非流式请求，再检查 SSE 与 timeout |
报错中的 request id 是排查关键。联系支持时提供 request id、时间、模型和分组，不要发送完整 API Key。
最短排错路径
请求 /v1/models
确认 Key 鉴权和模型名。
发送非流式短请求
排除客户端流式解析和超时设置。