疑难排查 · Cursor
Cursor 使用自定义 base URL 时提示 Invalid API Key——验证失败的原因
当密钥和 base URL 不配套,或覆盖字段仍指向默认 OpenAI 端点时,Cursor 会在验证时拒绝 API 密钥。修复它的检查清单。
你看到的报错
Invalid API key为什么会发生
- 密钥属于自定义端点,但 "Override OpenAI Base URL" 未开启或为空,所以 Cursor 拿默认的 api.openai.com 来验证密钥——而那里从没见过它。
- base URL 已设置,但密钥粘贴时带了空白、缺了前缀,或者干脆是另一家提供商格式的密钥。
- 密钥已被吊销或已过期。
- 覆盖 URL 缺少 /v1 或多了路径段,验证请求被发到端点不提供服务的 URL。
如何解决
- 先开启 OpenAI base URL 覆盖并填写 https://router.apitoken.sale/v1,再粘贴密钥——验证针对的是当时生效的 URL。
- 粘贴密钥时去掉首尾空白,并核对前缀与控制台显示的一致。
- 在签发方的控制台确认密钥处于启用状态,然后在 Cursor 中重新验证。
能通过本网关验证的 Cursor 设置
Cursor Settings → Models → OpenAI API Key
API Key: sk-pool-•••
Override OpenAI Base URL: https://router.apitoken.sale/v1
Model: gpt-6.1-terra相关搜索
cursor openai api key not workingcursor verify api key failed
常见问题
为什么密钥在 curl 里能用,Cursor 却说它无效?+
Cursor 用当时配置的 base URL 来验证。如果覆盖项没开启,验证会打到 api.openai.com,它会拒绝网关密钥。先设好覆盖项,再验证。
在 Cursor 里用自定义密钥调用 GPT 模型,需要 OpenAI 账号吗?+
不需要。OpenAI 提供商字段接受任何 OpenAI 兼容端点:把覆盖 URL 设为签发方地址,并粘贴该签发方的密钥。
密钥验证通过后能用哪些模型?+
覆盖地址背后端点所提供的 GPT 和 Gemini 模型。用同一个 base URL 和密钥请求 GET /v1/models 列出它们,并把 ID 添加为自定义模型。
全部 Cursor 错误 · API 错误码 · 配置指南