Cursor 的设置界面和自定义接口能力会随版本、套餐与模型提供商变化。官方说明中,自定义 API Key 主要用于标准聊天模型;部分专用功能仍可能使用 Cursor 自带模型。先确认当前版本确实提供对应提供商或 Base URL 入口,再进行配置。
开始前检查
- 用 curl 调用
/v1/models,确认 Key 有效。 - 复制真实模型 ID,不使用网页展示名。
- 在 Cursor 当前版本中确认是否存在目标提供商或自定义 Base URL 入口;如果界面没有该选项,不要照搬旧版教程。
配置步骤
在 Cursor 的模型或 API 设置中查找 API Keys、OpenAI API Key 或 Base URL 相关选项。不同版本显示可能不同,且自定义 Key 不代表所有 Agent 功能都会走该接口。
建议参数:
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,方便统计用量和撤销权限。涉及私有仓库时,不要把敏感源码发送到未经评估的模型或服务。