API 错误排查

API 返回 401 怎么排查

401 通常表示认证信息没有被服务接受。先确认请求发到正确的地址，再检查 API Key 是否完整、有效，以及客户端是否真的使用了这组环境变量。

VC API 编辑整理 / 更新于 2026 年 10 月 7 日

401 代表什么

401 是认证失败。它和余额不足、模型不可用、上游超时是不同问题。不要先反复重试，也不要为了绕过错误把 Key 写进公开日志。

地址：确认请求地址是当前 VC API 站点或控制台提供的分组地址，不是登录页地址。
认证头：OpenAI 兼容通常是 Authorization: Bearer <key>；Anthropic 客户端通常使用 ANTHROPIC_AUTH_TOKEN。以客户端生成配置为准。
Key：重新复制，检查是否截断、带换行、过期或已被撤销。
进程环境：在启动 CLI 或 IDE 的同一个终端检查变量，重启客户端后再测。

curl https://sub.vcnovb.cn/v1/models \
  -H "Authorization: Bearer $VC_API_KEY"

只把上面的占位变量替换为本地环境变量，不要把真实 Key 直接写进 shell 历史、截图或文章。若该请求成功而客户端失败，问题在客户端配置；若也失败，保留状态码和请求时间去控制台工单确认。

提供站点、发生时间、接口路径、模型 ID、HTTP 状态码和脱敏响应。不要提供完整 API Key、Authorization 头、用户输入或文件内容。

本文只说明接入思路，实际模型、地址、权限和价格以 VC API 控制台当前配置为准。不要把 API Key 粘贴到公开内容中。