常见问题与报错
推荐排查顺序
Section titled “推荐排查顺序”- 打开渠道状态监控，确认目标分组的实时状态。
- 使用同一 Key 请求
/v1/models，确认 Key、线路和模型范围。 - 检查 Base URL：OpenAI 客户端需要
/v1，Claude Code 使用根域名。 - 记录发生时间、模型、节点、状态码和请求 ID，再提交售后。
| 状态码 | 常见原因 | 处理方法 |
|---|---|---|
| 401 | Key 错误、复制了空格、认证头缺失 | 重新复制 Key，检查 Authorization: Bearer |
| 403 | Key 分组不允许该模型或权限受限 | 从 /v1/models 复制模型名，检查 Key 分组 |
| 429 | 并发或上游速率限制 | 降低并发，稍后重试，必要时切换同类分组 |
| 400 | 请求体、模型名或接口协议不匹配 | 先用最小请求体测试，核对 OpenAI/Anthropic 协议 |
| 5xx | 上游或当前线路短时异常 | 查看状态页，保留时间和请求信息反馈 |
旧备用线路迁移
Section titled “旧备用线路迁移”如果客户端仍配置 https://api2.nexagwapi.com，请改为：
- OpenAI / Codex：
https://api.nexagwapi.com/v1 - Claude Code：
https://api.nexagwapi.com - 香港线路：OpenAI 使用
https://api.nexagw.org/v1，Claude Code 使用https://api.nexagw.org
API Key 无需重新创建。
售后反馈格式
Section titled “售后反馈格式”用户名或注册邮箱：发生时间：使用节点：主线路 / 香港线路使用模型：客户端：Codex / Claude Code / SDK / 其他状态码与报错：已附截图：是 / 否