Cursor 接入
Cursor 如何接入 VC API
Cursor 的模型配置取决于版本和当前分组。先确认 VC API 提供的兼容接口与模型，再在 Cursor 的模型设置中填写地址和密钥。
先确认版本和模型
- 打开 VC API 模型广场，确认目标模型和分组是否开放。
- 在 API 密钥页面点击“使用”，获取当前分组的 Base URL 和推荐配置。
- 确认你的 Cursor 版本支持自定义模型或兼容 OpenAI 的 API 设置。不同版本的设置名称可能不同。
Cursor 的自定义入口可能随版本变化。找不到对应设置时，先升级到稳定版本，再以客户端界面为准。
填写地址和密钥
在 Cursor 的模型或 API 设置中，按控制台提供的协议填写。OpenAI 兼容接口通常使用带 /v1 的地址，认证使用 API Key；如果你的分组弹窗给出专用地址，优先使用弹窗内容。
| 字段 | 填写内容 |
|---|---|
| Base URL | https://sub.vcnovb.cn/v1（以控制台实际配置为准） |
| API Key | VC API 控制台生成的密钥，不要填账号密码 |
| Model | 模型广场或密钥配置中实际支持的模型 ID |
保存后先选择一个文本模型测试短消息，不要直接进行大批量索引或长上下文调用。
验证请求是否走到 VC API
- 在 Cursor 中发送一条短消息，观察是否正常返回。
- 打开 VC API 控制台的用量记录，按时间和密钥核对请求。
- 如果 Cursor 能回答但控制台没有记录，说明请求可能仍走默认服务；检查当前模型的 Provider 或 API 设置。
常见问题
- 401：重新复制 Key，确认保存的是当前密钥，并检查是否有空格。
- 404：检查 Base URL 是否多写了
/chat/completions，或模型 ID 不在当前分组。 - 429：检查额度、并发和限流，避免连续自动重试。
- 图片或工具不可用：OpenAI 兼容不代表所有模型能力都相同，请以模型广场的能力说明为准。
参考与下一步
本文只说明接入思路，实际模型、地址、权限和价格以 VC API 控制台当前配置为准。不要把 API Key 粘贴到公开内容中。