Cursor
Cursor 可使用 OpenAI-compatible 地址。本页配置的是标准兼容入口;不同 Cursor 版本的设置项名称可能变化,因此以当前版本的 Models 或 Provider 设置为准。
开始前
从 Cursor 当前官方发布页安装适用于 Windows、macOS 或 Linux 的版本。为 Cursor 创建独立 API Key,随后查询当前模型:
bash
curl 'https://ai.tavonilo.com/v1/models' \
-H "Authorization: Bearer $AI_SHOP_API_KEY"只使用响应中的 data[].id。不要把 Key 粘贴到项目配置、截图、工单或仓库。
配置
在 Cursor 的模型或供应商设置中选择 OpenAI-compatible / Custom OpenAI 类配置,并填写:
| 字段 | 值 |
|---|---|
| Base URL | https://ai.tavonilo.com/v1 |
| API Key | 新建的独立 API Key |
| Model | /v1/models 返回的模型 ID |
Base URL 不填写完整 /chat/completions 地址,也不要额外追加第二个 /v1。保存后完全重启 Cursor,再从模型选择器选中该模型。
验证与恢复
先发起一个短小、非敏感的编码请求,例如“解释当前函数的输入和输出”。普通请求成功后,再使用工具调用、长上下文或 Agent 模式。
401:检查 Key 是否完整,并确认没有把控制台地址填进 Base URL。403:检查当前 Key 的分组、余额、模型限制或路由权限;重新以模型列表为准。404:通常是 Base URL 重复包含/v1,或客户端把完整路径再次追加。429:降低并发并按Retry-After退避。5xx:仅安全重试,并保留时间、模型、路径、状态和 request ID。
不要将本页描述为 Cursor 官方集成,也不要承诺所有 Cursor 功能、模型或第三方插件都可用。