Skip to content

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 URLhttps://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 功能、模型或第三方插件都可用。

API access is subject to the AIShop service terms.