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 参数取值相同),例如 qwen-plus
    • 可能与 Cursor 内置模型名冲突的模型(如 Kimi、GLM 等带点号的 ID):填 内置别名(见下文「内置别名」),勿直接填原始模型 ID
<MODEL_ID>          # 一般模型
kimi-k2-6           # 冲突模型请用内置别名,勿填 kimi-k2.6
  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;与 Cursor 内置模型名可能冲突的模型(如 Kimi、GLM)填 内置别名。勿填展示名或上游供应商原始模型名。
  3. Tab 自动补全不受影响:Cursor Tab 通常仍使用 Cursor 自带能力,自定义模型主要用于 Chat / Agent / Edit。
  4. 网络异常时:如果模型无返回,可尝试切换 Cursor 的网络设置,或先用 curl 验证 JellyToken API 是否可达。
  5. thinking 模型:使用 qwen / deepseek / glm 等支持思考的模型时,务必使用 /cursor/v1 端点。标准 /v1 端点会原生透传 reasoning_content 字段,Cursor 不识别该字段,可能导致推理过程不显示或长时间无响应。
  6. 内置别名:部分模型 ID 与 Cursor 内置模型名冲突时,请使用 JellyToken 提供的内置别名,勿在 Cursor 中直接填写原始模型 ID(详见下文)。

内置别名(避免与 Cursor 内置模型名冲突)

Cursor 在添加自定义 OpenAI 兼容模型时,会对部分模型名做特殊处理或校验。直接填写 kimi-k2.6glm-5.2 等带点号的模型 ID 时,请求可能无法正常到达 JellyToken。

JellyToken 为此提供了内置别名:在 Cursor 自定义模型中填写别名(而非原始模型 ID),服务端会自动映射到真实模型。固定别名无需 jellytoken switch,添加后即可使用。

Cursor 中填写的别名实际调用的模型 ID类型
jellytokenqwen3.7-max(默认)可切换,见 jellytoken CLI
kimi-k2-7-codekimi-k2.7-code固定映射
kimi-k2-6kimi-k2.6固定映射
glm-5-2glm-5.2固定映射
glm-5-1glm-5.1固定映射

使用方式

  1. 在 Cursor 模型列表中添加自定义模型,模型名填上表中的别名(例如 kimi-k2-6,不要填 kimi-k2.6
  2. 启用并在聊天面板中选择该别名即可

固定别名(kimi-k2-*glm-5-*)开箱即用,无需安装 CLI。jellytoken 别名可通过 jellytoken switch <model-id> 切换映射,适合需要灵活换模型的场景。

查看当前账号下全部别名(含自定义别名):

jellytoken alias

内置固定别名不可通过 jellytoken alias --create 创建或修改。如需其他占位名,可用 jellytoken alias --create <alias-name> [--model <model-id>] 创建自定义别名,再在 Cursor 中添加同名模型。


相关文档


常见问题

1. Kimi / GLM 等模型在 Cursor 中配置后调用不通

问题原因:Cursor 在自定义 OpenAI 兼容模型时,内部会对部分模型名做特殊处理或校验,导致直接填写 kimi-k2.6kimi-k2.7-codeglm-5.2 等带点号的模型 ID 时,请求无法正常到达 JellyToken。

推荐方案(内置别名)

在 Cursor 自定义模型中填写内置别名,勿填原始模型 ID:

想用的模型Cursor 中填写
kimi-k2.6kimi-k2-6
kimi-k2.7-codekimi-k2-7-code
glm-5.2glm-5-2
glm-5.1glm-5-1

完整列表见上文「内置别名」章节。固定别名无需安装 CLI,添加后即可使用。

备选方案(jellytoken 占位别名)

若需通过单一占位名灵活切换多个模型,可使用 jellytoken 别名:

  1. 在 Cursor 自定义模型中添加 jellytoken
  2. 安装并配置 jellytoken CLI 后执行:
jellytoken switch kimi-k2.6
  1. 在 Cursor 聊天时选择 jellytoken

自定义占位名:jellytoken alias --create <alias-name> [--model <model-id>],再在 Cursor 中添加同名模型。内置固定别名(kimi-k2-*glm-5-*)不可创建或修改。