跳到主要内容

Cursor

Cursor 是一款集成 AI 对话、代码编辑和 Agent 能力的代码编辑器。本页介绍如何在 Cursor 桌面版中通过 OpenAI API Key 区域的自定义 Base URL 接入 Bita API。

本页适用于 Cursor 桌面版

这里配置的是 Cursor Settings → Models 中的模型服务，不是 Cursor CLI 自动化使用的 CURSOR_API_KEY。后者是 Cursor 账户凭据，不能替代 Bita API 密钥。

需要 Cursor 付费订阅

Cursor 当前要求用户拥有有效的付费订阅，才能在 Ask、Agent 等模式中使用自定义 API Key。免费套餐不能只依靠 Bita API 密钥解锁这些功能。

Bita API 的模型调用费用和 Cursor 订阅费用相互独立：模型请求由 Bita API 计费，Cursor 自带的 Tab、Auto、Agent 编排和其他专用功能仍可能消耗 Cursor 套餐额度。

准备工作​

开始前，请准备：

  • 已安装的 Cursor。
  • 一个处于有效状态的 Cursor 付费订阅。
  • 一个处于启用状态、仍有可用额度的 Bita API 密钥。
  • 密钥所属分组可以使用的模型 ID。
  • 一个支持 OpenAI 兼容接口的模型；使用 Agent 时还应确认模型支持工具调用。

如果尚未创建密钥或选择模型，请阅读创建 API 密钥和选择模型。

为什么使用 OpenAI API Key​

Cursor 原生提供多种 BYOK（Bring Your Own Key）入口，但这些入口的用途不同：

Cursor 配置入口用途Bita API 接入
OpenAI API KeyOpenAI 官方接口，或通过 Override OpenAI Base URL 使用 OpenAI 兼容地址使用此入口
Anthropic API Key直接连接 Anthropic 官方 API不要填写 Bita API 密钥
Google API Key直接连接 Google AI API不要填写 Bita API 密钥
Azure OpenAI连接 Azure OpenAI 资源不用于本页配置
AWS Bedrock连接 AWS Bedrock 账户和模型不用于本页配置

Cursor 目前只有 OpenAI API Key 区域提供通用的 Override OpenAI Base URL。因此，即使准备调用的 Bita API 模型来自其他上游服务商，在 Cursor 中也必须选择支持 OpenAI 兼容接口的模型，并通过 OpenAI API Key 区域填写 Bita API 密钥和地址。

Cursor 没有可指向 Bita API 的 Anthropic Base URL 或 Google Base URL 配置。把 Bita API 密钥直接填入 Anthropic API Key 或 Google API Key，Cursor 会尝试连接对应服务商的官方接口，验证会失败。

选择模型​

Cursor 通过 OpenAI API Key 区域连接自定义 OpenAI 兼容服务。第一次接入时，建议从 Bita API 模型广场选择：

  • 支持 Chat 或 Response 端点的模型。
  • 需要使用 Agent 时，选择明确支持工具调用的模型。
  • 优先选择 Cursor 能作为 OpenAI 兼容模型路由的 GPT 或其他兼容模型。

Cursor 的 OpenAI Base URL 覆盖不会把 claude-*、gemini-* 等模型自动改用 OpenAI 兼容接口。即使 Bita API 可以通过其他协议调用这些模型，也不建议在本页的 OpenAI 配置中选择它们。

不要只根据显示名称猜测模型 ID

模型 ID 必须与 Bita API 模型广场显示的名称完全一致，包括大小写和连接符。密钥所属分组也必须允许调用该模型。

配置 Bita API​

  1. 打开 Cursor。

  2. 点击右上角的齿轮图标，进入 Cursor Settings。

  3. 选择 Models，展开页面中的 API Keys。

  4. 找到 OpenAI API Key，填写以下内容：

    配置项填写内容
    OpenAI API Key完整的 Bita API 密钥
    Override OpenAI Base URL (when using key)开启
    Base URLhttps://www.bita-api.com/v1

  5. 点击 Verify，等待 Cursor 完成验证。

  6. 回到 Models 页面顶部的模型列表，在 Add or search model 中输入完整的 Bita API 模型 ID。

  7. 找到目标模型后将其启用。

Cursor 中的 Bita API Key 和 Base URL 配置示例

