Cursor 接入 EXAIV:自定义 API 配置与模型选择指南
在 Cursor 中配置 EXAIV 为自定义 OpenAI 兼容端点:Override Base URL 填法、API Key 填写、模型名添加与验证步骤,以及遇到 404/401 时的排查顺序。让 Cursor 的 AI 对话用上国产模型。
Cursor 接入 EXAIV:自定义 API 配置与模型选择指南
Cursor 是当下最流行的 AI 代码编辑器,除了内置模型,它还允许把「OpenAI」通道指向任意兼容端点——这意味着你可以让 Cursor 的 AI 对话使用 EXAIV 上的模型(Kimi、GLM 等国产开源模型),一个 Key 统一管理。本篇给出字段级配置步骤和验证方法。
配置步骤
准备 API Key
在 EXAIV 控制台生成 API Key(只完整显示一次,立即保存)。打开 Cursor 模型设置
Cursor 设置 → Models 页面,找到 OpenAI API Key 区域。覆盖 Base URL
开启 Override OpenAI Base URL 开关,填入https://exaiv.com/api/ai/v1。填写 API Key
把 EXAIV 的 Key 粘贴到 OpenAI API Key 输入框。添加模型
点击 Add model,输入要用的模型 ID(如kimi-k3),保存后在对话的模型选择器里选中它。
模型 ID 以目录为准
可用模型 ID 以 EXAIV 的 /models 目录实时数据为准。写进 Cursor 的模型名必须是目录里真实存在的 ID,把 HuggingFace 上的权重名(如 moonshotai/Kimi-K3)填进去会直接请求失败。
验证连通
配置完成后,在 Cursor 里发起一次普通对话(不要直接改代码),确认模型能正常回应。如果失败,按下面的顺序排查:
| 现象 | 检查项 | 修复 |
|---|---|---|
| 401 | Key 是否完整、有无空格 | 重新生成 Key 并粘贴 |
| 404 | Base URL 是否写成 /api/ai/v1(不多不少) | 修正 URL 路径 |
| 模型不存在 | 模型 ID 是否在目录中 | 到 /models 核对真实 ID |
| 超时 | 网络链路、请求是否过大 | 缩短上下文重试 |
自定义端点的作用范围
Cursor 的部分能力(如 Tab 补全)与官方模型深度绑定,自定义 Base URL 主要作用于聊天类请求。以 Cursor 当前版本文档为准,不要把「所有功能都能走自定义端点」当作预期。
推荐的模型搭配
| 用途 | 模型 | 说明 |
|---|---|---|
| 代码问答、解释报错 | kimi-k3 | 长上下文适合贴大段代码 |
| 工具类规划、多步任务 | glm-5.3-flash | 工具调用稳定 |
| 日常补全类对话 | 目录中的轻量模型 | 以 /models 实时为准 |
一个 Key 可调用目录内全部模型,切换只改模型名——这是自定义端点方案最省心的地方。
FAQ
配置后 Cursor 会不会把我的代码上传?
请求会发往你配置的端点,用于生成回复——这是任何 AI 编码工具的固有行为。选择 EXAIV 并不意味着代码不外发;如果你的项目涉密,应先评估工具与端点的数据处理策略,或改用本地部署方案。
为什么 Tab 补全还是用官方模型?
Cursor 的部分功能与官方模型绑定,自定义 Base URL 主要作用于聊天请求。具体以 Cursor 当前版本的设置面板说明为准。
可以同时配置多个模型切换吗?
可以。在 Add model 里逐个添加目录中的模型 ID,对话时用模型选择器切换即可。
404 和 401 该先查哪个?
按「Key → URL → 模型 ID」的顺序排查。401 是 Key 问题,404 通常是 URL 路径问题,提示模型不存在则是 ID 问题。
价格在哪里看?
按 token 计费,实时价格与充值套餐见定价页;本文只讲配置,不写会过时的数字。
相关阅读
- Kimi K3 与 GLM 接入指南 — API 接入完整教程
- Qwen 本地编码工作流 — 本地编码助手方案
- Qwen API 排障 — 报错排查详解
- Continue 接入 EXAIV — 另一个开源编码助手
- 定价 — 实时价格与充值套餐