工具接入
Cursor
在 Cursor 中通过自定义 OpenAI 地址使用 AIPUT 的对话模型。
模型调用暂未开放
本页内容用于接入准备。调用开放后,请使用你自己的可用 Key,并把示例中的模型占位值换成模型广场中实际开放的型号。
需要哪种接口
普通对话(OpenAI Chat Completions)。在模型广场的「端点类型」里选择 Chat,从列出的模型中选择。
开始之前
配置步骤
打开模型设置
在 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 的名称和商标归其所有者所有,这里只表示兼容。