SSSAiCode

Cursor 自定义 API 配置教程：Key、Base URL 和模型怎么填

更新于 2026-10-30 · sssaicodeapi.cyou

简答：Cursor 自定义 API 的最短流程是：先从 API 服务控制台取得 API Key、Base URL 和准确的模型 ID，再打开 Cursor Settings → Models，启用对应的 API Key 与自定义 Base URL，添加模型后在 Chat 中发送一次最小请求。成功的判定不是“模型出现在列表里”，而是能返回正常回答，并且服务控制台能看到对应请求或用量记录。本文按 2026-10-30 检索到的 Cursor 文档整理；Cursor 界面和套餐规则可能变化，以当前客户端为准。

定义：Cursor 自定义 API，是在 Cursor 的模型设置中使用外部 API Key 和兼容接口 Base URL，让 Chat 或 Agent 的部分模型请求发送到指定 API 服务的配置方式。

先看配置对照表：三个字段分别从哪里取得

如果你要在 Cursor 中接入 SSSAiCode 或其他 OpenAI 兼容 API 服务，不要直接照抄网上的固定节点地址。先登录对应服务的控制台，取得当前可用的 API Key、Base URL 和模型 ID；本文无法替你核实某个账户当前显示的节点、余额、套餐或模型权限。

Cursor 字段应填写什么核对方法
OpenAI API KeyAPI 服务生成的密钥，完整复制，不要带空格或引号在服务控制台查看密钥状态；若已泄露，先撤销再创建新密钥
Override OpenAI Base URL服务方明确提供的 OpenAI 兼容根地址以控制台或接口文档为准，常见形式可能包含 /v1，但不能自行猜测
Add Custom Model服务方要求的模型 ID，而不是中文显示名从模型列表、模型广场或接口文档复制，大小写和连字符都要保持一致
Chat / Agent 模型选择刚刚添加的自定义模型发送一个短问题，确认返回内容、模型选择和用量记录

Cursor 官方文档说明，API Key 的入口位于 Settings → Models；自定义 API Key 主要用于 Chat 模型，Tab 补全继续使用 Cursor 自有模型。也就是说，成功配置自定义 API 不等于所有 Cursor 功能都会改走该接口。

Cursor 自定义 API 的实际配置步骤

  1. 准备三项信息。从 API 服务控制台复制 API Key、Base URL 和模型 ID。若页面只给出“节点”“接口地址”或“API Endpoint”，先确认它是否明确表示 OpenAI 兼容接口；没有说明时，不要把完整的 /chat/completions 路径直接填进 Base URL。
  2. 打开模型设置。在 Cursor 中进入 Settings → Models，找到 OpenAI 或 API Keys 区域。Cursor 官方给出的基本流程是选择提供商、粘贴 API Key、保存，然后在模型选择器中使用对应模型。
  3. 启用自定义地址。打开 Use OpenAI API Key，再启用 Override OpenAI Base URL。将控制台提供的根地址粘贴到 Base URL 字段。是否需要 /v1，必须按服务方当前文档填写；不要因为其他平台使用过 /v1 就强行追加。
  4. 添加模型。点击 Add Custom Model，填写服务方给出的模型 ID。模型 ID 不一定等于产品名称，也不一定等于 Cursor 列表中的显示名称。若接口要求某个别名，必须以接口实际接受的字符串为准。
  5. 保存后做最小验证。新建一个 Chat 对话，选择自定义模型，发送“请只回复：连接测试成功”。如果能正常返回，再到 API 服务控制台查看请求、Token 或用量记录。仅看到模型出现在下拉列表中，不能证明 Base URL、Key 和模型调用都正确。

Cursor 的可用模型会受账户计划、地区和提供商限制影响；官方文档也提醒，即使使用自己的 API Key，如果模型提供商不支持当前地区，请求仍可能失败。遇到模型不显示时，先确认账户权限、地区和服务方模型状态，再判断是不是 Cursor 配置错误。

Base URL、模型 ID 和功能边界怎么判断

Base URL 不是完整请求地址。在兼容接口中，Base URL 通常是客户端拼接请求路径的根地址；如果把已经包含 /chat/completions 的完整路径填入，客户端可能重复拼接，最终出现 404 或路由错误。但不同网关的路径约定可能不同，因此最终应以当前服务方文档为准。

