4SToken
返回编程工具
桌面客户端

Cursor

半自动：引导 Add Custom Model（spt-* 与 openrouter-free）

/v1/chat/completions半自动向导docs/ai-gateway-editor-cursor.md
创建 API Key
Base URLhttps://api.4stoken.cn
鉴权方式Authorization: Bearer sk-...
协议/v1/chat/completions
Download

下载安装教程

先安装工具本体，再运行 4SToken 配置脚本。Windows 与 macOS / Linux 分开操作。

官方下载 / 安装入口
安装前准备
准备已安装 Cursor
准备已创建 Portal Client Key
准备准备一个 Cursor 模型 Key，如 spt-5.5 或 openrouter-free
Windows
1下载 Windows 安装包并完成安装
2运行本页 PowerShell 向导，记录 Base URL、Key、模型名
3进入 Settings → Cursor Settings → Models，打开 OpenAI API Key 与 Override OpenAI Base URL，Base URL 填 https://api.4stoken.cn/v1
4在聊天框模型下拉中点击 Add Models，输入 spt-* 或 openrouter-free，按 Enter 添加并启用
macOS / Linux
1macOS 下载 dmg，Linux 下载 AppImage 或发行版包
2运行本页 bash 向导，记录 Base URL、Key、模型名
3进入 Models 设置，打开 OpenAI API Key 与 Override OpenAI Base URL，Base URL 填 https://api.4stoken.cn/v1
4在聊天框模型下拉中点击 Add Models，输入 spt-* 或 openrouter-free，按 Enter 添加并启用
Visual Guide

Cursor 图文操作指南

按图文步骤完成三件事：配置 URL 和 Key、进入 Add Models、输入模型 Key 并启用。

配置 URL 和 Key
1配置 URL 和 Key在 Cursor Settings → Models 中展开 API Keys，先把网关凭据填好。
进入添加模型入口
2进入添加模型入口回到聊天或 Composer 输入框，点击当前模型名旁边的下拉箭头。
输入模型 Key 并启用
3输入模型 Key 并启用在 Add or search model 输入框填 Cursor 专用模型 Key，按 Enter 添加。 查看模型 Key 对照
Verify

Verify

按顺序检查：先测接口连通，再做模拟调用，最后回到具体软件核对配置是否真正生效。

连通性检查

先确认 Key、Base URL 与模型列表接口可达。

执行模型列表查询，确认返回 200 且能看到可用模型
curl https://api.4stoken.cn/v1/models -H "Authorization: Bearer YOUR_API_KEY"

模拟调用

绕开客户端先打一次最小请求，确认网关协议与模型路由正确。

执行最小请求，确认没有 401、403、404、模型不存在或无路由错误
curl https://api.4stoken.cn/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"model\":\"openrouter-free\",\"messages\":[{\"role\":\"user\",\"content\":\"hello\"}]}"

其他

回到具体软件内确认配置文件、界面设置或重启步骤已经生效。

Cursor 中新建一次 Ask / Agent 请求
确认 Override OpenAI Base URL、Custom Model 与返回内容一致
Models

模型 Key 对照

GPT 模型按 gpt- → spt-，OpenRouter 直接填 openrouter-free。

Cursor model Key系统实际模型协议说明
spt-5.5gpt-5.5/v1/chat/completionsAdd Models 时填写 spt 别名
spt-5.4gpt-5.4/v1/chat/completionsAdd Models 时填写 spt 别名
spt-5.4-minigpt-5.4-mini/v1/chat/completions轻量 GPT 档位
openrouter-freeopenrouter-free/v1/chat/completionsOpenRouter 直接填 modelCode

以上列表来自 Portal 已发布模型；客户端里优先填写表格第一列。完整可用范围仍以 GET /v1/models 与「模型与价格」页为准。

Notes

接入边界

  • 脚本仅修改本机工具配置文件，可通过上方源码链接审计。
  • 执行前可设置 GATEWAY_BASE_URL 覆盖默认网关地址。
  • 该工具需要在客户端内完成最终确认或 Add Models。
  • GET /v1/realtime 未开放，不影响编程工具接入。