Cursor 接入自定义 API 教程：Base URL、Key 与模型配置（2026）

Cursor 是使用很广的 AI 代码编辑器。除了内置模型额度，它也允许填入自己的 API Key 和 Base URL。对国内团队来说，把 Cursor 接到统一的 OpenAI 兼容网关上，可以固定访问路径、集中账单，并在模型之间切换。

本文按实际操作顺序，讲清准备、配置、验证、限制和团队落地。不同版本的菜单名称可能不同，以你当前安装的 Cursor Settings 为准。

说明：Cursor 是 Anysphere, Inc. 的商标。本文仅作技术说明，与 Cursor/Anysphere 无隶属或代理关系；界面、套餐与计费规则以 Cursor 官方页面为准。

一、先分清两种“Cursor API”

第一种是 Cursor 平台自身开放的 API，例如 Cloud Agents 和管理接口，Key 在 Cursor 账户中创建，用来调用 Cursor 的服务。第二种是“自带模型 Key”（BYOK）：在 Cursor 里填写模型供应商的 Key，让编辑器用你的账户调用模型。本文讲第二种。

有一个前提容易被忽略：Cursor 的模型请求由 Cursor 服务器转发，不是从你本机直连。因此 Base URL 必须是公网可访问的地址。只在公司内网可达的网关，Cursor 侧通常会超时。中商起航 AI 网关是公网服务，一般不受这个限制。

二、准备 Key、Base URL 和模型名

开始前准备三样东西：一个 API Key、一个兼容地址、一个准确的模型 ID。

打开中商起航 AI 网关注册页，注册并登录控制台。
进入「API 密钥」，新建密钥，名称写清用途，例如 cursor-工作电脑。
设置额度上限和过期时间。个人账号也建议设置，避免异常消耗。
复制 Key，保存到密码管理器。控制台通常只完整显示一次。
打开模型价格，记下要用的模型 ID。价格和模型会调整，以页面当前展示为准。

三项配置的写法如下：

Base URL: https://ai.zhongshangqihang.com/v1
API Key:  sk-...（在控制台创建，只保存于密码管理器）
Model:    以「模型价格」页当前展示的模型 ID 为准

Base URL 使用 OpenAI 兼容地址，结尾是 /v1。不要填 Anthropic 的根地址，也不要自己补上 /chat/completions，否则容易出现路径重复。

三、在 Cursor 中填写配置

常见路径是 Cursor Settings → Models → API Keys。不同版本会增减选项，但核心步骤接近。

打开 Cursor Settings，快捷键通常是 Cmd/Ctrl + ,。
进入 Models，展开 API Keys 区域。
打开 OpenAI API Key，粘贴刚创建的 Key，点 Save。
打开 Override OpenAI Base URL，填入 https://ai.zhongshangqihang.com/v1。
点 + Add Custom Model（部分版本叫 + Add model），填入价格页上的模型 ID，并启用该模型。
在对话的模型选择器里选中这个模型，发一条简单请求。

如果找不到 Override OpenAI Base URL，说明当前版本或套餐不支持把 OpenAI 兼容流量指向自定义地址。此时不要反复尝试，先升级版本或改用支持该开关的安装包。

模型名是路由标识，不是备注。大小写、连字符、版本后缀都要和网关一致。填错时通常表现为模型不存在、404，或者请求被拒绝。

四、模型怎么选

Cursor 里可以添加多个自定义模型，但请求能否成功，取决于网关是否提供同名模型、是否支持对应的调用方式。

使用场景	建议档位	填写方式	注意事项
日常问答、小改动	轻量快速模型	复制价格页模型 ID	延迟低，复杂重构能力有限
多文件修改、Agent	主力代码模型	复制价格页模型 ID	需支持工具调用
架构设计、疑难排查	高能力模型	复制价格页模型 ID	成本更高，按需使用
Tab 补全	Cursor 内置模型	不经过自定义 Key	BYOK 不覆盖补全

Agent 模式可能依赖 Responses API 或工具调用。如果网关只兼容 Chat Completions，部分 Agent 功能会失败。遇到这种情况，先在普通对话中验证，再判断是模型问题还是功能不兼容。

