AIPUT 文档
工具接入

Cursor

在 Cursor 中通过自定义 OpenAI 地址使用 AIPUT 的对话模型。

更新于

模型调用暂未开放

本页内容用于接入准备。调用开放后,请使用你自己的可用 Key,并把示例中的模型占位值换成模型广场中实际开放的型号。

需要哪种接口

普通对话(OpenAI Chat Completions)。在模型广场的「端点类型」里选择 Chat,从列出的模型中选择。

开始之前

  1. 完成实名认证,认证通过后重新登录一次。
  2. 在主站「API 密钥」页面创建一把 Key,复制并妥善保存。
  3. 在模型广场的「端点类型」筛选里选择 Chat(窄屏时点“筛选”按钮),从列出的模型中复制模型 ID。

配置步骤

打开模型设置

在 Cursor 中打开 Cursor Settings → Models。

填写 Key 和地址

在 API Keys 区域的 OpenAI API Key 中填入你的 AIPUT Key,打开 Override OpenAI Base URL,填入 https://api.aiput.top/v1。

添加模型

在模型列表中添加一个自定义模型,名称填模型广场里的模型 ID,并确认它处于启用状态。按钮名称以你使用的 Cursor 版本为准。

选择模型

在对话面板的模型选择器中,选中刚添加的模型。

怎样确认配置成功

在对话面板选中这个模型,发一句简短的问题,能收到回复就说明配置成功。回到主站的使用日志,也能看到这次调用。

Cursor 自身的限制

  • 自定义 Key 只用于对话类模型。Tab 补全仍使用 Cursor 自己的模型,不经过 AIPUT。
  • 请求会先经过 Cursor 的服务器,再发到 AIPUT。
  • 打开 Override OpenAI Base URL 后,Cursor 其他走 OpenAI 通道的请求也可能发往这个地址。改用 Cursor 自带的模型时,先关闭这个开关。
  • Cursor 官方说明,团队版和企业版用自己的 Key 发起的请求,Cursor 仍会按它的费率另外收费。
  • 不同 Cursor 套餐和功能对自定义模型的支持情况,以 Cursor 官方说明为准。

常见问题

现象处理
提示模型无效或不存在核对模型名与模型广场里的模型 ID 完全一致,并确认该模型在「端点类型」里属于 Chat
401 或"无效的令牌"重新复制 Key,注意不要带上空格
404地址只写到 /v1,不要写成 /v1/chat/completions
提示无法解析返回内容地址少写了 /v1
"无可用渠道"账户还没有实名认证、模型 ID 写错,或模型当前不可用,见常见问题

本页按 2026 年 10 月的 Cursor 版本编写,界面和配置项可能随版本变化,以 Cursor 官方说明为准。Cursor 的名称和商标归其所有者所有,这里只表示兼容。