外观
Cursor 接入自定义 API
在 Cursor 的 Settings → Models → API Keys 中填入 NiceAI 密钥,打开 Override OpenAI Base URL 并填写 https://api.niceai.dev/v1,Cursor 本地的 Chat 和 Agent 就会通过 NiceAI 调用模型。
准备工作
在 NiceAI 控制台「API 密钥」页面创建密钥,分组选择 OpenAI。
配置步骤
打开 Cursor 设置(macOS 按
Cmd+Shift+J,Windows / Linux 按Ctrl+Shift+J),进入 Models,展开 API Keys。在 OpenAI API Key 中粘贴 NiceAI 密钥,并打开 Use OpenAI API Key。
打开 Override OpenAI Base URL,填写:
texthttps://api.niceai.dev/v1在模型列表中启用要用的模型;列表里没有的,点击添加模型,输入 模型广场 中的模型名。
在 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 调用该模型,可以在模型列表里手动添加模型名;能否使用以控制台分组说明和 模型广场 为准。