工具接入

Cursor 自定义 API 配置教程

为 Cursor 配置 OpenAI Compatible API、Base URL 和模型,并排查 model not found、401 与地址重复问题。

更新于 2026-07-11 预计阅读 7 分钟 适用于 OpenAI Compatible API

Cursor 的设置界面会随版本调整,但验证思路不变:先确认 Key 和模型能通过 API 正常调用,再把相同参数填入 Cursor。不要把客户端界面问题和接口问题混在一起排查。

开始前检查

  1. 用 curl 调用 /v1/models,确认 Key 有效。
  2. 复制真实模型 ID,不使用网页展示名。
  3. 确认当前 Cursor 版本是否提供自定义 OpenAI Base URL 或兼容提供商入口。

配置步骤

在 Cursor 的模型或 API 设置中找到 OpenAI API Key、自定义提供商或 Override Base URL 相关选项。不同版本文字可能不同。

建议参数:

API Key: 你在 AI快站创建的 Key
Base URL: https://www.aifast.club/v1
Model: YOUR_MODEL_ID

填写后先发送一句短消息:

只回复当前模型名称,不要解释。

短请求成功后,再测试读取文件、修改代码和长上下文任务。

判断是否重复追加 /v1

如果 Cursor 日志显示:

https://www.aifast.club/v1/v1/chat/completions

将 Base URL 改为:

https://www.aifast.club

是否保留 /v1 取决于当前客户端是否自动追加路径,以实际请求日志为准。

常见问题

API Key Valid,但对话失败

“Key 验证成功”只说明身份验证可能通过,不代表当前模型名、请求协议和功能模式都兼容。继续查看具体请求的状态码和响应正文。

model not found

  • 模型 ID 拼写是否完全一致。
  • 模型是否支持当前接口类型。
  • 客户端是否把自定义模型名替换成内置别名。

Agent 模式失败,普通聊天成功

Agent 模式可能依赖工具调用、长上下文或特定响应字段。先验证普通聊天,再确认所选模型是否支持工具调用,不要只根据文本对话成功就判断全部功能兼容。

下一步

为 Cursor 单独创建一个 API Key,方便统计用量和撤销权限。涉及私有仓库时,不要把敏感源码发送到未经评估的模型或服务。

准备开始调用?

创建 API Key,按本文配置直接验证

注册后可在控制台查看可用模型、用量和请求记录。

注册使用 查看 API 文档