常见问题
先看 HTTP 状态码，再检查请求地址、Authorization 请求头和模型名称，通常能快速定位问题。
状态码速查
| 状态码 | 含义 | 优先检查 |
|---|---|---|
| 400 | 请求参数不符合接口要求 | JSON 格式、模型支持的参数和消息结构 |
| 401 | 缺少或无效的鉴权信息 | Key 是否正确；是否使用 Bearer 格式；是否有多余空格 |
| 404 | 请求路径不存在 | Base URL 是否包含 /v1；是否重复拼接 |
| 429 | 请求过多或额度受限 | 账户额度、并发和上游限制；稍后重试 |
| 5xx | 上游或网络服务暂时异常 | 保存请求 ID，间隔后有限重试 |
提示缺少 Authorization
标准请求头格式如下。Bearer 后有一个空格：
http header
Authorization: Bearer YOUR_API_KEY如果客户端把 Key 放进查询参数或使用了不同的请求头名称，九关不会将它识别为标准鉴权。
打开首页或错误路径显示 404
api.jiuguan.app 是 API 子域，只允许 /v1 及其下级路径；直接用浏览器打开根路径返回 404 是预期行为。教程网站位于 jiuguan.app。
模型不存在
模型名称必须与服务当前返回的 ID 完全一致，包括大小写和符号。可先请求：
endpoint
GET https://api.jiuguan.app/v1/models连接慢或偶发失败
- 先用同一网络访问其他 HTTPS 站点，排除本地断网。
- 更换移动网络或宽带测试，判断是否为单一运营商路径问题。
- 降低并发，避免客户端在失败后立即无限重试。
- 保留响应中的请求 ID、时间和状态码，排查时不要发送完整 Key。
请求会被缓存吗
九关 API 转发已明确使用 no-store 策略，不缓存聊天请求和回答。客户端自身是否保存聊天记录，取决于你所使用的软件设置。
反馈问题时请先脱敏
可以提供时间、状态码、模型名称和请求 ID；不要提供完整 API Key，也不要直接公开含有隐私的完整对话。