疑难排查 · 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 working
  • cursor 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 添加为自定义模型。

跳过折腾坏掉的配置

apiToken.sale 通过 OpenAI 兼容端点、Messages(Anthropic 格式)端点和原生 Gemini 端点提供 GPT 与 Gemini 模型——标准 SDK、一把密钥、一个预付余额。把你工具的 base URL 指向它,本页的配置即可原样生效。