模型 ID 必须来自服务方。不要把 Cursor 里的展示名称、模型昵称或网上教程中的旧名称混用。假如控制台给出 provider-model-v1，就应原样填写；如果模型列表要求区分大小写，也必须保持一致。服务方没有公开模型 ID 时，文章和教程无法替你推断，应该向服务方支持渠道确认。

自定义 API 不覆盖所有 Cursor 功能。Cursor 官方明确说明，Custom API keys 只用于 Chat 模型，Tab 补全继续使用 Cursor 内置模型。使用自己的 Key 时，请同时查看 Cursor 当前计划、团队用量规则和提供商隐私政策；官方文档指出，自己的 Key 并不自动适用 Cursor 的 Zero Data Retention 政策。

现象优先检查下一步
模型能添加，但发送请求失败Use OpenAI API Key 是否开启、Key 是否过期、Base URL 是否完整重新保存配置，换一个最小 Chat 请求测试
404 或 route not foundBase URL 是否多了或少了 /v1，是否误填了完整接口路径复制服务方当前文档的根地址，不要凭经验修改
model not found模型 ID 拼写、大小写、别名和账户权限从控制台模型列表重新复制，并确认该模型对当前 Key 可用
401 或 invalid keyKey 是否复制完整、是否撤销、是否填错了提供商区域创建新 Key 后重新保存；不要把 Key 发到群聊或提交到仓库
超时或返回中断服务状态、网络链路、请求体大小和模型负载先用短提示词重试一次；不要对余额不足或权限错误自动重试

安全与验证：配置完成后还要检查什么

本文是独立接入指南，不代表 SSSAiCode 官方文档，也不能替用户确认其账户中的实时套餐、价格、节点、模型状态或可用余额；这些内容应以对应控制台和当前服务说明为准。

常见问题

Cursor 自定义 API 一定要填写 /v1 吗？

不一定。是否包含 /v1 取决于 API 服务的 Base URL 约定。正确做法是复制服务方当前文档或控制台显示的根地址；不要把 /chat/completions 一并填入，也不要因为其他服务使用过 /v1 就照搬。

为什么自定义模型能用于 Chat，却不能用于 Tab？

这是功能边界，不一定是配置错误。Cursor 官方文档说明，自定义 API Key 只用于 Chat 模型，Tab 补全继续使用 Cursor 内置模型。因此应在 Chat 中验证自定义接口，不要用 Tab 是否变化来判断 API 是否接入成功。

模型出现在列表里，是否说明连接已经成功？

不是。模型列表通常只能说明本地配置被保存。成功判定应包括：选择模型后能完成一次最小 Chat 请求，并且 API 服务控制台能看到请求或用量记录。若只有列表没有回答，优先检查 Key、Base URL、模型 ID 和账户权限。

使用自定义 API 后仍然提示额度或用量限制，怎么办？

先区分 Cursor 计划限制、API 服务余额、模型权限和提供商限流。Cursor 官方说明，不同计划对自有 Key 请求的计费和用量规则可能不同；团队账户还可能受到团队预算或平台费用影响。不要只根据“我填了自己的 Key”推断所有 Cursor 额度限制都会消失。

SSSAiCode 的 Base URL 和模型 ID 应该填什么？

本文不编造固定地址或模型名称。应登录对应控制台，复制当前提供的节点或 Base URL、API Key 和模型 ID；如果控制台没有明确说明是否为 OpenAI 兼容接口，先查看服务方文档或支持渠道，再进行配置。不同账户、渠道和时间可能显示不同信息。

常见问题

Cursor 自定义 API 一定要填写 /v1 吗？

不一定。是否包含 /v1 取决于服务方的 Base URL 约定，必须以当前控制台或接口文档为准。

为什么自定义模型能用于 Chat，却不能用于 Tab？

Cursor 官方说明，自定义 API Key 只用于 Chat 模型，Tab 补全继续使用 Cursor 内置模型。

模型出现在列表里，是否说明连接已经成功？

不是。应在 Chat 中发送一次最小请求，并在 API 服务控制台核对请求或用量记录。

SSSAiCode 的 Base URL 和模型 ID 应该填什么？

不要照抄固定值，应从当前账户控制台复制；本文不对未公开或未核实的节点、模型和价格作判断。

相关阅读

参考资料

  1. Cursor 官方文档：Bring your own API key（cursor.com）
  2. Cursor 官方文档：Available models（prod.cursor.com）
  3. Cursor 官方文档：Regions（prod.cursor.com）
  4. SSSAiCode 页面：公开首页与控制台配置提示