# 如何在 Cursor IDE 中使用自己的 API 密钥

Cursor Pro 每月 $20，有使用上限。使用 RunAPI 密钥则按 Token 计费——相同的 Claude 和 GPT-4o 模型，官方定价 5 折，无月费。本指南涵盖 Settings > Models 配置、Base URL 覆盖，以及如何修复常见的 'unauthorized user api key' 错误。

*Updated June 23, 2026 · RunAPI Editorial*

## 我可以在 Cursor 中使用自己的 API 密钥吗？

可以。Cursor 在所有套餐（包括免费套餐）上均支持自带密钥（BYOK）。你在 Settings > Models > OpenAI API Key 中填写 Base URL 和 API 密钥。RunAPI 提供完全兼容该字段的 OpenAI 兼容端点，让你以 Anthropic 和 OpenAI 直连价格的 50% 访问 Claude 3.5 Sonnet、GPT-4o 等模型。最常见的配置错误——'unauthorized user api key' 提示——意味着密钥格式错误或 Base URL 未填写。

- **适用于所有 Cursor 套餐**: BYOK 在 Cursor 免费套餐和 Pro 套餐上均可使用。无需有效的 Cursor Pro 订阅即可使用自己的密钥。
- **OpenAI 兼容端点**: RunAPI 使用与 OpenAI API 相同的请求/响应格式。Cursor 的 OpenAI API Key 字段无需任何代码修改即可接受它。
- **官方模型定价 5 折**: RunAPI 按提供商官方定价的一半计费。通过 RunAPI，Claude 3.5 Sonnet 输入费用为 $1.50/M tokens，而通过 Anthropic 直连则为 $3.00/M。
- **修复 'unauthorized user api key'**: 此错误表示 Cursor 拒绝了密钥格式或无法到达端点。解决方法是在 Settings > Models 中验证 Base URL 和密钥均已正确填写。

## 在 Cursor 中填写 API 密钥的位置

Cursor 将所有模型配置集中在一处。打开 Cursor，按 Cmd+Shift+J（Mac）或 Ctrl+Shift+J（Windows/Linux）打开设置，切换到 Models 标签。相关字段为 OpenAI API Key 和 OpenAI Base URL。使用 RunAPI 时必须同时填写这两个字段——Base URL 告诉 Cursor 将请求发送到 RunAPI 而非直接发送到 OpenAI，Key 则用于身份验证。

## 修复 Cursor 中的 'unauthorized user api key' 错误

Cursor 报出 'unauthorized user api key' 提示，原因之一：API 密钥错误或已过期；之二：Base URL 未设置，导致 Cursor 直接向 OpenAI 服务器验证密钥；之三：密钥格式不兼容。RunAPI 密钥以 'rp-' 开头——它不是标准的 OpenAI 密钥，若 Cursor 尝试在 openai.com 验证它，必然失败。解决方法是在填写密钥的同时始终设置 Base URL。

### 缺少 Base URL

最常见原因。若 OpenAI Base URL 为空，Cursor 会将你的 RunAPI 密钥发送到 api.openai.com，后者会拒绝。将 Base URL 设为 https://runapi.ai/v1 即可解决。

### 复制密钥时包含多余空白

粘贴密钥后检查是否有前导或尾随空格。某些终端和浏览器在复制时会添加不可见空白字符。如有疑虑，清空字段后重新粘贴。

### 密钥已过期或被撤销

RunAPI 密钥可以从控制台撤销。若你近期重新生成了密钥，旧值会返回 401 错误。请从 Dashboard > API Keys 复制新密钥。

### 模型 slug 错误

若密钥和 URL 均正确，但特定模型返回错误，则模型名称可能与 RunAPI 目录不匹配。请在 runapi.ai/pricing 核对准确的 slug，并粘贴到 Cursor 的模型字段。


## Cursor Pro 每月 $20 值得吗，还是应该用自己的密钥？

Cursor Pro 提供固定的快速模型请求月度配额。超出上限后，Cursor 会降速或暂停，直到下月重置。通过 RunAPI 自带密钥没有上限——按 Token 计费，价格为官方定价的 50%。对大多数开发者来说，盈亏平衡点约为每月 8–12 小时的高强度 AI 编码。低于此使用量，RunAPI 更划算；超过此使用量，订阅方案更可预期，但不一定更便宜。

## 如何在 Cursor 中通过 RunAPI 使用自己的 API 密钥

