Cursor
按照以下步骤，你可以把彼源 AI 连接到 Cursor，并在 Chat 或 Agent 中选择彼源 AI 提供的聊天模型。
开始前准备
| 项目 | 需要准备的内容 |
|---|---|
| Cursor | 已安装并登录，且当前套餐支持选择自定义模型 |
| 彼源 AI 令牌 | 以 sk- 开头；在控制台令牌管理点击添加令牌创建，或复制一个可用令牌 |
| 服务地址（Base URL） | https://api.biyuan.ai/v1 |
| 模型 ID | 从模型广场复制要使用的完整模型 ID |
本页配置用于 Cursor 的 Chat 和 Agent。代码自动补全（Tab）等 Cursor 专属功能仍可能使用 Cursor 自带模型。
配置 Cursor
1. 打开 Models 设置
进入 Cursor Settings（设置） -> Models（模型），然后展开 API Keys（API 密钥） 区域。
2. 填写并启用彼源 AI 令牌
- 在
OpenAI API Key中填写彼源 AI 令牌（以sk-开头，在控制台令牌管理点击添加令牌创建） - 等待界面显示
Secret saved（已保存） - 打开
OpenAI API Key开关 - 在确认对话框中选择启用
部分版本会显示 Verify（验证）按钮，点击即可校验令牌；如果界面中没有 Verify 按钮，保存令牌后直接打开 OpenAI API Key 开关即可。
3. 设置服务地址
- 打开
Override OpenAI Base URL - 填写：
https://api.biyuan.ai/v1
请完整填写上面的地址。不要在后面添加 /chat/completions，也不要删除 /v1，否则 Cursor 将无法连接到正确的聊天接口。
4. 添加聊天模型
先从模型广场复制一个文本模型的完整 ID，然后在 Add or search model 中输入该 ID：
- 点击
Add Custom Model - 在随后出现的输入框中确认模型 ID
- 点击
Add - 确认模型右侧的开关已经打开
如需使用多个模型，请重复以上步骤逐个添加。
5. 发送第一条消息
回到 Chat 或 Agent，在模型选择器中选择刚添加的模型，不要选择 Auto。然后发送一条简单消息，例如：
只回复 OK
收到正常回复后，回到彼源 AI 控制台，打开「使用日志」，能看到刚才这条请求（模型、时间、消耗），说明接入成功。Auto 会由 Cursor 自己选择模型，不一定使用彼源 AI。
选择模型
彼源 AI 的模型会持续更新。模型 ID 从模型广场复制；想确认当前令牌实际可用的模型，调用 GET /v1/models（令牌设置了模型限制时，以这个返回为准）。
文本聊天模型
文本聊天模型（例如 gpt-4o-mini、grok-4.5）都可以按本页步骤添加。首次配置时，从模型广场任选一个文本模型，确认连接成功后再添加其他模型。
如果 Cursor 提示某个名称中带有 reasoning（推理）的模型不可用，请先改用名称中不带 reasoning 的文本模型完成验证。
名称以 claude- 或 gemini- 开头的模型
Cursor 可能把名称以 claude- 或 gemini- 开头的模型交给内置的 Anthropic 或 Google 连接，而不是使用上面填写的彼源 AI 服务地址。如果选择这类模型发消息后，彼源 AI 控制台的「使用日志」里看不到这条请求，请改用其他文本聊天模型。想继续用这类被接管的模型，可以换工具：Claude 系列见 Claude Code，Gemini 等其他模型见 TRAE IDE。
不能作为聊天模型添加的模型
在模型广场上，模型卡片标注了 Responses API（一种独立的开发接口）或图片生成的模型，不能通过本页的自定义聊天入口使用，例如 gpt-5.4-pro（Responses API）、gpt-image-2（图片生成）。如需生成图片，请使用文生图接口。
哪些功能会使用彼源 AI
| Cursor 功能 | 使用方式 |
|---|---|
| Chat | 使用你在模型选择器中选中的彼源 AI 聊天模型 |
| Agent | 可以使用所选聊天模型；工具和文件操作能力取决于模型与 Cursor 版本 |
| Tab 代码自动补全 | 继续使用 Cursor 自带模型 |
| 图片生成 | 不使用聊天模型入口，请改用彼源 AI 图片接口 |
常见问题
提示 Named models unavailable
这表示当前 Cursor 套餐不允许选择自定义模型。要继续使用彼源 AI，请更换为支持自定义模型的 Cursor 套餐；具体哪些套餐支持，以 Cursor 官方定价页和文档说明为准。
已添加模型，但彼源 AI「使用日志」里没有这条请求
请依次检查：
- 模型选择器中选中的是刚添加的完整模型 ID，而不是
Auto OpenAI API Key和Override OpenAI Base URL两个开关都已打开- 服务地址是
https://api.biyuan.ai/v1 - 当前 Cursor 套餐支持选择自定义模型
- 如果模型名称以
claude-或gemini-开头，先改用其他文本聊天模型重试
仍然不确定的话：登录控制台，在操练场选同一个模型发一句话，能收到回复就说明账号、令牌和额度都正常，问题多半出在客户端配置。
聊天可以使用，但 Tab 代码补全没有变化
这是正常现象。本页配置只影响 Chat 和 Agent；Tab 代码自动补全仍由 Cursor 提供。
如何切回 Cursor 自带模型
先关闭 OpenAI API Key 和 Override OpenAI Base URL 两个开关，再选择 Cursor 自带模型。需要重新使用彼源 AI 时，再打开这两个开关并选择已添加的模型。