在 Cursor 中使用 DeepSeek API:自定义 Base URL 设置 Base URL 设置
Cursor 可以连接任何 OpenAI 兼容的接口,因此你可以通过覆盖 base URL 并添加自定义 Base URL 设置模型名称来使用托管的 DeepSeek 风格 API。本指南展示了需要填写的确切字段及测试方法。

要点
- Cursor 的模型设置接受自定义 Base URL 设置 OpenAI base URL、API 密钥和自定义 Base URL 设置模型名称。
- 使用 base URL https://api.deepseekapi.top/v1 和模型 ID uncensored。
- 先用 curl 测试密钥,这样你就知道任何故障都来自 Cursor 而非密钥。
- 费用为按量付费:每 1M 输入 token $0.15,每 1M 输出 token $0.50。
简短回答
如果你想了解如何在 Cursor 中使用 deepseek api,流程对于任何 OpenAI 兼容的提供商都是相同的。你打开 Cursor 的模型设置,将 API 密钥粘贴到 OpenAI 密钥字段,覆盖 OpenAI base URL,并添加一个 Cursor 未知的模型名称。然后在聊天中选择该模型。
开始之前澄清一点。本站不是官方 DeepSeek API。这是一个托管的 OpenAI 兼容文本 API,运行一个开放权重模型,由独立提供商运营,针对合法成人用途进行了无内容拒绝的调优。模型 ID 为 uncensored。如果你需要官方 DeepSeek 服务,请使用厂商自己的接口和密钥。Cursor 中的设置看起来完全相同:只有这三个值会改变。
| Cursor 字段 | 说明 |
|---|---|
| OpenAI API 密钥 | 来自 API 密钥页面 的密钥 |
| 覆盖 OpenAI Base URL | https://api.deepseekapi.top/v1 |
| 自定义 Base URL 设置模型名称 | uncensored |
打开 Cursor 之前:获取并测试密钥
支持 Google 或邮箱密码登录。登录后,API 密钥页面有一个一键按钮,可添加 $0.50 免费试用额度。有效期 7 天,无需银行卡,每人限领一次。这足以解决几百个简短的编程问题,让你在付费前完成全部设置。密钥页面将引导你完成步骤。
现在在 Cursor 之外测试密钥。Cursor 的错误消息很短,密钥中的拼写错误看起来与错误的 URL 相同。在终端中运行此命令:
curl https://api.deepseekapi.top/v1/chat/completions -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" -d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
}'
你应该在 choices[0].message.content 中收到包含函数的 JSON 回复。你也可以使用 GET /v1/models 列出模型,这是确认密钥被接受的好方法。如果这有效,说明接口端已完成,剩下的就是 Cursor 配置。
逐步配置 Cursor
- 打开 Cursor 设置并进入模型部分。在大多数版本中,你可以通过齿轮图标然后选择模型来访问。
- 找到你的 OpenAI API 密钥字段并粘贴密钥。Cursor 可能会要求你验证它。使用自定义 Base URL 设置接口时,验证可能会失败,因为 Cursor 会将其密钥与其自身的模型列表进行比对。如果是这种情况,请继续下一步,并根据聊天是否正常工作来判断。
- 开启覆盖 OpenAI base URL 的选项,并输入
https://api.deepseekapi.top/v1。末尾必须包含/v1。不要添加/chat/completions;客户端会自动追加该路径。 - 使用添加模型控件,精确输入小写的
uncensored。在模型列表中启用它。 - 打开聊天面板,在模型选择器中选择
uncensored,并发送简短的提示词。
Cursor 不同版本中的菜单名称可能不同,如果标签与上述不同,请寻找相同的三个要素:密钥、base URL、自定义 Base URL 设置模型。Cursor 的官方文档是查看当前名称的最佳位置。
一个需要关注的设置
Cursor 仅保留一个 OpenAI base URL 覆盖设置。开启后,你在 Cursor 中使用的所有 OpenAI 命名模型都会指向新地址。如果你还想为其他用途使用不同的 OpenAI 兼容服务,请关闭覆盖设置,或使用单独的配置文件。
自定义 Base URL 设置接口支持的功能
自定义 Base URL 设置密钥用于调用聊天模型的功能:聊天面板和行内编辑。这些功能发送标准的聊天补全请求,这正是该 API 接受的。服务支持通过 SSE 进行流式输出,因此响应会像其他提供商一样,在聊天面板中逐 token 显示。
某些 Cursor 功能依赖于 Cursor 自身的模型和服务器,例如标签自动补全。这些功能不会切换到你的密钥。此外,请求在到达你的接口之前可能会经过 Cursor 的后端,因此如果你关心服务器位置或日志记录,请查阅其文档。在我们这边,提示词不用于训练。
代理类功能依赖于函数调用。API 支持使用 tools、tool_choice 和流式 tool_calls 进行函数调用,结果以 role: "tool" 返回。特定 Cursor 模式在自定义 Base URL 设置模型下是否使用该路径可能因版本而异,因此将其视为在小任务上测试的内容,然后再围绕它构建工作流。
上下文窗口为 100,000 个 token,包括提示词和补全。这对于同时处理多个文件来说已经足够大,但由 Cursor 决定附加什么,而大的附件会在每条消息中消耗输入 token。
编辑器中效果良好的提示词
编辑器中的聊天模型的价值取决于你提供给它的上下文。一些习惯可以显著改善任何位于自定义 Base URL 设置接口后的模型的表现。
- 只附加重要的文件。 每个附加文件在每一轮都是输入 token。两个相关文件在质量和成本上都优于十个松散相关的文件。
- 说明任务和约束。 "重写此函数以避免递归,保持签名" 比 "让它更好" 更有效。
- 要求提供补丁大小的回答。 如果你想要小改动,请明确说明。否则模型可能会重写整个文件,而你需要为输出的 token 付费。
- 每个任务开始新的聊天。 旧的轮次会被重新发送。干净的聊天是最便宜的上下文修剪方式。
该模型针对合法成人用途进行了无内容拒绝的调优,因此与安全性相关的编程问题(例如已知漏洞类在你自己代码中的工作原理)往往会得到直接回答而不是警告。它像任何语言模型一样会犯错。在提交任何内容之前,请阅读它提供的代码并运行测试。
如果长回答停滞,请查看下面的限制部分。试用密钥上同时流式传输两个编辑器窗口将填满两个并发槽位,第三个请求将等待或返回 429。
编辑器中的费用
价格为每 1M 输入 token $0.15,每 1M 输出 token $0.50,从预付额度中扣除。没有订阅,失败或被拒绝的请求不收费,且额度永不过期。
编辑器中的典型聊天轮次包含大量输入(你附加的文件加上历史记录)和简短的回答。假设 6,000 个输入 token 和 700 个输出 token:
- 输入:6,000 × $0.15 / 1,000,000 = $0.0009
- 输出:700 × $0.50 / 1,000,000 = $0.00035
- 总计:每轮 $0.00125
在该规模下,100 轮对话花费 $0.125。400 轮的一个长工作日花费 $0.50。随着对话变长,输入占据账单的大部分,因为 Cursor 会重发历史记录。切换任务时开始新聊天是保持该数字最低的最简单方法。
当试用额度用完时,充值金额可以是 $20 到 $500 之间的任意整数金额,从 $50 起有 +5% 的奖励,从 $100 起有 +10% 的奖励,从 $200 起有 +15% 的奖励。你可以使用银行卡(Visa、Mastercard、Apple Pay、Google Pay)或加密货币(TRC20 上的 USDT、Base 上的 USDC)支付。详细信息见 定价页面。
故障排除
401 或密钥无效
密钥粘贴时带有尾随空格,或者它属于不同的网站。使用相同的字符串重新运行 curl 测试。如果 curl 有效但 Cursor 无效,请再次粘贴密钥。
404 或找不到模型
通常base URL 缺少 /v1 或在末尾有多余的路径。模型名称必须精确为 uncensored。
429 响应
完整密钥允许 8 个并发请求和每分钟 300 个请求。试用密钥允许 2 个并发请求和每分钟 60 个请求。错误代码 rate_limited 表示每分钟请求过多,concurrency 表示同时请求过多。在临时过载时,你还会收到带有 Retry-After: 5 的 429 错误。流式输出会占用其槽位直到流结束,因此多个编辑器窗口同时流式输出可能会在试用密钥上达到并发限制。
模型拒绝回答或偏离主题
该模型经过调整以避免对合法成人使用的内容拒绝,但它仍然是一个语言模型,遵循你的提示词。给它清晰的系统指令和精确任务。硬性限制是,涉及未成年人的性内容永远不允许。
快速入门文档列出了每次响应返回的标头,包括 X-Request-Id,联系技术支持时引用该标头很有用。
更多指南
问答
这是 DeepSeek 的官方 API 吗?
不是。这是一个独立的 OpenAI 兼容服务,运行一个 ID 为 uncensored 的开放权重模型。它不是 DeepSeek 或任何其他供应商的官方 API。
在 Cursor 中试用是否需要银行卡?
不需要。新用户可以在登录后通过 API 密钥页面上的一键按钮领取 $0.50 免费试用额度。有效期 7 天,无需银行卡。
为什么 Cursor 说密钥无法验证?
Cursor 的验证步骤可能会检查其自身的模型列表。使用 curl 测试该密钥,如果测试通过,请尝试在选中自定义 Base URL 设置模型的情况下发送聊天消息。
我可以在 Cursor 中使用函数调用和 JSON 模式吗?
API 支持这两项功能,但 Cursor 功能是否将它们发送到自定义 Base URL 设置模型取决于 Cursor 版本。建议先在小任务上测试。