Cursor 的设置界面会随版本调整,但验证思路不变:先确认 Key 和模型能通过 API 正常调用,再把相同参数填入 Cursor。不要把客户端界面问题和接口问题混在一起排查。
开始前检查
- 用 curl 调用
/v1/models,确认 Key 有效。 - 复制真实模型 ID,不使用网页展示名。
- 确认当前 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,方便统计用量和撤销权限。涉及私有仓库时,不要把敏感源码发送到未经评估的模型或服务。