另外，Auto、Composer 和 Tab 补全不一定会走你的 Key。按 Cursor 帮助页的说明，Tab 补全始终使用内置模型；Auto 模式也可能由 Cursor 自行路由。把自定义模型当作“明确选择后才生效”的通道，更符合实际。

五、验证配置是否生效

只看 Cursor 有没有回复不够，因为回复可能来自内置通道。建议按下面顺序验证。

新建一个空对话，避免历史上下文干扰。
在模型选择器里明确选中自定义模型，不要用 Auto。
发送一个短请求，例如让它解释一段十行以内的代码。
打开网关控制台的用量或请求日志，确认出现同一时间、同一模型、同一 Key 的记录。
记录验证结果。如果日志没有记录，说明请求没有到达网关，应回到 Base URL 和开关检查。

常见错误可以这样对照：

401 或 403：Key 错误、被禁用，或额度已经用完。
404：Base URL 路径不对，或模型名不存在。
429：触发限流，或达到 Key 的额度上限。
超时：端点不可达，或网络路径有问题。
只有 Agent 失败：可能是接口能力不匹配，不一定是 Key 的问题。

六、必须知道的限制

BYOK 主要覆盖聊天模型，Tab 补全仍走 Cursor 内置模型。
不同版本对 OpenAI Key 的支持范围不同。Cursor 帮助页提到，OpenAI 自带 Key 只覆盖不带推理的标准聊天模型，推理模型和部分新功能可能不可用。
请求经 Cursor 服务器转发，自定义端点必须公网可达。
自带 Key 的请求不一定享受 Cursor 的零数据保留政策，数据处理方式取决于模型供应商和网关。对数据保留有硬性要求的团队，应先做评估。
团队版和企业版即使自带 Key，也可能仍按 Cursor 的规则收取平台费用，具体以 Cursor 计费页为准。
Cursor 更新较快，菜单名称、支持模型和计费规则都可能变化。

七、团队落地步骤

先做小范围试点：选三到五名开发者，统一一个主力模型，运行一周。
记录三类数据：请求成功率、平均延迟、每人每天的消耗。
在网关给每人建独立 Key，按人设置额度，不使用共享 Key。
维护模型映射表：Cursor 里填什么、网关对应什么、失败时切换到什么。
把配置写进内部文档，包含 Base URL、模型 ID 和常见错误处理。
观察成本后，再决定哪些成员用自带 Key，哪些继续用套餐额度。价格以模型价格为准。
离职、换机或项目结束时，当天禁用对应 Key。

八、安全清单

一个用途一个 Key，不跨设备复用。
设置额度上限和过期时间。
不把 Key 写进代码、.env、截图或工单。
不在共享电脑上长期保存 Key。
定期轮换；怀疑泄露时先禁用，再排查。
团队统一走网关，保留请求日志，便于审计。
对敏感仓库，先确认数据是否会离开本机、会流向哪些服务。

九、常见问题

Cursor 支持任意 OpenAI 兼容接口吗？

不一定。能否使用取决于 Cursor 版本是否提供 Override OpenAI Base URL，以及接口是否兼容它实际调用的路径和参数。先在普通对话验证，再试 Agent 功能。

填了自己的 Key，为什么还提示需要订阅？

自带 Key 不等于解锁全部功能。部分编辑器功能、团队管理和内置模型仍受套餐限制，以 Cursor 当前套餐规则为准。

Tab 补全为什么没有消耗我的 Key？

按 Cursor 帮助页的说明，Tab 补全始终使用 Cursor 内置模型，不走自带 Key。这是产品设计，不是配置错误。

Base URL 应该填根地址还是 /v1？

走 OpenAI 兼容协议时填到 /v1。不要带 /chat/completions，否则容易出现路径重复和 404。

团队可以共用一个 Key 吗？

技术上可以，但不建议。共用 Key 无法区分成员用量，泄露后也难以定位。每人一个 Key，配合额度和日志更稳妥。

下一步

先注册中商起航 AI 网关，创建一个 Cursor 专用 Key，按本文填入 Base URL 和模型。跑通普通对话后，再看模型价格调整主力模型和额度。