Cursor 的设置界面和自定义接口能力会随版本、套餐与模型提供商变化。官方说明中，自定义 API Key 主要用于标准聊天模型；部分专用功能仍可能使用 Cursor 自带模型。先确认当前版本确实提供对应提供商或 Base URL 入口，再进行配置。
快速结论
Cursor 显示 “API Key Valid” 只代表认证检查可能通过，不代表 Agent、模型映射和工具调用都使用该接口。配置后必须从请求日志核对最终域名、路径和模型 ID，再分别测试普通聊天与 Agent 任务。
开始前检查
- 用 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.hk/v1
Model: YOUR_MODEL_ID填写后先发送一句可精确核对的短消息：
只回复：CURSOR_API_OK检查响应是否严格包含预期文本，并从请求日志核对最终地址与响应 model 字段。不要根据模型在正文中的自述判断身份。短请求成功后，再测试读取文件、修改代码和长上下文任务。
判断是否重复追加 /v1
如果 Cursor 日志显示：
https://www.aifast.hk/v1/v1/chat/completions将 Base URL 改为：
https://www.aifast.hk是否保留 /v1 取决于当前客户端是否自动追加路径，以实际请求日志为准。
常见问题
API Key Valid，但对话失败
“Key 验证成功”只说明身份验证可能通过，不代表当前模型名、请求协议和功能模式都兼容。继续查看具体请求的状态码和响应正文。
model not found
- 模型 ID 拼写是否完全一致。
- 模型是否支持当前接口类型。
- 客户端是否把自定义模型名替换成内置别名。
Agent 模式失败，普通聊天成功
Agent 模式可能依赖工具调用、长上下文或特定响应字段。先验证普通聊天，再确认所选模型是否支持工具调用，不要只根据文本对话成功就判断全部功能兼容。
下一步
为 Cursor 单独创建一个 API Key，方便统计用量和撤销权限。涉及私有仓库时，不要把敏感源码发送到未经评估的模型或服务。
如果当前使用的是社区协议转换项目，而不是 Cursor 官方自定义 Key，请先阅读 Cursor2API 常见报错、风险检查与标准 API 迁移，区分上游入口变化、转换层问题和客户端能力边界后再迁移。