解决 401 INVALID_API_KEY 和 API_KEY_REQUIRED

BigModel.io 返回 401 INVALID_API_KEY、API_KEY_REQUIRED 或 API_KEY_DISABLED 的原因，OpenAI 和 Anthropic 客户端如何正确发送 Key，以及如何确认实际使用的是哪个 Key。

本页目录
  1. 这是什么意思
  2. 怎么解决
  3. 常见问题排查
  4. 相关文档

请求到达了 BigModel.io，但 Key 缺失、填错或已被停用：

json
{ "code": "INVALID_API_KEY", "message": "Invalid API key", "error": { "message": "Invalid API key", "type": "authentication_error", "code": "INVALID_API_KEY" } }

#这是什么意思

code 原因
API_KEY_REQUIRED 请求里没有 Key
INVALID_API_KEY 不是 BigModel.io 的 Key，或复制不完整
API_KEY_DISABLED Key 存在但已停用
USER_INACTIVE Key 所属账户未激活

其他平台的 Key（包括 bigmodel.cn 的 Key）不能在 BigModel.io 使用。

#怎么解决

  1. 从 API Keys 重新复制 Key。复制按钮任何时候都会复制完整的 Key。
  2. 放在请求头里发送，不要放进 URL：
bash
curl https://bigmodel.io/v1/models -H "Authorization: Bearer $BIGMODEL_API_KEY"

Anthropic 类客户端也可以用 x-api-key: $BIGMODEL_API_KEY。用 ?key= 发送的 Key 会返回 400 api_key_in_query_deprecated。

  1. 确认工具实际用的是哪个 Key。旧 Key 经常留在环境变量或配置文件里。只打印开头几个字符，和控制台对比：
bash
echo "${BIGMODEL_API_KEY:0:8}"
  1. 如果控制台显示 Key 已停用，启用它或新建一个。

#常见问题排查

Claude Code 提示认证冲突。 同时设置了 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN。保留 ANTHROPIC_AUTH_TOKEN，执行 unset ANTHROPIC_API_KEY。见 Claude Code。

在网页里调用。 不要这样做：打开页面的任何人都能看到 Key。请从服务端调用 API。

怀疑 Key 泄露。 立即停用并新建一个。见认证。

#相关文档

更新于 · 以 Markdown 查看