如果目标模型 ID 与 Cursor 已有模型相同，Cursor 可能不会允许添加重复条目。此时直接启用已有的同名模型即可；当 OpenAI API Key 和 Base URL 覆盖处于启用状态时，OpenAI 兼容请求会使用当前填写的 Bita API 地址和密钥。

Base URL 必须包含 /v1

Cursor 会在 Base URL 后继续追加 /chat/completions、/responses 等接口路径，因此应填写：

https://www.bita-api.com/v1

不要只填写站点根地址，也不要填写完整的 /v1/chat/completions 或 /v1/responses 地址。

启动并验证​

完成配置后：

  1. 打开 Cursor 的 Chat 或 Agent 面板。
  2. 新建一个对话。
  3. 在模型选择器中选择刚刚启用的模型。
  4. 先发送一条简单消息，确认能够正常回复。
  5. 如果准备使用 Agent，再让模型读取一个文件或执行安全的只读操作，确认工具调用正常。
  6. 在 Bita API 控制台的使用日志中确认请求已经产生，并核对实际模型和接口。

如果修改了 API Key、Base URL 或模型后仍使用旧配置，请关闭当前对话并新建一个对话；仍未生效时，完全退出 Cursor 后重新打开。

切换回 Cursor 内置模型​

Cursor 当前的 Override OpenAI Base URL 是全局设置，不是绑定到单个自定义模型的独立服务商配置。启用后，符合 OpenAI 路由规则的模型会使用 Bita API 地址，模型选择器中也不一定会明确区分内置模型与自定义端点模型。

需要切换回 Cursor 自带的 OpenAI 模型、Composer 或其他专有模型时：

  1. 返回 Cursor Settings → Models → API Keys。
  2. 关闭 Override OpenAI Base URL (when using key)，必要时同时停用自定义 OpenAI API Key。
  3. 新建对话并重新选择 Cursor 内置模型。

再次使用 Bita API 时，重新启用 API Key 和 Base URL 覆盖。

功能限制​

自定义 API Key 主要用于标准对话模型，并不能替代 Cursor 付费订阅。以下功能会继续使用 Cursor 自带模型或套餐额度：

  • Tab Completion。
  • Auto 模式。
  • Cursor 专有的 Composer 模型。
  • Agent 的编排或依赖专用模型的步骤。
  • 其他后台或云端功能。

Agent 是否可用还取决于 Cursor 版本、账户权限以及目标模型的工具调用能力。出现普通对话正常但 Agent 失败时，应先确认所选模型支持工具调用，再查看 Bita API 使用日志中的请求与错误信息。

常见问题​

现象建议检查
免费套餐中无法使用自定义 KeyCursor 当前要求 Ask、Agent 等模式的 BYOK 用户拥有有效付费订阅
Verify 失败或返回 401是否填写了完整的 Bita API 密钥；密钥是否已禁用或过期
Bita API 密钥填入 Anthropic 或 Google 后验证失败Bita API 应配置在 OpenAI API Key 区域，并开启 OpenAI Base URL 覆盖
返回 403账户余额、密钥额度、密钥分组和模型权限
返回 404Base URL 是否为 https://www.bita-api.com/v1；不要填写站点根地址或完整接口路径
返回模型不存在模型 ID 是否与模型广场完全一致，密钥分组是否包含该模型
无法添加同名模型Cursor 已存在相同模型 ID；直接启用已有条目，并保持 Bita API Key 和 Base URL 覆盖开启
选择模型后仍未走 Bita API确认 OpenAI API Key 和 Base URL 覆盖已启用；新建对话后重试，并查看 Bita API 使用日志
Claude 或 Gemini 模型没有走 Bita APIOpenAI Base URL 覆盖不用于 claude-*、gemini-* 路由；改用 OpenAI 兼容模型
普通对话成功但 Agent 失败模型可能不支持工具调用，或当前功能仍依赖 Cursor 专用模型
Cursor 内置模型或 Composer 无法使用关闭 Base URL 覆盖和自定义 OpenAI API Key 后，新建对话再选择内置模型
出现 TLS 或网络错误确认 Bita API 地址可访问；可在 Cursor Settings → Network 中尝试启用 HTTP Compatibility Mode
配置正确但请求失败在 Bita API 使用日志中查看实际模型、接口和错误信息

Cursor 的设置界面和自定义 API Key 行为会随版本更新，具体以 Cursor 官方的自定义 API Key 说明为准。