在 Cursor 中使用 BigModel.io

通过 OpenAI 兼容地址 https://bigmodel.io/v1，在 Cursor 的对话和 Agent 中使用 GLM、Kimi、DeepSeek 等 BigModel.io 模型，并了解限制与排查方法。

本页目录
  1. 哪些请求会用你的 Key
  2. 开始之前
  3. 配置 Cursor
  4. 选择模型
  5. 验证配置
  6. 常见问题排查
  7. 相关文档

Cursor 允许为对话模型填写自己的提供方 Key。借助 OpenAI Key 栏、Base URL 覆盖和自定义模型名，Cursor 的对话和 Agent 就能经 https://bigmodel.io/v1 调用 BigModel.io 的模型。

Cursor 中的字段 值
OpenAI API Key 你的 BigModel.io API Key（sk-...）
Override OpenAI Base URL https://bigmodel.io/v1
自定义模型名 模型目录中的模型 ID，如 glm-5.3

Cursor 官方的 API Key 文档仍介绍自定义提供方 Key，但已不再提到 Override OpenAI Base URL 开关。下面的步骤来自社区对当前版本的反馈。如果你的版本没有这个覆盖项，就无法把 Cursor 接到 BigModel.io。

#哪些请求会用你的 Key

  • 使用你添加的模型发起的对话和 Agent 请求，走你的 Key，从 BigModel.io 余额扣费。
  • Tab 补全等 Cursor 功能仍使用 Cursor 自己的模型和套餐。自定义 Key 只作用于对话模型。
  • 所有请求都先经过 Cursor 的服务器再到 BigModel.io，所以 Base URL 必须能从公网访问。https://bigmodel.io/v1 没问题，localhost 代理不行。

#开始之前

  1. 在 API Keys 创建 Key，选择提供目标模型的分组。Cursor 发送的是 Chat Completions 请求，所有提供文本模型的分组都可以。
  2. 用最小请求检查 Key：
bash
curl https://bigmodel.io/v1/chat/completions \
  -H "Authorization: Bearer $BIGMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"ping"}]}'

#配置 Cursor

不同版本的菜单名称会变，找对应字段即可。

  1. 打开 Cursor Settings → Models。
  2. 在 API Keys 下，把 BigModel.io Key 粘贴到 OpenAI API Key。
  3. 打开 Override OpenAI Base URL（社区反馈位于 OpenAI Key 下方），填入 https://bigmodel.io/v1，不要加 /chat/completions。
  4. 点击 Add model，输入准确的模型 ID，如 glm-5.3、kimi-k3、deepseek-v4-pro。
  5. 启用新模型，并在对话或 Agent 的模型选择器中选中它。

覆盖开启时，Cursor 内置 OpenAI 模型名的请求也会发到 BigModel.io，可能失败。把用不到的内置模型关掉，或者需要内置模型时关闭覆盖。

#选择模型

按模型页原样填写 ID：全小写、保留小数点（glm-5.3、kimi-k3、deepseek-v4-pro、minimax-m3）。Agent 模式依赖稳定的工具调用，大改动前先用小任务试一下。

#验证配置

在对话面板选中你添加的模型，发送 "ping"，然后打开用量页，应能看到这条请求及你填写的模型 ID。看不到说明 Cursor 用的是它自己的模型。

#常见问题排查

保存 Key 时验证失败。 Cursor 可能用它默认的 OpenAI 模型名做验证，而你的分组不提供这些模型。先添加自己的模型，只保留它启用，再验证。在用量页出现的对话请求才是真正的测试。

503 api_error：No available accounts: no available accounts supporting model: ...。 Cursor 中的模型名与分组提供的模型不一致。请从模型页原样复制 ID。

所有请求都返回 404。 Base URL 错了。应为 https://bigmodel.io/v1，不是 https://bigmodel.io 或 .../v1/chat/completions。

401 INVALID_API_KEY。 Key 粘贴时带了空格、已被删除，或属于其他账号。到 API Keys 重新复制。

403 INSUFFICIENT_BALANCE 或 429 API_KEY_QUOTA_EXHAUSTED。 到充值页充值或提高 Key 额度。429 rate_limit_exceeded 会说明是哪个 Key 窗口（5 小时、1 天或 7 天）用完了。

内置模型不能用了。 覆盖会把所有 OpenAI 模型请求发到 BigModel.io。需要 Cursor 内置模型时关闭覆盖。

Tab 补全没有走 BigModel.io。 正常现象，Tab 始终使用 Cursor 的模型。

#相关文档

更新于 · 以 Markdown 查看