处理 401 和 403 错误
401 Unauthorized（未认证）
含义：服务器不认你的身份，通常是密钥问题。
| 原因 | 检查 | 解决 |
|---|---|---|
| 密钥写错/复制不全 | 对比密钥原文 | 重新复制（创建时的原文），或删除重建 |
| 密钥已停用/删除 | 后台密钥列表状态 | 重新启用或新建 |
| 请求头格式不对 | 应为 Authorization: Bearer sk-xxx | 修正请求头 |
| 填了登录密码而不是 API Key | 确认填的是 sk- 开头的密钥 | 换成 API Key |
| 密钥过期 | 检查密钥过期时间 | 重建或延长有效期 |
403 Forbidden（无权限）
含义：服务器认识你，但拒绝你访问该资源。
| 原因 | 检查 | 解决 |
|---|---|---|
| 密钥绑定的分组无此模型 | 分组模型列表 | 换分组或换模型 |
| 分组被禁用/下架 | 站内公告 | 等恢复或换分组 |
| 渠道拒绝（风控） | 稍后重试 | 降低并发，或联系客服（QQ：629567931） |
| IP 被限制 | 密钥 IP 白名单 | 检查出口 IP，联系客服（QQ：629567931） |
排查工具
- 首次调用检查：密钥页的功能，一键定位问题环节
- 单条请求详情：用量记录中看失败请求的状态码与原因
- curl 裸测（排除客户端干扰）：
bash
curl https://kuaiapi.net/v1/models \
-H "Authorization: Bearer sk-你的密钥"兜底建议
- 确认密钥与分组平台协议匹配（Anthropic 密钥别拿去调 OpenAI 端点）
- 仍无法解决时，保留请求 ID / 时间 / 状态码联系客服（QQ：629567931）