Skip to main content
Cursor 支持在聊天模型路径中使用自定义 OpenAI 兼容 API Key 与 Base URL。按下面的编号流程配置后,你可以在 Cursor 的聊天能力里尝试使用 HaiToken 提供的模型。

协议说明

Cursor 的自定义 API Key 路径只支持 OpenAI 兼容模式,不支持 Anthropic Messages 协议。因此本文档只覆盖 OpenAI 模式,Base URL 固定为 https://api.haitoken.ai/v1
Cursor 这条接入链路以图形界面操作为主,Windows、macOS、Linux 的核心步骤通常一致。不同系统下如果菜单位置、窗口标题或按钮文案略有差异,请以当前版本实际 UI 为准,但 API KeyBase URLModel ID 的填写逻辑不变。

配置步骤

  1. 先准备好 HaiToken API Key,并确认目标模型已经在 HaiToken 中可用。
  2. 打开 Cursor,进入 Settings > Cursor Settings > Models
  3. OpenAI API Key 中填入你的 HaiToken API Key。
  4. 打开 Override OpenAI Base URL,填入 https://api.haitoken.ai/v1
  5. 如果要使用的模型已在 Cursor 模型列表中,直接在聊天面板或模型选择器中选择它即可,不需要重复添加。Base URL 覆盖后,这些模型的聊天请求也会通过 HaiToken。
  6. 只有要使用的模型不在 Cursor 列表中时,才在同一页面的 Add or search model 输入 HaiToken 模型 ID(例如 gpt-5.4),并点击 Add Custom Model 添加。
  7. 保存设置后,切换到要使用的模型。

验证步骤

  1. 在 Cursor 中打开任意项目,然后打开 AI 聊天面板。
  2. 选择要使用的模型;它可以是 Cursor 现有模型,也可以是刚添加的自定义模型。
  3. 发送一个简单问题,例如“请解释当前文件的作用”。
  4. 如果可以正常返回结果,说明 Cursor 的聊天模型路径已经可以使用你填写的 HaiToken 配置。

补充说明

这里推荐填写的 Base URL 是 https://api.haitoken.ai/v1。这表示你在 Cursor 中使用的是 OpenAI 兼容接入方式,而不是某个单独接口地址。
Cursor 官方对自定义 API Key 的明确支持重点在聊天模型路径。Tab 补全等其他能力仍可能继续使用 Cursor 自带模型,因此不要把这份配置理解为“Cursor 的所有 AI 能力都已经切到 HaiToken”。
Base URL 覆盖生效后,Cursor 列表中已有模型的聊天请求也会通过 HaiToken。只有目标模型不在列表中时,才需要在 Add or search model 手动输入模型 ID 并添加。
这里要填写的是 HaiToken 首页或模型列表中的模型编号(model ID),例如 gpt-5.4,不是展示给用户看的模型名称。复制模型名称通常没有用,容易导致 model not found

常见问题

下一步