APIMaster.ai
返回博客
APIMaster 博客

如何修复 invalid api key（OpenAI / Claude API）— 401 鉴权错误

解决 OpenAI、Claude 及中转 API 的 invalid api key、401 鉴权失败。检查 Key 格式、base_url、请求头，并用 APIMaster 免费 API Key 检测工具即时验证。

API 报错invalid api keyOpenAI APIClaude API401 错误

发布于 2026-06-29

快速结论

invalid api key（多为 HTTP 401 Unauthorized）表示提供方 无法验证你的身份，请求在进模型之前就被拒绝。常见文案：Incorrect API key provided、invalid_api_key、authentication_error、Invalid Authorization header。

快速排查： 确认 Key 无多余空格、使用正确 Header（OpenAI 用 Authorization: Bearer，Claude 用 x-api-key）、base_url 与 Key 来源一致；若 Key 已吊销则重新生成。10 秒验证： 打开免费 APIMaster API Key 检测，无需注册。

这条报错是什么意思

OpenAI 兼容接口通常要求：

Authorization: Bearer sk-proj-...

Anthropic Messages API 使用：

x-api-key: sk-ant-...

Key 缺失、格式错误、已过期，或 Key 与服务不匹配 时，返回 401，例如：

{
  "error": {
    "message": "Incorrect API key provided: sk-****XXXX.",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Claude 类似（authentication_error）。中转站常原样转发上游文案，实际问题可能是 base_url 配错 或 ** reseller Key 已失效**。

这与 内容审核 400 或 429 限速 不同——鉴权失败时，配额和安全策略都还没轮到。

常见原因

  1. 复制错误 — 少字符、或把界面上的 sk-...XXXX 掩码当完整 Key 粘贴。
  2. .env 引号 / 空格 / 换行 — OPENAI_API_KEY=" sk-..." 会导致部分 SDK 鉴权失败。
  3. Header 用错 — Claude 用了 Bearer，或 OpenAI 用了 x-api-key，或根本没带 Header。
  4. base_url 与 Key 不配套 — OpenAI Key 打到 Anthropic；中转 Key 打到 api.openai.com。
  5. Key 已删除 / 轮换 — 控制台吊销、换组织、中转欠费停号。
  6. OpenAI 项目 Key — sk-proj- 需匹配项目配置，SDK 未传 project 可能失败。
  7. 中转余额为 0 — 部分网关用笼统的 invalid api key 掩盖账户停用。

怎么修

1. 用在线工具即时测 Key

打开 API Key 检测：填入 Key、可选自定义 base URL、选模型、点 Test。立刻看到 HTTP 状态、延迟和模型回复——最快区分 Key 无效 vs 端点错误 vs 上游故障。

免费检测 API Key →

2. 核对 Header 与 SDK

OpenAI Python：

from openai import OpenAI

client = OpenAI(api_key="sk-...", base_url="https://api.openai.com/v1")  # 或中转 URL
client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "ping"}])

Anthropic Python：

import anthropic

client = anthropic.Anthropic(api_key="sk-ant-...")
client.messages.create(model="claude-sonnet-4-20250514", max_tokens=16, messages=[{"role": "user", "content": "ping"}])

确认环境变量名与工具读取的一致（OPENAI_API_KEY、ANTHROPIC_API_KEY 等）。

3. base_url 与 Key 来源对照

Key 来源 典型 base_url
OpenAI 官方 https://api.openai.com/v1
Anthropic 官方 https://api.anthropic.com
APIMaster / 中转 https://apimaster.ai/v1（OpenAI 兼容）

用 APIMaster Key 访问 api.openai.com 必失败；官方 Key 打到中转域名同理。

4. 重新生成并更新密钥

Key 泄露、进过 Git 或已轮换时，在控制台 新建 Key，更新 CI/CD 与 .env，并吊销旧 Key。

5. 确认账户状态

官方 API：账单有效、组织未封禁。中转：余额 > 0、账号未停。部分平台把欠费包装成鉴权错误。

APIMaster 能做什么

排查仍失败，或需要 新的可用 Key？APIMaster 是 OpenAI 兼容的聚合 API，从三个维度帮你避开「Key 无效」类陷阱：

优势 说明
折扣 模型广场 多路上游比价，OpenAI 系最高约 90% off、Claude 系最高约 85% off 官方标价（以页面实时价为准），比零散中转更省。
稳定性 统一入口 https://apimaster.ai/v1 + 一个 Key 调多模型，减少 Key 与 host 混用导致的伪鉴权失败；多渠道路由互为备份。
模型保真 合法 Key 也可能被劣质中转换模型 — 用 指纹模型检测 验证后端是否真在跑所标 GPT/Claude。Key 是否通，先用 API Key 检测。

$1 起充，按量付费，无需订阅。

立即注册 APIMaster →

相关报错

FAQ

OpenAI invalid api key 是什么意思？ 服务器拒绝了 Authorization — Key 错误、格式不对、已吊销，或 Key 与 API 主机不匹配。可 在线检测 或重新生成 Key。

Claude 报 invalid x-api-key 怎么办？ Anthropic 要求 x-api-key 头（不是 Bearer），且应请求 api.anthropic.com，不要用 OpenAI 兼容 URL。

Key 看起来正确为什么还失败？ 账户停用、项目删除、base_url 错误都会如此。用最小请求或 Key 检测工具验证。

APIMaster 用什么鉴权方式？ OpenAI 兼容：Authorization: Bearer <apimaster-key>，base_url=https://apimaster.ai/v1。