如何使用 Cursor API 密钥配合自定义接口
以下是使用自定义接口配置 Cursor 的方法:粘贴密钥,覆盖 OpenAI Base URL,并添加模型名称 uncensored。以下步骤约需五分钟,并包含可先运行的 curl 检查。
更新于

要点
- Cursor 允许你覆盖 OpenAI Base URL 和密钥,因此任何 OpenAI 兼容接口均可处理请求。
- 使用 Base URL https://api.cursorapikey.com/v1 和模型 ID
uncensored。 - 在修改编辑器前先用 curl 测试密钥,以便确定故障来源。
- 20,000 token 的提示词加上 1,000 token 的回答成本为 $0.0035。
本指南涵盖内容
搜索“如何使用 cursor api”的人通常指两种情况。要么是想从代码中调用某些 Cursor 服务,要么是想让 Cursor 编辑器将模型请求发送到自定义接口。本指南针对第二种情况。本站是一个独立托管的 API,支持 OpenAI 聊天补全协议,因此 Cursor 可以像连接任何 OpenAI 风格服务器一样连接本站。
后端是一个独立的开放权重模型,由独立提供商运行,针对合法成人用途进行了无内容拒绝优化。它不是官方的 Cursor 模型,也不是跨供应商的路由器。仅支持文本。对于编码通常已足够:你发送代码和指令,获取代码和解释。
你需要三样东西:API 密钥、Base URL https://api.cursorapikey.com/v1 和模型 ID uncensored。其余只需在编辑器中找到相应字段即可。
步骤 1:获取密钥并使用 curl 检查
使用 Google 或邮箱密码注册,然后打开 API 密钥页面。新账户可一键领取 $0.50 免费试用额度。无需信用卡,有效期 7 天。试用密钥限制为 2 个并发请求和每分钟 60 个请求,足以满足编辑器中的首次使用。
打开 Cursor 前,请确认密钥有效。在终端中运行以下命令,将密钥放入环境变量:
export API_KEY="paste-your-key-here"
curl https://api.cursorapikey.com/v1/models \
-H "Authorization: Bearer $API_KEY"
curl https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write a Python function that reverses a linked list."}
]
}'
第一次调用列出模型。第二次返回正常的聊天补全。如果两者都成功,后续编辑器中的故障是设置问题而非密钥问题。这种区分能省去大量猜测。
步骤 2:在 Cursor 中设置 Base URL 和密钥
打开 Cursor 设置并进入模型部分。菜单名称和布局在不同版本中可能变化,因此将以下标签视为地图,如果位置有变请查阅 Cursor 官方文档。
- 找到 OpenAI API 密钥字段,粘贴本站提供的密钥。
- 启用覆盖 OpenAI Base URL 选项,输入
https://api.cursorapikey.com/v1。保留末尾的/v1,不要添加/chat/completions;客户端会自动追加路径。 - 添加自定义模型,精确输入
uncensored,全小写。 - 如果编辑器提供验证或保存按钮,请使用它们,然后在聊天面板中选择新模型。
发送简短消息如“解释此函数”并打开文件。流式输出意味着端到端路由正常。Cursor 发送请求,接口通过 SSE 流式输出 token,编辑器随到达渲染它们。
两个注意事项。某些编辑器功能(如内联 Tab 补全)可能在 Cursor 控制的模型上运行并忽略你的密钥,因此请检查哪些功能实际使用了自定义模型。此外,由于 Cursor 可能通过其服务器路由自定义密钥流量,如需确切了解代码传输路径,请阅读其当前文档。本站的 快速入门列出了 API 侧的协议。
从代码测试同一接口
隔离问题的最简单方法是使用官方 OpenAI SDK 调用接口。如果有效,则接口正常,剩余问题出在编辑器配置中。
from openai import OpenAI
client = OpenAI(
api_key="paste-your-key-here",
base_url="https://api.cursorapikey.com/v1",
)
stream = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a terse senior engineer."},
{"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n if x > 0:\n out.append(x * 2)"},
],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
Node.js 中的相同操作:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: "https://api.cursorapikey.com/v1",
});
const res = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});
console.log(res.choices[0].message.content);
流式输出响应在末尾包含使用情况,因此你可以精确记录每个请求使用了多少 token。每个响应还带有 X-Balance-USD 头,显示你的剩余额度,以及一个 X-Request-Id,如果出现问题你可以引用它。
编码工作流中的可用功能
API 支持流式输出、JSON 模式和函数调用(tools、tool_choice、流式输出的 tool_calls,以及以 role: "tool" 形式返回的结果)。采样设置如 temperature、top_p、stop、seed 以及惩罚项都会透传。上下文窗口为 100,000 token,在提示词和补全之间共享,max_tokens 是可选的。
100,000 token 对于代码来说是充裕的预算。几百行的源文件仅几千 token,因此你可以包含多个文件加上长指令,并为回答留出空间。最大请求体为 8 MB,文本不会达到此限制。
让自定义模型在编辑器中更愉快的习惯:
- 代码编辑时保持较低的
temperature。0.2 左右的值能提供更稳定的输出;仅在头脑风暴时提高它。 - 仅附加必要的文件。你发送的每个 token 都作为输入计费,且每轮对话都会重新发送整个对话。
- 文件较长时,请求 diff 或更改的函数,而非整个文件。输出 token 比输入 token 更贵。
- 在拒绝回答会妨碍工作的任务中使用该模型,例如为自有实验室编写漏洞概念验证、分析你获权研究的恶意软件样本,或生成模仿真实令人不适的内容的测试数据。所有用途必须合法。
一个值得重复的硬性限制:任何情况下均禁止涉及未成年人的色情内容。
修复常见错误
| 症状 | 可能原因 | 修复方法 |
|---|---|---|
| 401 或“无效密钥” | 密钥粘贴时带有空格,或使用了旧密钥 | 从密钥页面重新复制;使用 curl 测试 |
| 404 或“模型未找到” | 模型名称拼写不同 | 使用 uncensored,小写,无后缀 |
| 路径 404 | Base URL 包含 /chat/completions | Base URL 以 /v1 结尾 |
429 错误对应 concurrency 限制 | 同时请求过多 | 等待流式输出完成;完整密钥允许 8 个并发,试用密钥允许 2 个 |
429 带有rate_limited | 每分钟超过 300 个请求(试用期间为 60 个) | 放慢速度,或暂停后重试 |
429 且 Retry-After: 5 | 临时过载 | 五秒后重试 |
流式请求会占用并发槽位,直到流式输出结束。如果你在 Cursor 中同时开始多个对话并让它们生成,试用密钥的并发限制会很快达到。失败或被拒绝的请求不会收费,因此重试不会产生额外费用。
编码会话的成本
定价为每 100 万输入 token $0.15,每 100 万输出 token $0.50,从预付额度中扣除,无订阅费。典型的编辑请求包含大量提示词(你的文件)和简短的输出。以 20,000 个输入 token 和 1,000 个输出 token 为例:
- 输入:20,000 x $0.15 / 1,000,000 = $0.0030
- 输出:1,000 x $0.50 / 1,000,000 = $0.0005
- 总计:每次请求 $0.0035
工作日中 100 个请求的费用为 $0.35。$0.50 的试用额度大约可覆盖 140 次此类请求。试用结束后,你可以充值 $20 至 $500 之间的任意整数金额,充值 $50 及以上赠送 5% 额度,$100 及以上赠送 10%,$200 及以上赠送 15%。支持使用加密货币(TRC20 链上的 USDT、Base 链上的 USDC)支付。额度永不过期,因此慢慢消耗的充值不会浪费。定价页面有完整表格,Cursor 和 Copilot 替代方案页面解释了该产品在订阅编辑器中的定位。
提示词不用于训练。
更多指南
问答
这是否与 Cursor 代理和函数调用兼容?
API 支持使用工具、tool_choice 和流式输出的 tool_calls 进行函数调用。特定的 Cursor 功能是否使用你的自定义模型取决于编辑器,因此请在设置后测试每个功能。
我应该输入哪个模型名称?
输入 uncensored(小写)。这是唯一的模型 ID,GET /v1/models 会列出它。
这是官方的 Cursor API 吗?
不是。这是一个位于单一开放权重模型之前的独立 OpenAI 兼容 API。Cursor 只是让你将其 OpenAI 设置指向不同的接口。
试用需要银行卡吗?
不需要。$0.50 的试用额度在注册后于 API 密钥页面一键领取,无需银行卡,有效期为 7 天。