工具集成 · OpenAI Chat Completions
在 Cursor 中使用 TokenRa
Cursor 支持把对话请求改发到兼容 OpenAI 的接口。填入 TokenRa 的 Base URL 和 API Key 并添加模型后，就能在 Cursor 的 Chat 和 Agent 中使用 TokenRa 的模型；Tab 补全仍使用 Cursor 自带的模型。
- Base URL
https://tokenra.io/v1- 接口格式
- OpenAI Chat Completions
- 设置位置
- Cursor Settings → Models
- 适用功能
- Chat、Agent
Before you start
准备工作
- TokenRa API Key：注册账号后，在控制台的「API 密钥」页面创建。Key 以
sk-开头。 - 已从 cursor.com 安装 Cursor。
Configure
在 Cursor 中配置 TokenRa
- 点击右上角的齿轮图标打开 Cursor Settings，或按
Ctrl+Shift+J（macOS 为Cmd+Shift+J）。 - 进入 Models 页面，下拉到 API Keys 区域。
- 在 OpenAI API Key 中粘贴你的 TokenRa API Key，并打开它的开关。
- 打开 Override OpenAI Base URL，填入
https://tokenra.io/v1。 - 添加自定义模型，名称填 TokenRa 的模型 ID（例如
deepseek-v4.1-flash），并确认已启用。Cursor 会原样发送你填写的名称。 - 打开 Chat（
Ctrl+L，macOS 为Cmd+L）或 Agent，选择该模型后发送消息。
| 配置项 | 填写内容 |
|---|---|
| OpenAI API Key | 你的 TokenRa API Key（sk-...） |
| Override OpenAI Base URL | https://tokenra.io/v1，需要带 /v1 |
| 自定义模型名称 | TokenRa 模型 ID，例如 deepseek-v4.1-flash |
Scope
哪些功能会走 TokenRa
- Chat 和 Agent 使用你选择的 TokenRa 模型。
- Tab 补全仍使用 Cursor 自带的模型：Cursor 官方文档说明，自定义 API Key 只用于对话模型。
- 请求由 Cursor 的服务器发出。Cursor 先在服务端组装提示词，再用你的 Key 调用 TokenRa。Cursor 表示不会保存该 Key。
- Base URL 覆盖对所有 OpenAI 格式的请求生效。开启期间，Cursor 自带的 OpenAI 系列模型也会被发到 TokenRa 并调用失败。切回 Cursor 内置模型时，请关闭该开关。
来源：Cursor 官方文档：API Keys，以及 Cursor 工作人员确认上述路由行为的论坛帖子（2026 年 9 月）。
Models
可用模型
Cursor 通过 OpenAI Chat Completions 接口调用 TokenRa。2026-10-29，以下模型均在 https://tokenra.io/v1/chat/completions 上完成了流式工具调用的完整往返：发起工具调用、收到结果并据此作答。
| 模型 | 模型 ID |
|---|---|
| DeepSeek V4.1 Flash | deepseek-v4.1-flash |
| DeepSeek V4.1 Flash 1017 | deepseek-v4.1-flash-1017 |
| MiniMax M3.1 Flash | minimax-m3.1-flash |
| MiniMax M3 | minimax-m3 |
| GLM-5.3 | glm-5.3 |
| GLM-5.3 Flash | glm-5.3-flash |
| GLM-5.3 FlashX | glm-5.3-flashx |
| Kimi K3 | kimi-k3 |
| Kimi K3.1 Pro | kimi-k3.1-pro |
| Qwen3.8 Max | qwen3.8-max |
| Qwen3.8 Flash | qwen3.8-flash |
| MiMo V2.5 | mimo-v2.5 |
| Omen Alpha | omen-alpha |
实测范围
我们实测的是 Cursor 调用的 TokenRa 接口，而不是 Cursor 应用本身。上文的菜单名称以 2026 年 10 月的 Cursor 设置为准，不同版本可能有所变化。
不适用的模型
gemini-3.8-flash 不能用于此类工具：它的上游会拒绝所有带工具定义的请求（HTTP 400），而编程助手的每个请求都带有工具。FAQ
常见问题
Cursor 自带的模型不能用了
这是 Base URL 覆盖导致的：开启后所有 OpenAI 格式的请求都会发到 TokenRa。使用 Cursor 自带模型时请关闭 Override OpenAI Base URL，换回 TokenRa 模型时再打开。
报错 401 或 503 model_not_found
401 说明 Key 有误，或 Base URL 缺少 /v1。503 model_not_found 说明自定义模型名称不是 TokenRa 的模型 ID，请从模型列表中复制。
Tab 补全会使用 TokenRa 吗？
不会，Tab 补全始终使用 Cursor 自己的模型。
TokenRa 的零数据保留对 Cursor 有效吗？
它只覆盖经过 TokenRa 的这一段（见零数据保留）。请求还会经过 Cursor 的服务器，而 Cursor 官方文档说明，使用自己的 API Key 时，Cursor 的零数据保留政策不适用。