现象
- HTTP 状态码 401 Unauthorized
- 响应中常见
invalid_api_key、Incorrect API key或类似描述
常见原因
- 未传
Authorization头 - Key 写错、复制不完整或含多余空格
- 使用了已 删除 / 禁用 的令牌
- 把 Key 放在了错误位置（应使用 Header，而非 query）
处理步骤
1
检查请求头
必须为：注意
Bearer 与 Key 之间有一个空格。2
在控制台核对令牌
登录控制台 → 令牌 → 确认该 Key 状态为可用。必要时新建 Key 再试。
3
排除环境变量覆盖
确认 SDK 未读取到旧的
OPENAI_API_KEY，导致与预期 Key 不一致。4
重试最小请求
使用 快速开始 中的 curl 命令，仅替换 Key 与
model。原生 SDK 或特殊路径
若使用 Anthropic、Gemini 或其他原生 SDK，可能要求x-api-key、anthropic-version 等头字段。优先先用 快速开始 的 OpenAI 兼容请求验证 Key 可用，再切换到对应 模型能力 的特殊调用方式。
仍无法解决？
收集以下信息后联系支持：- 请求时间（UTC+8）
- 使用的
model（可脱敏） - 响应 body（勿包含完整 Key）