401 invalid_api_key 怎么解决?API Key 与 Base URL 排查

直接答案:先确认 API Key 和 Base URL 属于同一个服务。API 快连的 sk-... 必须配合 https://api.apikl.ai/v1 使用;如果请求仍发往官方 OpenAI 地址,就会返回 401 invalid_api_key

⚠️
最常见原因:Key 是 API 快连的,但 Base URL 还是 https://api.openai.com/v1。官方 OpenAI 不认识 API 快连的 Key,所以会返回 invalid_api_key

第一步:先看请求地址

把客户端配置改成下面这组。OpenAI 兼容客户端要同时填 Base URL 和 API Key,只换 Key 不够。

正确配置
Base URL : https://api.apikl.ai/v1API Key : sk-你的密钥
常见错误
Base URL : https://api.openai.com/v1API Key : sk-API快连的密钥

第二步:确认客户端真的使用了新配置

  • Codex CLI:部分版本可能不读取 OPENAI_BASE_URL,建议使用本文档的 config.toml 自定义服务商方式。
  • Codex Desktop:改完配置后彻底退出再打开,避免旧配置仍在内存里。
  • CC Switch:确认当前启用的是 API 快连供应商,不是官方 OpenAI 供应商。
  • Cline / Roo Code:Provider 要选 OpenAI Compatible,不要选 OpenAI 官方登录方式。

第三步:用 curl 快速自测

如果你不确定是客户端问题还是 Key 问题,可以用最小请求验证:

BASH
curl https://api.apikl.ai/v1/chat/completions \ -H "Authorization: Bearer sk-你的密钥" \ -H "Content-Type: application/json" \ -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hi"}]}'

curl 能返回模型内容,说明 Key 和服务端没问题,重点回到客户端配置;curl 也 401,则去控制台重新创建一把 Key,或者检查是否复制少了字符。

排查顺序:先确认 Base URL,再确认 Key,再确认客户端当前启用的服务商。大多数 invalid_api_key 都能在这三步内解决。