Skip to content

Cursor 接入自定义 API ​

在 Cursor 的 Settings → Models → API Keys 中填入 NiceAI 密钥,打开 Override OpenAI Base URL 并填写 https://api.niceai.dev/v1,Cursor 本地的 Chat 和 Agent 就会通过 NiceAI 调用模型。

准备工作 ​

在 NiceAI 控制台「API 密钥」页面创建密钥,分组选择 OpenAI。

配置步骤 ​

  1. 打开 Cursor 设置(macOS 按 Cmd+Shift+J,Windows / Linux 按 Ctrl+Shift+J),进入 Models,展开 API Keys。

  2. 在 OpenAI API Key 中粘贴 NiceAI 密钥,并打开 Use OpenAI API Key。

  3. 打开 Override OpenAI Base URL,填写:

    text
    https://api.niceai.dev/v1
  4. 在模型列表中启用要用的模型;列表里没有的,点击添加模型,输入 模型广场 中的模型名。

  5. 在 Chat 或 Agent 的模型选择器中选中该模型,发一句话测试。

地址要带 /v1

Cursor 会在 Base URL 后面拼接 /chat/completions。不要填 https://api.niceai.dev(缺 /v1),也不要填到 /chat/completions。

适用范围 ​

根据 Cursor 官方说明,自带密钥(BYOK)只用于本地的 Chat 和 Agent 请求,不作用于 Tab 补全、Auto 模型选择、云端 / 后台 Agent、Cursor CLI 等功能,这些仍使用 Cursor 自己的模型。另外,使用自定义 Base URL 时,请求会先经过 Cursor 的服务器再转发到你填写的地址。

常见问题 ​

提示找不到资源(404)? ​

检查 Base URL 是否正好以 /v1 结尾,后面没有多余路径。详见 接口地址要不要加 /v1。

提示密钥无效? ​

确认密钥复制完整、处于启用状态,并且已打开 Use OpenAI API Key。

想在 Cursor 里用 Claude 等非 OpenAI 模型? ​

Cursor 的 Override 只走 OpenAI 格式(Chat Completions)。如果你的密钥分组支持通过 Chat Completions 调用该模型,可以在模型列表里手动添加模型名;能否使用以控制台分组说明和 模型广场 为准。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站