Cursor 接入第三方 API 快速教程：Override OpenAI Base URL 配置

在 Cursor Pro 中配置第三方 API Key 和 Override OpenAI Base URL，添加 Claude、GPT、Gemini 等模型并完成 Verify 测试。

Cursor 支持在 Pro 或更高订阅中自定义 OpenAI Base URL。配置 NixAPI 后，你可以在 Cursor 里使用 NixAPI 提供的 Claude、GPT、Gemini、DeepSeek 等模型。

这篇教程覆盖 Cursor 设置面板中的关键步骤：填写 API Key、开启 Override Base URL、添加模型并点击 Verify 验证。

准备工作

开始前确认：

你使用的是 Cursor Pro 或更高订阅
已拥有 NixAPI API Key
Cursor 版本支持自定义 OpenAI Base URL

免费版如果没有自定义 Base URL 入口，就无法直接按本文配置。可以跳到文末查看替代方案。

NixAPI API Key 可以在 NixAPI 控制台创建。模型列表和价格可查看 NixAPI 模型价格页。

第一步：打开 Cursor Models 设置

打开 Cursor，进入设置页面：

Settings → Models

在 Models 页面中找到 API Keys 或 OpenAI 相关设置区域。不同版本 UI 可能会有细微差异，但你需要找到两项：

OpenAI API Key
Override OpenAI Base URL

第二步：填写 API Key 和 Base URL

在 OpenAI API Key 输入框中填写：

nix-your-api-key

在 Override OpenAI Base URL 中填写：

https://nixapi.com/v1

然后打开两个开关：

OpenAI API Key 启用开关
Override OpenAI Base URL 启用开关

很多配置失败都来自第二个开关漏开，或者 Key 开关没有启用。两个开关都打开后，Cursor 通常会显示自定义接口相关的提示或警告，这说明请求会走你的配置。

第三步：添加模型

在模型列表中找到 Add Model，添加你想使用的 NixAPI 模型 ID。

可先添加：

claude-sonnet-4-20250514
claude-opus-4-7
gpt-5.4
gemini-3-pro-preview
deepseek-v4

模型名必须和 NixAPI 支持的 ID 完全一致。不要手动简写，比如把 claude-sonnet-4-20250514 写成 claude-sonnet 可能会导致 Verify 失败。

完整列表以 NixAPI 支持的模型列表页为准。

第四步：Verify 并测试聊天

添加模型后，点击模型旁边的 Verify。

如果没有报错，打开 Cursor Chat 或 Composer，选择刚添加的模型，发送：

请帮我解释当前文件的主要逻辑，并指出一个可以改进的点。

能正常回复，说明 Cursor 已通过 NixAPI 调用模型。

用 curl 排查 API 是否可用

如果 Cursor 里 Verify 失败，不确定是 Cursor 设置问题还是 API 问题，可以先用 curl 测试：

curl https://nixapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer nix-your-api-key" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [{"role": "user", "content": "请用一句话说明你是谁"}]
  }'

curl 能返回内容，说明 NixAPI Key、模型和网络基本正常，回到 Cursor 检查开关和模型勾选。curl 也失败，则优先检查 Key、余额、模型名和网络。

常见问题

1. Verify 报 401

API Key 错误，或者 OpenAI API Key 开关没有启用。重新从 NixAPI 控制台复制 Key，并确认开关开启。

2. Verify 报 404

通常是模型名错误或 Base URL 错误。Cursor 中应填写：

https://nixapi.com/v1

模型 ID 建议从 NixAPI 支持的模型列表页复制。

3. 没有自定义 Base URL 输入框

检查 Cursor 订阅和版本。Cursor 免费版通常不支持自定义 Base URL。

4. 聊天能用，但代码补全没反应

回到 Models 设置，确认刚添加的模型被启用，并检查 Cursor 对 code completion 模型的单独设置。

5. 如何控制使用成本？

可以把日常聊天和补全分配给不同模型。正式长期使用前，建议查看 NixAPI 模型价格页。NixAPI 当前有限时充值兑换率：￥0.80 = $1.00。

免费版替代方案

如果你暂时没有 Cursor Pro，不能直接配置自定义 Base URL，可以在 Cursor 的内置终端里用 OpenAI SDK 调 NixAPI：

from openai import OpenAI

client = OpenAI(
    api_key="nix-your-api-key",
    base_url="https://nixapi.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[
        {"role": "user", "content": "用 Python 写一个快速排序函数"}
    ],
)

print(response.choices[0].message.content)

这种方式没有 Cursor 原生补全和 Composer 体验，但可以先验证 NixAPI 模型调用是否满足你的需求。

小结

Cursor 接入 NixAPI 的关键是 Cursor Pro、自定义 OpenAI Base URL https://nixapi.com/v1、有效 API Key 和准确模型 ID。配置完成后，Cursor 的 Chat、Composer 和部分补全能力就可以使用 NixAPI 的多模型接口。

Cursor 接入第三方 API 快速教程：自定义 OpenAI Base URL 配置