API 报 invalid_api_key 怎么办？Key 错误还是 Base URL 配错？
第一步：看报错 URL 指向哪里
- URL 是
api.openai.com→ Base URL 没生效，改客户端配置 - URL 是
api1.link-ai.cc或api2.link-ai.cc→ Key 本身无效，重新生成 Key
第二步：根据原因处理
- Base URL 没生效 → 修改客户端 config.toml 或设置页
- Key 本身无效 → 在控制台重新生成 Key
invalid_api_key 的本质是什么？
invalid_api_key 的含义是：「这个 Key 在这个 Base URL 上无效」。但这个错误有两个截然不同的原因：
- Key 本身的问题：Key 无效、过期、被撤销、没有权限
- Base URL 的问题：客户端没有读取自定义 Base URL，仍然在请求 OpenAI 官方地址
最关键的判断依据是看报错里的 URL。
URL 指向哪里，决定处理方向
| 报错 URL | 问题原因 | 解决方式 |
|---|---|---|
api.openai.com |
Base URL 没生效 客户端仍在请求 OpenAI 官方 |
修改客户端的 config.toml 或设置，确保 openai_base_url 正确 |
api1.link-ai.cc或 api2.link-ai.cc |
Key 本身无效 Key 过期、被撤销或无权限 |
在控制台重新生成 Key |
| 其他陌生地址 | 填错了 Base URL | 确认中转站地址，重新填写 |
各客户端如何排查
Codex CLI
检查 ~/.codex/config.toml 是否存在、路径是否正确：
model = "gpt-5.5" openai_base_url = "https://api2.link-ai.cc/v1"
如果 URL 仍是 api.openai.com，说明配置文件没有生效。
Cursor
检查 Settings → Models 中的 Base URL 是否正确：
Base URL: https://api2.link-ai.cc/v1 API Key: sk-你的key
Claude Code
检查环境变量是否设置正确：
export ANTHROPIC_BASE_URL="https://api2.link-ai.cc" export ANTHROPIC_AUTH_TOKEN="sk-你的key"
LobeChat / NextChat / Continue
检查设置页面的 Base URL 和 Key 是否正确，Key 不要含前后空格。
还没有 Key？ 在 Link-AI 控制台创建 API Key →
Key 本身无效的其他原因
- Key 过期：部分 Key 有有效期，超期后无法使用
- Key 被撤销：在控制台撤销后旧 Key 即失效
- Key 没有目标模型权限：令牌绑定的渠道没有该模型
- 渠道余额不足：部分站点余额耗尽后即使 Key 有效也会报错
- Key 格式被截断：Key 包含空格或换行符被截断
和 Link-AI 有什么关系？
Link-AI 是 OpenAI-compatible API gateway，面向开发者提供 Claude、GPT 等模型接入服务。
- 在 api1.link-ai.cc 控制台 → API Keys 可以创建、查看和撤销 Key
- 如果 Key 失效，重新生成一个即可，老 Key 会被自动撤销
- 如果担心扣费异常，使用 API 扣费检测工具
常见问题
说明客户端没有读取自定义 Base URL，仍然在请求 OpenAI 官方地址。这是 Base URL 配置问题，不是 Key 本身的问题。
看报错里的 URL。如果 URL 是 api.openai.com 或其他陌生地址，说明没走中转站，是 Base URL 没生效。如果 URL 是 Link-AI 地址但仍报错，则是 Key 本身的问题。
检查 ~/.codex/config.toml 是否存在、路径是否正确、openai_base_url 是否包含 /v1 后缀。如果 URL 仍是 api.openai.com，说明配置没生效。
检查 Base URL 是否正确填入（不要带多余空格），检查 Key 是否包含前后空格或特殊字符，检查是否填入了错误的 Key。
在 api1.link-ai.cc 控制台 → API Keys → 重新生成一个新的 Key，老 Key 会被撤销。
可能原因：Key 过期、Key 被撤销、Key 没有目标模型权限、渠道余额不足、Key 格式被截断（如含空格或换行符）。