编辑器接入
Cursor 使用 Jerry API
在 Cursor 的 Models 设置中填写 Jerry API Key,并将 OpenAI Base URL 覆盖为 Jerry API 地址。
配置步骤
- 打开 Cursor Settings
进入
Settings → Models,找到 API Keys 或 Bring Your Own Key 区域。 - 填写 OpenAI API Key
粘贴你的 Jerry API Key。这里选择 OpenAI,是因为 Jerry API 提供 OpenAI-compatible 接口。
- 覆盖 OpenAI Base URL
开启
Override OpenAI Base URL,填写https://www.jerryapi.com/v1。 - 添加模型名
在可添加自定义模型的版本中,先添加
gpt-5.4。也可以继续添加gpt-5.4-mini和gpt-5.5。 - 点击 Verify
验证通过后启用该 API Key,并在聊天模型选择器中选中对应 GPT 模型。
界面名称可能略有变化
Cursor 会持续调整设置页面。核心字段不变:OpenAI API Key、Override OpenAI Base URL、模型 ID。
应填写的值
| Cursor 字段 | 填写内容 |
|---|---|
| Provider | OpenAI |
| API Key | 你的 Jerry API Key |
| Override OpenAI Base URL | https://www.jerryapi.com/v1 |
| Model | gpt-5.4 |
不要填写完整接口路径
Cursor 的这个字段是 Base URL,不要写成 /v1/chat/completions,Cursor 会自行添加请求路径。
验证是否生效
- 新建一个 Chat 会话
选择刚添加的
gpt-5.4,发送一个简单的代码解释任务。 - 查看使用记录
在 Jerry API 后台按时间核对模型名、Token 和费用。
- 再测试 Agent 任务
如果聊天正常,再尝试需要工具调用的项目任务;不同 Cursor 功能对自有 API Key 的支持范围可能不同。
Cursor 专有能力不一定走自有 Key
Tab Completion 等依赖 Cursor 专用模型的功能仍可能使用 Cursor 内置服务;自有 API Key 主要用于其支持的聊天模型。请以 Jerry API 后台是否出现请求记录为准。
排查
| 现象 | 处理 |
|---|---|
| Verify 失败 | 先用快速开始中的 curl 测试密钥,再确认 Base URL 只写到 /v1 |
| 模型不在列表 | 检查当前 Cursor 版本是否允许添加自定义模型名,并完整填写模型 ID |
| 聊天成功但后台无记录 | 当前会话可能仍在用 Cursor 内置模型,重新选择自定义 GPT 模型 |
| Agent 功能受限 | 这是 Cursor 对自有 API Key 的功能边界;需要完整 GPT Agent 体验时优先使用 Codex 或 OpenCode |