1. **创建免费 RunAPI 账号** — 前往 runapi.ai 注册。无需信用卡。注册后获得少量免费额度用于测试连接。
2. **复制 API 密钥和 Base URL** — 在 RunAPI 控制台，前往 API Keys 并生成一个密钥。记录页面上显示的 Base URL——它是 https://runapi.ai/v1。
3. **打开 Cursor 设置** — 在 Cursor 中，按 Cmd+Shift+J（Mac）或 Ctrl+Shift+J（Windows/Linux）打开设置，点击 Models 标签。
4. **填写 Base URL** — 滚动到 OpenAI 区域。将 https://runapi.ai/v1 粘贴到 OpenAI Base URL 字段。这是大多数教程跳过的步骤——不填此字段，Cursor 会忽略你的密钥。
5. **填写 RunAPI 密钥** — 将你的 RunAPI 密钥粘贴到 OpenAI API Key 字段。确保没有前导或尾随空白字符。若 OpenAI 区域处于关闭状态，请将其打开。
6. **选择模型并测试** — 在 Cursor 聊天栏中选择模型，如 gpt-5.4，发送一条测试消息。收到回复即确认连接正常。查看 RunAPI 控制台确认用量已记录。

## Cursor API 密钥设置常见问题

### 为什么 Cursor 显示 'unauthorized user api key'？

此错误出现在 Cursor 无法向目标端点验证密钥时。最常见的原因是 OpenAI Base URL 字段为空，导致 Cursor 将你的 RunAPI 密钥发送到 api.openai.com，后者拒绝了它。在密钥旁边将 Base URL 设为 https://runapi.ai/v1 即可解决。

### 使用自己的 API 密钥需要订阅 Cursor Pro 吗？

不需要。Cursor BYOK 在免费套餐上即可使用。你可以在 Settings > Models 中填写第三方 API 密钥，无需订阅 Cursor Pro。免费套餐对其内置模型请求有一定限制，但使用自带密钥时这些限制不适用。

### 通过 RunAPI 在 Cursor 中可以使用哪些模型？

RunAPI 目录中任何提供 chat completions 端点的模型均可使用，包括 Claude 3.5 Sonnet、Claude 3.7 Sonnet、GPT-4o、GPT-4.1、Gemini 1.5 Pro 和 Llama 3.1。将 runapi.ai/pricing 上的准确模型 slug 填入 Cursor 的模型字段即可。图像和音频模型不支持在 Cursor 聊天界面中使用。

### RunAPI 比 Cursor Pro 便宜吗？

轻度到中度使用时，是的。Cursor Pro 每月 $20，适合希望固定费用的开发者。RunAPI 按 Token 计费，为提供商官方定价的 50%——Claude 3.5 Sonnet 输入 $1.50/M tokens。重度用户若在 Pro 上限内使用，订阅方案更可预期，但使用 RunAPI 不会遭到限速。

### 我可以在 Windsurf 和 Claude Code 中使用同一个 RunAPI 密钥吗？

可以。一个 RunAPI 密钥适用于 Cursor、Windsurf、Claude Code、Codex 及任何接受自定义 OpenAI 兼容端点的工具。用量和消费在同一个 RunAPI 控制台中统一查看，无需为每个工具管理独立的密钥或余额。

### 我在 Cursor 中需要填写的 OpenAI Base URL 是什么？

设置为 https://runapi.ai/v1。当 OpenAI 区域处于启用状态时，Cursor 会将所有模型请求发送到此 URL。若未填写此字段，Cursor 会将请求发送到 api.openai.com，后者会拒绝 RunAPI 密钥并每次返回未授权错误。

### 在 Cursor 中使用 BYOK 会禁用 Cursor 的内置功能吗？

不会。Cursor 的自动补全、差异视图和 Agent 功能继续正常工作。BYOK 仅改变 Cursor 用于聊天和内联补全的模型和端点。若你设置了 Cursor 界面默认列表之外的模型，请直接在模型选择器中输入 slug。

### 如何确认我的 RunAPI 密钥在 Cursor 中正常工作？

在 Cursor 聊天中发送一条短消息，然后在 RunAPI 控制台的 Usage 页面查看。每次请求后几秒内即可看到包含模型名称、Token 数量和费用的新日志条目。若没有条目出现，说明 Base URL 或密钥未到达 RunAPI。