Cursor（接入 SuperToken）
Cursor 是常用的 AI 代码编辑器。通过 Cursor 的 OpenAI API Key 和自定义 Base URL，可以把部分聊天和编辑类请求接入 SuperToken。
你需要准备
Cursor 通过 OpenAI 兼容方式接入 SuperToken。配置时只需要填两项：API Key 和 Base URL。
YOUR_SUPERTOKEN_API_KEYhttps://api.supertoken.cc/v1前置要求
Cursor 的自定义 API Base URL 通常需要 Pro、Business 或 Enterprise 订阅。如果 Free 版账号在 Models 页面看不到 Override OpenAI Base URL 开关，就无法按此方式接入 SuperToken。可在 Cursor -> Settings -> Account 查看订阅状态。
TIP
Cursor 官方说明中，自带 API Key 主要用于聊天模型；Tab 补全等内置能力可能继续使用 Cursor 自带模型。
配置步骤
打开模型设置
进入 Settings -> Cursor Settings -> Models。不同版本入口名称可能略有差异，核心是找到 Models 页面。
填写 API Key
在 API Keys 区域打开 OpenAI API Key 开关，粘贴你的 SuperToken API Key。
不要带空格或换行。Key 错误时，Cursor 有时会显示成限流或模型不可用。
填写 Base URL
打开 Override OpenAI Base URL，填写 https://api.supertoken.cc/v1。
必须带 /v1。不要填成根域名，也不要填完整的 /chat/completions 接口路径。
添加自定义模型
在 Models 页面添加并启用自定义模型。Cursor 使用 gateway-oai-* 这类专用模型名，例如 gateway-oai-5.5 对应 gpt-5.5。如果需要指定思考等级，可以在后面追加等级后缀，例如 gateway-oai-5.5-xhigh。
不要直接填写 gpt-*、claude-*、o1-*、o3-* 或 chatgpt-* 这类原生模型名。Cursor 可能把它们识别成内置模型或应用本地限制，请求不一定发到 SuperToken Base URL。
选择模型并测试
回到聊天面板，关闭顶部的 Auto，在模型下拉中选择刚添加的模型，发送一条简单消息验证。
Cursor 模型名怎么填
Cursor 里添加的模型名应使用 SuperToken 为 Cursor 准备的 gateway-oai-* 专用名称。具体可用模型以 官网模型广场 和控制台展示为准，常见写法如下：
| Cursor 里填 | 对应模型 | 说明 |
|---|---|---|
gateway-oai-5.5 | gpt-5.5 | 默认思考等级 |
gateway-oai-5.5-xhigh | gpt-5.5 | 最高思考等级 |
gateway-oai-5.4 | gpt-5.4 | 默认思考等级 |
思考等级通过模型名后缀表达。支持的等级以模型广场为准；如果支持 -xhigh，就可以使用类似 gateway-oai-5.5-xhigh 的写法。
WARNING
不要把原生模型名直接填到 Cursor 自定义模型里，例如 gpt-5.4、gpt-5.5、claude-sonnet-*。Cursor 可能把这些名称当作内置模型处理，导致请求没有进入 SuperToken。
常见问题
| 现象 | 处理方式 |
|---|---|
找不到 Override OpenAI Base URL | 当前 Cursor 版本或账号可能不支持自定义 OpenAI Base URL。优先确认是否为 Pro、Business 或 Enterprise 订阅，再升级 Cursor 后检查 Models 设置。 |
| 返回 HTML 或 404 | Base URL 填错了。Cursor 里应填写 https://api.supertoken.cc/v1，不是完整接口路径。 |
| 401 / Invalid token | API Key 不正确、已失效，或复制时带入了空格。重新到 SuperToken 控制台复制 Key。 |
| 429 / Rate Limit | 可能是请求频率过高、余额不足、模型分组不可用，或 Cursor 因模型名触发本地限制。先确认模型名是否使用了 Cursor 专用别名，再用下方 curl 命令验证 Key。 |
| 请求没有进入 SuperToken | 检查是否直接填了 gpt-*、claude-*、o1-*、o3-* 或 chatgpt-* 原生名。改用 gateway-oai-* 专用模型名。 |
| 聊天面板找不到模型 | 确认 Models 页面中该自定义模型的开关已开启，并关闭聊天面板顶部的 Auto。 |
| Tab 补全没有走 SuperToken | Cursor 的 Tab 补全可能继续使用 Cursor 内置模型，这是 Cursor 自带 API Key 模式的限制。 |
用 curl 验证 Key
如果 Cursor 报错，先用终端直接验证 SuperToken Key 和模型列表：
curl https://api.supertoken.cc/v1/models \
-H "Authorization: Bearer YOUR_SUPERTOKEN_API_KEY"如果这里能返回模型列表，说明 Key 和 SuperToken 网关正常，问题通常在 Cursor 设置项。
这仍不证明 Cursor 已保存并使用该配置。重新打开 Cursor，关闭 Auto，明确选择 gateway-oai-* 模型，再发送请求并核对 SuperToken 控制台记录。
切回 Cursor 自带模型
在 Settings -> Cursor Settings -> Models 中：
- 关闭
OpenAI API Key。 - 清空
Override OpenAI Base URL。 - 删除或关闭自定义模型。
- 回到聊天面板，重新打开
Auto或选择 Cursor 内置模型。