401 invalid_api_key：API Key 无效怎么解决
401 认证失败的九种原因排序：Key 复制带空格、环境变量名错、用了测试 Key、Key 被禁用，附逐条验证方法。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
认证401api-key
30 秒结论
401 只有一个意思：你的 Key 没有被接受。 90% 的情况是复制时带了空格、环境变量名写错，或者用错了环境的 Key。
先用 curl 直接请求一次——curl 能过就是客户端配置问题，curl 也不过就是 Key 本身的问题。
报错原文对照
// OpenAI
{'error': {'message': 'Incorrect API key provided: sk-xxx. You can find your API key at https://platform.openai.com/account/api-keys.', 'type': 'invalid_request_error', 'code': 'invalid_api_key'}}
// Anthropic
{"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"}}
// 中转站常见
{"error":{"message":"无效的令牌","type":"new_api_error"}}
{"error":{"message":"令牌已过期","type":"new_api_error"}}原因排序
| 概率 | 原因 | 怎么确认 | |
|---|---|---|---|
| 40% | Key 复制时带了空格或换行 | `echo "$KEY" \ | cat -A` 看首尾 |
| 25% | 环境变量名不对 | 客户端要求的变量名可能不是 OPENAI_API_KEY | |
| 15% | 用错了 Key（测试/正式、不同站点） | 拿 Key 前 8 位对一下后台 | |
| 10% | Key 已被禁用或删除 | 后台看状态 | |
| 10% | 请求头格式不对 | 应该是 Authorization: Bearer sk-xxx 或 x-api-key: sk-xxx |
修法
第一步：剥离客户端，用 curl 验证
# OpenAI 兼容
curl https://api.example.com/v1/models \
-H "Authorization: Bearer $KEY"
# Anthropic
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'- curl 通过 → 问题在客户端配置
- curl 也 401 → 问题在 Key 或站点
第二步：检查环境变量
不同客户端认的变量名不同，写错了会被当成"没配 Key"：
| 客户端 | 常用变量名 |
|---|---|
| OpenAI SDK | OPENAI_API_KEY |
| Anthropic SDK | ANTHROPIC_API_KEY |
| Claude Code | ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY |
| Codex CLI | OPENAI_API_KEY |
| Cursor | 在设置界面里填，不读环境变量 |
责任判定表
| 现象 | 责任方 |
|---|---|
| curl 也 401，换 Key 就好 | 你的 Key |
| 同一个 Key 在 A 站好用、B 站 401 | B 站 |
| 昨天好用今天 401，Key 没动 | 站点把 Key 停了，或过期 |
| 只有某个模型 401 | 该分组没开通这个模型 |
特别注意
中转站的 Key 和官方 Key 不通用。你在 OpenAI 官网拿的 sk-proj- 开头 Key，拿到中转站用一定 401。
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证