跳转到内容
NoviaHub 文档

编辑器与插件

Cursor

在 Cursor 中通过「覆盖 OpenAI 接口地址」使用 NoviaHub：适用范围、配置步骤和已知限制。

Cursor 是内置 AI 功能的代码编辑器。它支持填入自己的 API Key（BYOK），官方支持的服务商有 OpenAI、Anthropic、Google、Azure OpenAI 和 AWS Bedrock。要让 Cursor 调用 NoviaHub，需要用到「Override OpenAI Base URL」（覆盖 OpenAI 接口地址）这个选项。

前提条件

Section titled “前提条件”
  • 一把 NoviaHub API 密钥，见 API 密钥；账户里有余额，见 钱包与充值。
  • 一个 Cursor 账号（使用 Cursor 需要登录）。
  • 关于 Cursor 的付费计划：官方说明免费的 Hobby 计划可以使用 Agent、Chat 和 Tab，所用模型为 Auto；Hobby 计划能否使用自定义模型，官方文档没有说明。另一家 AI 网关 ZenMux 的文档称，在 Cursor 里使用自定义模型通常需要 Pro 订阅。
  • 一个同时带有 Chat 和 Response 端点标签的模型（在 模型&价格 的模型详情里查看）。2026-09-28 符合条件的有 gpt-6-sol、gpt-6-luna、gpt-6-astra、gpt-5.6-sol、gpt-5.6-luna、gpt-5.6-terra、deepseek-v4-flash、deepseek-flash、deepseek-v4-flash-vision-exp、kimi-k3，模型会增减，请以模型页为准。

安装

Section titled “安装”

从 cursor.com/download 下载：

  • macOS 12 或更新版本：.dmg（Apple 芯片和 Intel 芯片各有安装包）。
  • Windows 10 或更新版本：.exe。
  • Linux：官方提供 apt 软件源、RPM 软件源和 AppImage，安装方法见参考资料中的官方安装页。

据 Cursor 工作人员在论坛上的说明，3.15.x 版本中这几个设置项有一个输入框焦点问题，在 3.15.20 中修复，请使用 3.15.20 或更新版本。

配置 NoviaHub

Section titled “配置 NoviaHub”

  1. 打开 Cursor Settings，进入 Models 页面，滚动到底部的 API Keys 区域。

  2. 在 OpenAI API Key 一项里粘贴你的 NoviaHub 密钥（sk- 开头），并打开这一项的开关。官方文档写的是粘贴后点击 Save；Cursor 工作人员特别提醒，粘贴密钥和打开开关是两个步骤，开关没打开时，下一步的覆盖地址也不会生效。

  3. 打开 Override OpenAI Base URL 的开关，填入：

    https://noviahub.com/v1

  4. 在 Models 页面添加自定义模型（ZenMux 的文档里这个按钮写作「+ Add Custom Model」），输入模型 ID，例如 gpt-6-sol（必须与 NoviaHub 模型页上的 ID 完全一致），并确认模型右侧的开关已打开。

  5. 新开一个聊天，在聊天或 Agent 里选中这个模型，开始使用。Cursor 工作人员确认过，打开开关后新开一个聊天是正确的做法。

验证

Section titled “验证”

Cursor 官方文档没有给出这种配置方式的检测按钮。验证方法：在聊天里选中刚添加的模型，发一句话，能正常回复就表示接通；再到 NoviaHub 控制台的 使用日志 里确认出现了这次调用。

切换模型

Section titled “切换模型”

在 Models 页面添加更多自定义模型，然后在聊天或 Agent 的模型选择器里切换。每个模型都要满足上面「同时支持 Chat Completions 和 Responses」的条件，并且名称不能以 claude- 开头。

要换回 Cursor 自带的模型（Claude、Gemini 除外），先关掉 Override OpenAI Base URL 和 OpenAI API Key 的开关，用完再打开。这是 Cursor 工作人员给出的临时办法。

常见问题

Section titled “常见问题”

Tab 补全没有走 NoviaHub 这是 Cursor 的设计：自定义 API Key 只用于聊天类模型，Tab 补全始终使用 Cursor 自带模型。

Cursor 自带模型报错「This model does not support custom API keys」 覆盖打开时，Composer、Grok 等 Cursor 自带模型也会带上你的 OpenAI Key。按上面「切换模型」里的办法，先关掉覆盖。

报错「AI Model Not Found」「Model name is not valid」 Cursor 工作人员说明过两种原因：一是 OpenAI API Key 的开关没有打开，请求没有带上你的密钥，可以删掉密钥重新添加、把开关关掉再打开一次，然后新开聊天；二是模型名称以 claude- 开头，Cursor 改用了 Anthropic 的 Key。

有时成功、有时报错 检查所选模型是否同时带有 Chat 和 Response 标签。Cursor 会根据情况发送两种格式的请求，只支持其中一种的模型会在部分请求上失败。另外，ZenMux 的文档称 Cursor 有时会把 Responses 格式的请求体发到 Chat Completions 地址；遇到这种情况时，NoviaHub 会返回 400，提示 field messages is required。ZenMux 的文档称这是 Cursor 一侧的问题，目前没有有效的解决办法。

Agent 模式下 GPT 模型报错，提示 tools[N].custom Cursor 工作人员 2026-08-10 确认：使用 OpenAI Key 和覆盖地址时，Agent 请求里的工具定义可能通不过校验，报错信息里带有 tools[N].custom。这是 Cursor 一侧的已知问题，正在跟进。

返回 401 Invalid token（无效的令牌） 密钥填错，或密钥已被禁用、已过期、额度已用完，到「API 密钥」页检查，见 API 密钥 · 密钥的四种状态。

团队版里找不到 API Keys 区域 Cursor 工作人员说明：团队管理员开启「Restrict Personal API Keys」后，Cursor 会隐藏整个 API Keys 区域；OpenAI 这一项在团队设置里还有单独的开关。需要联系团队的 Cursor 管理员。官方文档还说明，Teams 和 Enterprise 计划使用自己的 Key 时，Cursor 仍会按每百万 tokens $0.25 收取 Cursor Token Rate。

参考资料

Section titled “参考资料”

以下资料查阅于 2026-09-28 至 2026-09-29：