Skip to content

Cursor 接入指南 ​

在 Cursor 的模型设置中添加 OpenAI Compatible 服务,将 Base URL、API Key 和模型名指向 PotatoAI.cc。

配置目标

无需退出 Cursor 账号,只需要把 PotatoAI.cc 添加为自定义 OpenAI 兼容服务,并用一条短请求完成测试。

准备信息 ​

配置项填写内容
ProviderOpenAI Compatible
Base URLhttps://www.potatoai.cc/v1
API Key控制台创建的 API Key
Model控制台显示的完整模型 ID

配置步骤 ​

1. 打开模型设置 ​

进入 Cursor Settings,找到 Models、API Keys 或自定义模型供应商区域。不同版本的菜单名称可能略有差异。

2. 添加兼容服务 ​

选择 OpenAI Compatible。如果版本只提供 OpenAI 配置,则使用允许覆盖 Base URL 的入口。

3. 填写地址和密钥 ​

Base URL 填写 https://www.potatoai.cc/v1,API Key 填写在 PotatoAI.cc 控制台创建的密钥。

4. 添加模型 ​

从控制台复制完整模型 ID。不要自行删减版本号、短横线或大小写。

模型 ID 必须完全一致

只要模型 ID 和 PotatoAI.cc 控制台展示的不一致,Cursor 就可能无法正常调用模型。

5. 启用并测试 ​

保存并启用模型,在 Chat 或 Agent 中发送一条短请求,确认模型能够正常返回。

账号、内置模型与切换 ​

主题说明
Cursor 账号不需要退出 Cursor 账号。Cursor 登录负责编辑器、同步和 Cursor 自带功能,PotatoAI.cc API Key 只负责对应模型请求。
内置功能并非所有功能都经过 PotatoAI.cc。Tab Completion 等依赖 Cursor 专用模型的功能仍可能使用 Cursor 自带服务。
切回官方模型如果启用了全局 Override OpenAI Base URL,使用官方模型前先关闭该开关;再次使用 PotatoAI.cc 时重新开启。
免费版限制Cursor 对自带 API Key、Agent 和 Edit 的可用范围可能受当前套餐限制,具体以 Cursor 客户端提示为准。

常见问题 ​

现象处理方式
没有 Verify 按钮部分新版本保存后自动生效。直接选择已添加模型发送短消息,并到 PotatoAI.cc 用量日志确认请求。
model not found从控制台重新复制完整模型 ID,并确认当前账户分组拥有该模型权限。
官方模型也开始报错关闭 Override OpenAI Base URL 后重试;该设置在部分版本中会影响其他 OpenAI 模型。
Network error / TLS 错误确认地址为 https://www.potatoai.cc/v1;再到 Network 设置将 HTTP Compatibility Mode 切到 HTTP/1.1 测试。
配置成功但 Tab 仍未走 PotatoAI.cc这是 Cursor 的产品机制;自定义 API Key 主要用于支持的聊天模型,Tab Completion 可能继续使用内置模型。

建议 ​

单独创建 Cursor 密钥

为 Cursor 单独创建一个 API Key,便于按客户端查看用量、轮换密钥或单独停用。