Cursor AI API 密钥：自定义密钥放哪里

简短回答

Cursor 系列的编辑器需要三个值才能与自定义提供商通信：基础 URL、API 密钥和模型名称。对于此服务，它们是：

• 基础 URL：https://api.cursoraiapikey.com/v1
• API 密钥：来自 API 密钥页面 的密钥
• 模型名称：uncensored

打开编辑器设置并找到模型部分。Cursor 提供了 OpenAI API 密钥的字段和覆盖 OpenAI 基础 URL 的选项，但菜单标签在不同版本之间会移动，因此如果你找不到它们，请在设置中搜索“基础 URL”。粘贴 URL 和密钥，添加一个名为 uncensored 的自定义模型，然后如果你的版本有验证按钮，请使用它。

此服务独立于 Cursor。它是一个单独的托管 API，不会替换编辑器自己的账户或计划。你只是将编辑器的聊天指向不同的 OpenAI 兼容服务器。

两种密钥，两个不同的位置

人们用同一个词指代两个不相关的事物，混淆它们是设置失败的最常见原因。

账户登录

编辑器有自己的登录。这向编辑器供应商标识你，与模型提供商无关。你不会将提供商密钥粘贴到登录界面。

提供商密钥

这是由运行模型的公司的秘密字符串。你将其与基础 URL 一起粘贴到模型设置中，编辑器会在每次请求时在 Authorization: Bearer 标头中发送它。此服务的密钥仅在此服务的基础 URL 下有效，来自其他提供商的密钥在此处无效。

如果你来这里是为了寻找免费获取编辑器自己的密钥的方法，并非如此。如果你想要编辑器聊天面板后面的廉价文本模型，请继续阅读。该模式适用于任何接受 OpenAI 兼容接口的编辑器，替换 Claude 密钥的文章涵盖了 Anthropic 风格设置的平行情况。

在修改编辑器之前测试接口

编辑器外的两分钟测试可以告诉你问题是密钥还是编辑器。创建账户，在密钥页面领取试用，然后运行：

Copycurl https://api.cursoraiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the word ok."}]
  }'

你应该得到一个带有 choices 数组的 JSON 主体。响应头包括 X-Balance-USD，显示你剩余的余额。使用官方 SDK 在 Python 中的相同调用：

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.cursoraiapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the word ok."}],
)
print(reply.choices[0].message.content)

如果两个调用都有效，则密钥正常，任何后续错误都来自编辑器设置。

编辑器中的逐步操作

1. 使用 Google 或电子邮件和密码注册，然后在 API 密钥页面 领取 $0.50 试用额度。它不需要信用卡，有效期为 7 天。
2. 复制密钥。像对待密码一样对待它。
3. 在编辑器中，打开设置并进入模型部分。名称因版本而异，因此将此列表中的标签视为指南。
4. 将密钥粘贴到 OpenAI API 密钥字段中。
5. 打开覆盖 OpenAI 基础 URL 的选项，并输入 https://api.cursoraiapikey.com/v1。保留 /v1，不要添加 /chat/completions；客户端会添加其余部分。
6. 添加一个名称完全为 uncensored 的自定义模型。
7. 在聊天面板中选择该模型并发送一条短消息。

如果你的版本提供验证步骤且失败，但 curl 有效，请检查密钥末尾是否没有尾随空格，以及基础 URL 末尾没有第二个 /v1。

哪些功能会使用你的密钥，哪些不会

设置自定义接口不一定改变所有功能。编辑器通常在一些功能（如内联补全或应用差异）上使用厂商自己托管的模型，这些功能可能会忽略你的密钥。聊天和代理式请求通常是发送到你配置的接口的请求。编辑器的文档是你版本的权威，因此在针对特定功能进行规划之前，请检查它。

另外两件值得检查的事情：

• 请求地址。根据版本不同，请求在到达您的接口之前，可能会经过编辑器供应商运营的服务器。在这种情况下，您本地电脑的 base URL 将无法使用，而此类公开 URL 则可以。请阅读编辑器的隐私说明，了解其存储的内容。
• 模型范围。该服务运行一个开放权重模型，经过调优，可在合法成人用途下无内容拒绝地生成回答。它仅支持文本，不生成图像、音频或 Embeddings，因此需要这些功能的功能将无法通过它使用。

上下文窗口为 100,000 个 token，用于提示词和补全，这对于大多数单文件工作和许多多文件任务来说已经足够了。非常大的存储库转储将不适合。

修复常见错误

症状	可能原因	修复方法
401 未授权	密钥错误或已撤销，多余空格，密钥粘贴到错误的字段	在密钥页面重新生成密钥并再次粘贴。旧密钥立即失效。
404 未找到	基础 URL 缺少 /v1，或 /v1/v1 重复	使用精确的 https://api.cursoraiapikey.com/v1。
未找到模型	自定义模型名称输入不同	名称是 uncensored，全部小写。
429 错误对应 concurrency 限制	并发请求过多；试用密钥允许 2 个并发请求	等待正在进行的请求完成，或升级为完整密钥，其允许 8 个并发请求。
429 带有rate_limited	超过每分钟速率限制；试用密钥为 60，完整密钥为 300	放慢速度；代理循环可能会突发。
429 且 Retry-After: 5	临时过载	五秒后重试。

代理模式可以同时触发多个请求，而流式响应会保留其连接槽位，直到流结束。对于试用密钥来说，很容易达到并发限制。这是正常现象，并非密钥故障。

请求成本

计费方式为按量付费：输入 token 每 1M 个 $0.15，输出 token 每 1M 个 $0.50，从预付额度中扣除。失败或被拒绝的请求不收费。编辑器中的一次典型聊天轮次会发送打开的文件和一些历史记录，例如 20,000 个输入 token，并获取 1,500 个输出 token：

• 输入：20,000 x $0.15 / 1,000,000 = $0.0030
• 输出：1,500 x $0.50 / 1,000,000 = $0.00075
• 总计：$0.00375，略低于半美分

因此，$0.50 的试用额度可覆盖约 133 轮该规模的对话。这足以进行一下午的真实测试。当你决定继续使用时，充值金额从 $20 到 $500 不等，且整额充值享有额外奖励：$50 起赠 5%，$100 起赠 10%，$200 起赠 15%，以加密货币（TRC20 上的 USDT 或 Base 上的 USDC）支付。额度永不过期。定价页面包含完整表格，文档列出了所有支持的参数。

更多指南

• Cursor AI 定价与 API：订阅制还是按 Token 计费
• 用于无审查用途的 Claude API 密钥替代方案