Cursor 接入 UniRoute
在 Cursor Models 中配置 UniRoute API Key、OpenAI Base URL 和自定义聊天模型，检查调用并处理常见错误。
Cursor 接入 · 按量 API
在 Cursor 的 Models 设置中填入 UniRoute Key 与 OpenAI 兼容地址，再添加自定义模型用于 Chat 对话。
适合：在 Cursor 中进行代码问答与对话的开发者。
快速配置
登录后可一键创建 Key 并自动填入 登录
打开 Cursor Settings → Models，逐项复制；Override OpenAI Base URL 需要同时启用。
OpenAI API Key
YOUR_UNIROUTE_API_KEYOverride OpenAI Base URL
https://api.uniroute.app/v1Add Custom Model
deepseek-v4-flash配置步骤
1. 打开 Models 设置
打开 Cursor Settings → Models，找到 OpenAI API Key。
自定义模型需要 Cursor 付费套餐权限。
2. 保存 Key 并覆盖地址
在 OpenAI API Key 粘贴上方 Key，点击 Save。启用 Override OpenAI Base URL，填写 https://api.uniroute.app/v1。
此地址覆盖所有 OpenAI 模型；切回其他服务时一并恢复原地址与 Key。
3. 添加自定义模型
点击 Add Custom Model，填写 deepseek-v4-flash，保存模型并启用它。模型 ID 保持完整，不添加供应商前缀。
4. 在 Chat 中选中模型
新建聊天，选择 Ask，在模型选择器中明确选中 deepseek-v4-flash，再发送消息。
自定义 Key 用于 Chat；Tab 补全继续使用 Cursor 模型。
这几个变量分别做什么
| 字段 | 用途 |
|---|---|
| OpenAI API Key | 在兼容接口中使用 UniRoute Key 认证。 |
| Override OpenAI Base URL | OpenAI 供应商的全局接口地址；使用上方公网 HTTPS 地址。 |
| Add Custom Model | 填写 API 实际使用的完整模型 ID。 |
| Ask | 首次连接检查使用的 Chat 模式。 |
选择模型
怎么确认已经切过来了
发送一句测试：只回复 OK。
打开 用量日志，查看模型、请求状态与扣费。测试会产生实际 API 费用。
切回原配置 / 恢复备份
打开 Cursor Settings → Models，关闭 Override OpenAI Base URL 或恢复原地址，恢复原服务的 Key，再从聊天中选回原模型。
还没安装？
从 Cursor 官方下载页安装对应系统的应用，打开项目后进入 Cursor Settings。
常见问题
每个模型能单独配置地址吗？
OpenAI Base URL 覆盖是全局设置。切换供应商时，恢复对应地址与 Key。
可以填本地或内网地址吗？
使用 https://api.uniroute.app/v1；Cursor 从其服务器访问该公网接口。
UniRoute 与 Cursor 怎样计费？
UniRoute 按 API 用量计费。Cursor 套餐权限独立管理；Teams 与 Enterprise 的部分 BYOK 请求还会计入 Cursor Token Rate。
常见错误
模型不适用于当前套餐或 Key
Cursor 套餐权限或当前模型选择需要调整。
检查 Cursor 付费套餐权限，并在 Ask 中选中自定义模型。
401
Key 不完整、已撤销或未保存。
在 OpenAI API Key 重新粘贴有效 Key，点击 Save。
连接失败 / 404
Base URL 或覆盖开关设置有误。
启用 Override OpenAI Base URL，并填写 https://api.uniroute.app/v1。
其他 OpenAI 模型报错
全局覆盖仍指向 UniRoute。
切回相应服务时恢复该服务的地址与 Key。
相关链接
管理 API Key
· 协议与地址 ·
模型价格