立即注册

Cursor 接入 JellyToken

Cursor 接入 JellyToken

Cursor 支持配置 OpenAI 兼容接口。将 Cursor 的 OpenAI Base URL 指向 JellyToken，即可在 Chat / Agent / Edit 中使用已授权模型。

JellyToken 为 Cursor 提供了专用端点 /cursor/v1，对 thinking 模型（qwen / deepseek / glm 等）的 reasoning_content 做降级处理，确保 Cursor 能正常展示推理过程与正式回答。

前提条件

  • Cursor 账号套餐支持自定义模型和自定义 API Key
  • 已在 JellyToken 密钥管理 创建或复制 uas_... API Key
  • 已确认目标 模型 ID，例如 qwen-plus（下文占位符 <MODEL_ID> 请替换为实际值）

配置步骤

  1. 打开 Cursor 设置，进入 Models
  2. 展开 API Keys
  3. 开启 Override OpenAI Base URL
  4. 填入 Base URL（注意使用 /cursor/v1 专用端点）：
https://aiservice.jellytoken.com/cursor/v1

端点选择说明

  • /cursor/v1：Cursor 专用端点。对 thinking 模型（qwen / deepseek / glm 等）会自动把 reasoning_content 包入 content 字段（ thinking / response 标签），避免 Cursor 因只读 content 字段而长时间收不到内容导致超时。Cursor 接入推荐使用此端点。
  • /v1：标准 OpenAI 兼容端点。原生透传 reasoning_content 字段，不污染 content。适合能识别 reasoning_content 的标准 OpenAI SDK 客户端；Cursor 不推荐使用，因为 Cursor 不会读取 reasoning_content，thinking 模型的推理过程会丢失。
  1. 在 OpenAI API Key 中填入 JellyToken API Key：
uas_xxx
  1. 点击启用或验证 API Key
  2. 在模型列表中添加自定义模型，模型名填模型 ID（与 OpenAI 的 model 参数取值相同）：
<MODEL_ID>
  1. 启用该模型，并在聊天面板中选择它

cursor_setting.png

add_model_01.png

add_model_02.png

验证

在 Cursor Chat 中提问：

用一句话说明你当前使用的模型。

如果能正常返回内容，说明 Cursor 已通过 JellyToken 发起调用。

也可以用命令确认 Key 和模型可用（注意 Cursor 专用端点用 /cursor/v1）：

curl -s https://aiservice.jellytoken.com/cursor/v1/models \
  -H "Authorization: Bearer uas_xxx"

注意事项

  1. Override OpenAI Base URL 是全局设置：启用后可能影响 Cursor 内其他 OpenAI Key 或自定义模型。不使用 JellyToken 时可关闭该开关。
  2. 模型名须为模型 ID：勿填展示名或上游供应商原始模型名。
  3. Tab 自动补全不受影响：Cursor Tab 通常仍使用 Cursor 自带能力，自定义模型主要用于 Chat / Agent / Edit。
  4. 网络异常时：如果模型无返回，可尝试切换 Cursor 的网络设置，或先用 curl 验证 JellyToken API 是否可达。
  5. thinking 模型：使用 qwen / deepseek / glm 等支持思考的模型时，务必使用 /cursor/v1 端点。标准 /v1 端点会原生透传 reasoning_content 字段，Cursor 不识别该字段，可能导致推理过程不显示或长时间无响应。

相关文档

常见问题

1. Kimi 系列模型在 Cursor 中配置后调用不通

问题原因：Cursor 在自定义 OpenAI 兼容模型时，内部会对部分模型名做特殊处理或校验，导致直接填写 kimi-k2.6、kimi-k2.7-code 等 Kimi 系列模型 ID 时，请求无法正常到达 JellyToken。

解决方案：

  1. 在 Cursor 自定义模型中添加占位模型名 jellytoken（jellytoken 是 jellytoken CLI 的默认别名）。
  2. 安装并配置 jellytoken CLI 后，使用以下命令将 jellytoken 映射到实际的 Kimi 模型：
jellytoken switch kimi-k2.6

如需切换为其他模型，例如 kimi-k2.7-code：

jellytoken switch kimi-k2.7-code

更多切换模型相关命令见 jellytoken 命令行工具。

  1. 在 Cursor 聊天时选择 jellytoken，即可正常使用对应的 Kimi 模型。

如果需要使用其他占位模型名，可先用 jellytoken alias --create <alias-name> [--model <model-id>] 创建自定义别名映射，再在 Cursor 中添加同名的自定义模型。