#故障排查

请求失败时按本页顺序定位，大多数问题三步之内能找到原因。

#第一步：一条命令定位问题层

curl -i https://tokens.byteseek.ai/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

#第二步：按状态码定位

完整清单见错误码清单。

#第三步：核对客户端配置

按出错频率排序的检查点：

1. /v1 的有无：Anthropic 格式不带、OpenAI 格式带，见 API 端点；
2. 密钥完整性：重新从API 密钥页面复制，注意首尾空格和换行；
3. 格式与分组匹配：客户端说 OpenAI 协议，Key 就必须绑 OpenAI 格式分组；
4. 复合 Key 前缀：模型 ID 必须写成 前缀/模型ID；
5. 环境变量生效：改完 source，并用 echo 确认。

#高频症状速查

#反馈模板

以上都排除后仍有问题，按模板提供信息，处理最快：

时间：2026-08-28 12:00 (UTC+8)
Key 前缀：sk-abc...（只给前 8 位，不要发完整 Key）
分组：xxx
模型：xxx
客户端：Claude Code / Codex / Cherry Studio / curl
状态码：403
响应体：（完整粘贴）
请求 ID：（响应头里的 request id，有就带上）
是否可复现：稳定复现 / 偶发（频率）

发送到服务支持邮箱：Support@mail.byteseek.ai；如需通过微信联系客服，请前往站点右上角查看最新客服联系方式。