游乐游手机版
首页/AI热点日报/热点详情

Cursor配置自定义模型API的详细教程

类型:热点整理2026-07-31
在CursorPro版本中,用户手动添加自定义模型的具体操作步骤如下:首先在设置界面的Models选项卡中正确配置API密钥、以 v1结尾的基础URL以及准确的模型ID,接着添加并启用该模型,最后验证通过后即可正常使用该模型。

先给出明确结论:若想在 Cursor 中使用自己申请的模型 API(例如 DeepSeek、Claude 或第三方中转服务),必须手动添加自定义模型,并且三个核心参数——API Key、Base URL 和 Model ID——缺一不可。

Cursor如何添加自己的模型API?

这项操作本身并不复杂,但初次尝试时往往会在某个细节上卡住。下面直接拆解完整流程,助你快速完成 Cursor 自定义模型配置。

进入模型设置页面

点击右上角的齿轮图标,随后选择 Models 选项卡。这里有一个前提条件——必须使用 Cursor Pro 版本,免费版无法启用第三方 API,这一步如果搞不定,后续所有配置都将无效。

填写 API Key 和 Base URL

向下滚动页面,找到 OpenAI API Key 输入框,将从平台获取的密钥(格式通常为 sk-xxxxxxxx)粘贴进去。

Override OpenAI Base URL 字段中填入对应服务商的请求地址。举例如下:

  • DeepSeek 最新版:https://api.deepseek.com/v1
  • 147AI:https://147ai.com/v1
  • 09API:https://www.09api.com/v1

这里有一个常见的坑必须提醒:URL 结尾必须是 /v1,否则测试时直接报错,没有任何协商余地。

添加自定义模型

第一步:滚动到页面底部,点击 + Add Model 按钮。

第二步:在弹出的输入框中填写模型名称——这个名称仅用于显示,可以随意定义,例如 my-deepseek-v3。

第三步:下方有一个 Model ID 输入框,此处必须填写模型真正的标识符,且需要与服务商模型广场页面上提供的内容完全一致。例如:

  • DeepSeek-V3 → deepseek-v3
  • Claude-3-5-sonnet → claude-3-5-sonnet-20241022
  • Kimi K2.5 → kimi-k2-5(注意使用短横线,而非点号)

第四步:点击 Add 按钮,新添加的模型便会出现在列表底部。

启用并验证模型

将刚添加的模型左侧的 ☑️ 勾选,同时确保 OpenAI API Key 开关处于开启状态——当出现黄色警告标识时,才表示真正生效。

点击右侧的 Verify 按钮,等待几秒钟。如果状态变为 Active 且没有任何错误提示,则说明配置成功。

关闭设置页面,在编辑器中按下 Ctrl+L 打开聊天窗口,从模型下拉菜单中选中你刚添加的模型,发送一条测试消息试试——能够正常使用就代表一切就绪。

来源:https://www.php.cn/faq/2907290.html?uid=1431639

相关热点

继续查看同栏目近期热点。

延伸阅读

补充最近整理过的热点入口。