协议说明
Cursor 的自定义 API Key 路径只支持 OpenAI 兼容模式,不支持 Anthropic Messages 协议。因此本文档只覆盖 OpenAI 模式,Base URL 固定为https://api.haitoken.ai/v1。
Cursor 这条接入链路以图形界面操作为主,Windows、macOS、Linux 的核心步骤通常一致。不同系统下如果菜单位置、窗口标题或按钮文案略有差异,请以当前版本实际 UI 为准,但
API Key、Base URL 和 Model ID 的填写逻辑不变。配置步骤
- 先准备好 HaiToken API Key,并确认目标模型已经在 HaiToken 中可用。
- 打开 Cursor,进入 Settings > Cursor Settings > Models。
- 在 OpenAI API Key 中填入你的 HaiToken API Key。
- 打开 Override OpenAI Base URL,填入
https://api.haitoken.ai/v1。 - 如果要使用的模型已在 Cursor 模型列表中,直接在聊天面板或模型选择器中选择它即可,不需要重复添加。Base URL 覆盖后,这些模型的聊天请求也会通过 HaiToken。
- 只有要使用的模型不在 Cursor 列表中时,才在同一页面的 Add or search model 输入 HaiToken 模型 ID(例如
gpt-5.4),并点击 Add Custom Model 添加。 - 保存设置后,切换到要使用的模型。
验证步骤
- 在 Cursor 中打开任意项目,然后打开 AI 聊天面板。
- 选择要使用的模型;它可以是 Cursor 现有模型,也可以是刚添加的自定义模型。
- 发送一个简单问题,例如“请解释当前文件的作用”。
- 如果可以正常返回结果,说明 Cursor 的聊天模型路径已经可以使用你填写的 HaiToken 配置。
补充说明
这里推荐填写的 Base URL 是
https://api.haitoken.ai/v1。这表示你在 Cursor 中使用的是 OpenAI 兼容接入方式,而不是某个单独接口地址。
Base URL 覆盖生效后,Cursor 列表中已有模型的聊天请求也会通过 HaiToken。只有目标模型不在列表中时,才需要在 Add or search model 手动输入模型 ID 并添加。
常见问题
下一步
- 查看 获取 API Key
- 查看 OpenAI 格式 API 文档
- 查看 模型列表