缺少 Base URL
最常见原因。若 OpenAI Base URL 为空，Cursor 会将你的 RunAPI 密钥发送到 api.openai.com，后者会拒绝。将 Base URL 设为 https://runapi.ai/v1 即可解决。
设置指南
如何在 Cursor IDE 中使用自己的 API 密钥
Cursor Pro 每月 $20，有使用上限。使用 RunAPI 密钥则按 Token 计费——相同的 Claude 和 GPT-4o 模型，官方定价 5 折，无月费。本指南涵盖 Settings > Models 配置、Base URL 覆盖，以及如何修复常见的 'unauthorized user api key' 错误。
更新于 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。
复制密钥时包含多余空白
粘贴密钥后检查是否有前导或尾随空格。某些终端和浏览器在复制时会添加不可见空白字符。如有疑虑，清空字段后重新粘贴。
密钥已过期或被撤销
RunAPI 密钥可以从控制台撤销。若你近期重新生成了密钥，旧值会返回 401 错误。请从 Dashboard > API Keys 复制新密钥。
模型 slug 错误
若密钥和 URL 均正确，但特定模型返回错误，则模型名称可能与 RunAPI 目录不匹配。请在 runapi.ai/pricing 核对准确的 slug，并粘贴到 Cursor 的模型字段。
Cursor Pro vs RunAPI BYOK
Cursor Pro 每月 $20 值得吗，还是应该用自己的密钥？
Cursor Pro 提供固定的快速模型请求月度配额。超出上限后，Cursor 会降速或暂停，直到下月重置。通过 RunAPI 自带密钥没有上限——按 Token 计费，价格为官方定价的 50%。对大多数开发者来说，盈亏平衡点约为每月 8–12 小时的高强度 AI 编码。低于此使用量，RunAPI 更划算；超过此使用量，订阅方案更可预期，但不一定更便宜。
快速上手
如何在 Cursor 中配置自己的 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。
相关内容
继续探索
立即开始使用自己的 API 密钥在 Cursor 中编码
RunAPI 为你提供与 OpenAI 兼容的 API 密钥，可访问 Claude、GPT-4o、Gemini 等模型，价格为官方定价的 50%。不到两分钟即可粘贴到 Cursor，只为实际使用量付费。