Cursor

Cursor 是一款 AI 编程编辑器。通过自定义 OpenAI Base URL，Cursor 可以调用 ModelGo 的逻辑模型。

接入前准备

• 已安装 Cursor。
• 已在 ModelGo 控制台创建或复制 API Key。
• 已在模型广场确认当前 API Key 可调用的逻辑模型名。

1. 安装 Cursor

访问 Cursor 官网，下载并安装适合你操作系统的版本。

2. 打开 Cursor 模型设置

打开 Cursor 设置，进入 Models 页面。

3. 添加并启用模型

点击 Add model，输入模型广场中的逻辑模型名，然后保存。

在 Model Names 列表中保留需要使用的模型，并关闭不需要的模型。

4. 配置 ModelGo 接口

在 Settings → Models → API Keys 中配置 OpenAI 兼容接口：

如果你的 Cursor 使用另一版设置界面，可参考下面的布局，填写相同的 ModelGo 参数。

点击 Verify 或 Save 保存配置。Cursor 的不同版本可能会调整设置项名称，但 Base URL、API Key 和模型名的含义不变。

5. 测试连接

回到 Cursor 聊天窗口，选择刚添加的模型，发送一条简单消息。能够正常返回结果，即表示接入成功。

也可以在终端查看当前 API Key 可调用的模型：

curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"

常见问题

返回 401 或认证失败

确认 API Key 复制完整且没有多余空格，并检查是否填入 OpenAI API Key 字段。

返回 404 或接口路径错误

确认 Base URL 为 https://api.modelgo.com/v1，不要把 /chat/completions 拼到 Base URL 后面。

Verify 失败或模型不可用

确认模型名是 ModelGo 模型广场中的逻辑模型名，并检查该模型是否已对当前 API Key 开通。

聊天窗口没有返回内容

先用 GET https://api.modelgo.com/v1/models 验证网络和 Key，再确认 Cursor 的 Model Names 列表中已启用目标模型。

相关文档

• 首次调用：创建 API Key、查询模型并验证 ModelGo 接口。
• 认证鉴权：了解 API Key 的安全使用方式。
• Cursor 官方文档：查看 Cursor 设置、模型和自定义 API 配置说明。