- 当前版本已稳定，若发现响应出现缺字漏字，与本程序无关。
- 若发现首字慢，与本程序无关。
- 若发现响应出现乱码，也与本程序无关。
- 属于官方的问题，请不要像作者反馈。
- 本程序拥有堪比客户端原本的速度，甚至可能更快。
- 本程序的性能是非常厉害的。
- 根据本项目开源协议，Fork的项目不能以作者的名义进行任何形式的宣传、推广或声明。
- 目前暂停更新（已更新约3个月,求赞助:），做不下去了都，截至当前版本(v0.1.3-rc.5.2.3)，有事联系 nav@wisdgod.com (因为有人说很难联系到作者..从v0.1.3-rc.5.2.1起添加)。
- 推荐自部署，官方网站 仅用于作者测试，不保证稳定性。
- 访问 www.cursor.com 并完成注册登录
- 在浏览器中打开开发者工具（F12）
- 在 Application-Cookies 中查找名为
WorkosCursorSessionToken的条目，并复制其第三个字段。请注意，%3A%3A 是 :: 的 URL 编码形式，cookie 的值使用冒号 (:) 进行分隔。
PORT: 服务器端口号（默认：3000）AUTH_TOKEN: 认证令牌（必须，用于API认证）ROUTE_PREFIX: 路由前缀（可选）
更多请查看 /env-example
.tokens 文件(已弃用)：每行为token和checksum的对应关系：
# 这里的#表示这行在下次读取要删除
token1,checksum1
token2,checksum2
该文件可以被自动管理，但用户仅可在确认自己拥有修改能力时修改，一般仅有以下情况需要手动修改：
- 需要删除某个 token
- 需要使用已有 checksum 来对应某一个 token
写死了，后续也不会会支持自定义模型列表，因为本身就支持动态更新，详见更新模型列表说明
default
claude-3.5-sonnet
claude-3.7-sonnet
claude-3.7-sonnet-thinking
claude-3.7-sonnet-max
claude-3.7-sonnet-thinking-max
gpt-4
gpt-4o
gpt-4.5-preview
claude-3-opus
cursor-fast
cursor-small
gpt-3.5-turbo
gpt-4-turbo-2024-04-09
gpt-4o-128k
gemini-1.5-flash-500k
claude-3-haiku-200k
claude-3-5-sonnet-200k
gpt-4o-mini
o1-mini
o1-preview
o1
claude-3.5-haiku
gemini-2.0-pro-exp
gemini-2.5-pro-exp-03-25
gemini-2.5-pro-max
gemini-2.0-flash-thinking-exp
gemini-2.0-flash
deepseek-v3
deepseek-r1
o3-mini
grok-2
deepseek-v3.1
grok-3-beta
grok-3-mini-beta
gpt-4.1
支持思考：
claude-3.7-sonnet-thinking
claude-3.7-sonnet-thinking-max
o1-mini
o1-preview
o1
gemini-2.5-pro-exp-03-25
gemini-2.5-pro-max
gemini-2.0-flash-thinking-exp
deepseek-r1
o3-mini
支持图像：
claude-3.5-sonnet
claude-3.7-sonnet
claude-3.7-sonnet-thinking
claude-3.7-sonnet-max
claude-3.7-sonnet-thinking-max
gpt-4
gpt-4o
gpt-4.5-preview
claude-3-opus
gpt-4-turbo-2024-04-09
gpt-4o-128k
claude-3-haiku-200k
claude-3-5-sonnet-200k
gpt-4o-mini
claude-3.5-haiku
gemini-2.5-pro-exp-03-25
gemini-2.5-pro-max
gpt-4.1
- 接口地址:
/v1/chat/completions - 请求方法: POST
- 认证方式: Bearer Token
- 使用环境变量
AUTH_TOKEN进行认证 - 使用
.token文件中的令牌列表进行轮询认证 - 自v0.1.3-rc.3起支持直接使用 token,checksum 进行认证，但未提供配置关闭
- 使用环境变量
{
"model": "string",
"messages": [
{
"role": "system" | "user" | "assistant", // 也可以是 "developer" | "human" | "ai"
"content": "string" | [
{
"type": "text" | "image_url",
"text": "string",
"image_url": {
"url": "string"
}
}
]
}
],
"stream": boolean,
"stream_options": {
"include_usage": boolean
}
}如果 stream 为 false:
{
"id": "string",
"object": "chat.completion",
"created": number,
"model": "string",
"choices": [
{
"index": number,
"message": {
"role": "assistant",
"content": "string"
},
"finish_reason": "stop" | "length"
}
],
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 0
}
}不进行 tokens 计算主要是担心性能问题。
如果 stream 为 true:
data: {"id":"string","object":"chat.completion.chunk","created":number,"model":"string","choices":[{"index":number,"delta":{"role":"assistant","content":"string"},"finish_reason":null}]}
data: {"id":"string","object":"chat.completion.chunk","created":number,"model":"string","choices":[{"index":number,"delta":{"content":"string"},"finish_reason":null}]}
data: {"id":"string","object":"chat.completion.chunk","created":number,"model":"string","choices":[{"index":number,"delta":{},"finish_reason":"stop"}]}
data: [DONE]
- 接口地址:
/v1/models - 请求方法: GET
- 认证方式: Bearer Token
{
"object": "list",
"data": [
{
"id": "string",
"object": "model",
"created": number,
"owned_by": "string"
}
]
}每次携带Token时都会拉取最新的模型列表，与上次更新需距离至少30分钟。
- 接口地址:
/tokens - 请求方法: GET
- 响应格式: HTML页面
- 功能: 调用下面的各种相关API的示例页面
- 接口地址:
/tokens/get - 请求方法: POST
- 认证方式: Bearer Token
- 响应格式:
{
"status": "success",
"tokens": [
{
"token": "string",
"checksum": "string",
"status": "enabled" | "disabled",
"profile": { // 可能存在
"usage": {
"premium": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"standard": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"unknown": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"start_of_month": "string"
},
"user": {
"email": "string",
"name": "string",
"id": "string",
"updated_at": "string"
},
"stripe": {
"membership_type": "free" | "free_trial" | "pro" | "enterprise",
"payment_id": "string",
"days_remaining_on_trial": number
}
},
"tags": {
"string": null | "string"
}
}
],
"tokens_count": number
}- 接口地址:
/tokens/set - 请求方法: POST
- 认证方式: Bearer Token
- 请求格式:
[
{
"token": "string",
"checksum": "string",
"status": "enabled" | "disabled",
"profile": {
"usage": {
"premium": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"standard": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"unknown": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"start_of_month": "string"
},
"user": {
"email": "string",
"name": "string",
"id": "string",
"updated_at": "string"
},
"stripe": {
"membership_type": "free" | "free_trial" | "pro" | "enterprise",
"payment_id": "string",
"days_remaining_on_trial": number
}
},
"tags": {
"string": null | "string"
}
}
]- 响应格式:
{
"status": "success",
"tokens_count": number,
"message": "Token files have been updated and reloaded"
}- 接口地址:
/tokens/add - 请求方法: POST
- 认证方式: Bearer Token
- 请求格式:
{
"tokens": [
{
"token": "string",
"checksum": "string" // 可选，如果不提供将自动生成
}
],
"tags": {
"string": null | "string"
},
"status": "enabled" | "disabled"
}- 响应格式:
{
"status": "success",
"tokens_count": number,
"message": "string" // "New tokens have been added and reloaded" 或 "No new tokens were added"
}- 接口地址:
/tokens/del - 请求方法: POST
- 认证方式: Bearer Token
- 请求格式:
{
"tokens": ["string"], // 要删除的token列表
"expectation": "simple" | "updated_tokens" | "failed_tokens" | "detailed" // 默认为simple
}- 响应格式:
{
"status": "success",
"updated_tokens": ["string"], // 可选，根据expectation返回，表示更新后的token列表
"failed_tokens": ["string"] // 可选，根据expectation返回，表示未找到的token列表
}- expectation说明:
- simple: 只返回基本状态
- updated_tokens: 返回更新后的token列表
- failed_tokens: 返回未找到的token列表
- detailed: 返回完整信息（包括updated_tokens和failed_tokens）
- 接口地址:
/tokens/tags/set - 请求方法: POST
- 认证方式: Bearer Token
- 请求格式:
{
"tokens": ["string"],
"tags": {
"string": null | "string" // 键可以为 timezone: 时区标识符 或 proxy: 代理名称
}
}- 响应格式:
{
"status": "success",
"message": "string" // "标签更新成功"
}- 接口地址:
/tokens/profile/update - 请求方法: POST
- 认证方式: Bearer Token
- 请求格式:
[
"string" // tokens
]- 响应格式:
{
"status": "success",
"message": "string" // "已更新?个令牌配置, ?个令牌更新失败"
}- 接口地址:
/tokens/upgrade - 请求方法: POST
- 认证方式: Bearer Token
- 请求格式:
[
"string" // tokens
]- 响应格式:
{
"status": "success",
"message": "string" // "已升级?个令牌, ?个令牌升级失败"
}- 接口地址:
/tokens/status/set - 请求方法: POST
- 认证方式: Bearer Token
- 请求格式:
{
"tokens": ["string"],
"status": "enabled" | "disabled"
}- 响应格式:
{
"status": "success",
"message": "string" // "已设置?个令牌状态, ?个令牌设置失败"
}- 接口地址:
/build-key - 请求方法: POST
- 认证方式: Bearer Token (当SHARE_AUTH_TOKEN启用时需要)
- 请求格式:
{
"auth_token": "string", // 格式: {token},{checksum}
"proxy_name": "string", // 可选，指定代理
"disable_vision": boolean, // 可选，禁用图片处理能力
"enable_slow_pool": boolean, // 可选，启用慢速池
"usage_check_models": { // 可选，使用量检查模型配置
"type": "default" | "disabled" | "all" | "custom",
"model_ids": "string" // 当type为custom时生效，以逗号分隔的模型ID列表
},
"include_web_references": boolean
}- 响应格式:
{
"key": "string" // 成功时返回生成的key
}或出错时:
{
"error": "string" // 错误信息
}说明：
-
此接口用于生成携带动态配置的API Key，是对直接传token与checksum模式的升级版本
-
API Key特性对比：
| 优势 | 劣势 |
|---|---|
| 提取关键信息，生成更短的密钥 | 可能存在版本兼容性问题 |
| 支持携带自定义配置 | 增加了程序复杂度 |
| 采用非常规编码方式，提升安全性 | 项目是开源的，安全性的提升相当于没有 |
| 更容易验证Key的合法性 | |
| 取消预校验带来轻微性能提升 |
-
生成的key格式为:
sk-{encoded_config}，其中sk-为默认前缀(可配置) -
auth_token的格式为:
{token},{checksum}，其中,为默认分隔符(可配置) -
usage_check_models配置说明:
- default: 使用默认模型列表(同下
usage_check_models字段的默认值) - disabled: 禁用使用量检查
- all: 检查所有可用模型
- custom: 使用自定义模型列表(需在model_ids中指定)
- default: 使用默认模型列表(同下
- 接口地址:
/proxies - 请求方法: GET
- 响应格式: HTML页面
- 功能: 调用下面的各种相关API的示例页面
- 接口地址:
/proxies/get - 请求方法: POST
- 响应格式:
{
"status": "success",
"proxies": {
"proxies": {
"proxy_name": "non" | "sys" | "http://proxy-url",
},
"general": "string" // 当前使用的通用代理名称
},
"proxies_count": number,
"general_proxy": "string",
"message": "string" // 可选
}- 接口地址:
/proxies/set - 请求方法: POST
- 请求格式:
{
"proxies": {
"proxies": {
"proxy_name": "non" | "sys" | "http://proxy-url"
},
"general": "string" // 要设置的通用代理名称
}
}- 响应格式:
{
"status": "success",
"proxies_count": number,
"message": "代理配置已更新"
}- 接口地址:
/proxies/add - 请求方法: POST
- 请求格式:
{
"proxies": {
"proxy_name": "non" | "sys" | "http://proxy-url"
}
}- 响应格式:
{
"status": "success",
"proxies_count": number,
"message": "string" // "已添加 X 个新代理" 或 "没有添加新代理"
}- 接口地址:
/proxies/del - 请求方法: POST
- 请求格式:
{
"names": ["string"], // 要删除的代理名称列表
"expectation": "simple" | "updated_proxies" | "failed_names" | "detailed" // 默认为simple
}- 响应格式:
{
"status": "success",
"updated_proxies": { // 可选，根据expectation返回
"proxies": {
"proxy_name": "non" | "sys" | "http://proxy-url"
},
"general": "string"
},
"failed_names": ["string"] // 可选，根据expectation返回，表示未找到的代理名称列表
}- 接口地址:
/proxies/set-general - 请求方法: POST
- 请求格式:
{
"name": "string" // 要设置为通用代理的代理名称
}- 响应格式:
{
"status": "success",
"message": "通用代理已设置"
}non: 表示不使用代理sys: 表示使用系统代理- 其他: 表示具体的代理URL地址（如
http://proxy-url）
- 代理名称必须是唯一的，添加重复名称的代理会被忽略
- 设置通用代理时，指定的代理名称必须存在于当前的代理配置中
- 删除代理时的 expectation 参数说明：
- simple: 只返回基本状态
- updated_proxies: 返回更新后的代理配置
- failed_names: 返回未找到的代理名称列表
- detailed: 返回完整信息（包括updated_proxies和failed_names）
所有接口在发生错误时会返回统一的错误格式：
{
"status": "error",
"code": number, // 可选
"error": "string", // 可选，错误详细信息
"message": "string" // 错误提示信息
}- 接口地址:
/config - 请求方法: GET
- 响应格式: HTML页面
- 功能: 提供配置管理界面,可以修改页面内容和系统配置
- 接口地址:
/config - 请求方法: POST
- 认证方式: Bearer Token
- 请求格式:
{
"action": "get" | "update" | "reset",
"path": "string",
"content": {
"type": "default" | "text" | "html",
"content": "string"
},
"vision_ability": "none" | "base64" | "all", // "disabled" | "base64-only" | "base64-http"
"enable_slow_pool": boolean,
"enable_all_claude": boolean,
"usage_check_models": {
"type": "none" | "default" | "all" | "list",
"content": "string"
},
"enable_dynamic_key": boolean,
"share_token": "string",
// "proxies": "" | "system" | "proxy1,proxy2,...",
"include_web_references": boolean
}- 响应格式:
{
"status": "success",
"message": "string",
"data": {
"page_content": {
"type": "default" | "text" | "html", // 对于js和css后两者是一样的
"content": "string"
},
"vision_ability": "none" | "base64" | "all",
"enable_slow_pool": boolean,
"enable_all_claude": boolean,
"usage_check_models": {
"type": "none" | "default" | "all" | "list",
"content": "string"
},
"enable_dynamic_key": boolean,
"share_token": "string",
// "proxies": "" | "system" | "proxy1,proxy2,...",
"include_web_references": boolean
}
}注意：usage_check_models 字段的默认值为：
{
"type": "default",
"content": "claude-3-5-sonnet-20241022,claude-3.5-sonnet,gemini-exp-1206,gpt-4,gpt-4-turbo-2024-04-09,gpt-4o,claude-3.5-haiku,gpt-4o-128k,gemini-1.5-flash-500k,claude-3-haiku-200k,claude-3-5-sonnet-200k,deepseek-r1,claude-3.7-sonnet,claude-3.7-sonnet-thinking"
}这些模型将默认进行使用量检查。您可以通过配置接口修改此设置。
路径修改注意：选择类型再修改文本，否则选择默认时内容的修改无效，在更新配置后自动被覆盖导致内容丢失，自行改进。
- 接口地址:
/static/shared-styles.css - 请求方法: GET
- 响应格式: CSS文件
- 功能: 获取共享样式表
- 接口地址:
/static/shared.js - 请求方法: GET
- 响应格式: JavaScript文件
- 功能: 获取共享JavaScript代码
- 接口地址:
/env-example - 请求方法: GET
- 响应格式: 文本文件
- 功能: 获取环境变量配置示例
- 接口地址:
/get-hash - 请求方法: GET
- 响应格式:
string
- 接口地址:
/get-checksum - 请求方法: GET
- 请求参数:
checksum: 可选，用于修复的旧版本生成的checksum，也可只传入前8个字符；可用来自动刷新时间戳头
- 响应格式:
string
说明：
- 如果不提供
checksum参数，将生成一个新的随机checksum - 如果提供
checksum参数，将尝试修复旧版本的checksum以适配v0.1.3-rc.3之后的版本使用，修复失败会返回新的checksum；若输入的checksum本来就有效，则返回更新tsheader后的checksum
- 接口地址:
/get-tsheader - 请求方法: GET
- 响应格式:
string
- 接口地址:
/health或/(重定向) - 请求方法: GET
- 认证方式: Bearer Token（可选）
- 响应格式: 根据配置返回不同的内容类型(默认、文本或HTML)，默认JSON
{
"status": "success",
"version": "string",
"uptime": number,
"stats": {
"started": "string",
"total_requests": number,
"active_requests": number,
"system": {
"memory": {
"rss": number
},
"cpu": {
"usage": number
}
}
},
"models": ["string"],
"endpoints": ["string"]
}注意：stats 字段仅在请求头中包含正确的 AUTH_TOKEN 时才会返回。否则，该字段将被省略。
- 接口地址:
/logs - 请求方法: GET
- 响应格式: 根据配置返回不同的内容类型(默认、文本或HTML)
- 接口地址:
/logs - 请求方法: POST
- 认证方式: Bearer Token
- 请求格式:
{
"query": {
"limit": number, // 可选，返回记录数量限制
"offset": number, // 可选，起始位置偏移量
"status": "string", // 可选，按状态过滤 ("pending"/"success"/"failure")
"model": "string", // 可选，按模型名称过滤（支持部分匹配）
"from_date": "string", // 可选，开始日期时间，RFC3339格式
"to_date": "string", // 可选，结束日期时间，RFC3339格式
"email": "string", // 可选，按用户邮箱过滤（支持部分匹配）
"membership_type": "string", // 可选，按会员类型过滤 ("free"/"free_trial"/"pro"/"enterprise")
"min_total_time": number, // 可选，最小总耗时（秒）
"max_total_time": number, // 可选，最大总耗时（秒）
"stream": boolean, // 可选，是否为流式请求
"has_error": boolean, // 可选，是否包含错误
"has_chain": boolean // 可选，是否包含对话链
}
}- 响应格式:
{
"total": number,
"logs": [
{
"id": number,
"timestamp": "string",
"model": "string",
"token_info": {
"token": "string",
"checksum": "string",
"profile": {
"usage": {
"premium": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"standard": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"unknown": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"start_of_month": "string"
},
"user": {
"email": "string",
"name": "string",
"id": "string",
"updated_at": "string"
},
"stripe": {
"membership_type": "free" | "free_trial" | "pro" | "enterprise",
"payment_id": "string",
"days_remaining_on_trial": number
}
}
},
"chain": {
"prompt": [ // array or string
{
"role": "string",
"content": "string"
}
],
"delays": [
"string",
[
[
number, // chars count
number // time
]
]
],
"usage": { // optional
"input": number,
"output": number,
}
},
"timing": {
"total": number
},
"stream": boolean,
"status": "string",
"error": "string"
}
],
"timestamp": "string",
"status": "success"
}- 说明：
- 所有查询参数都是可选的
- 管理员可以查看所有日志，普通用户只能查看与其token相关的日志
- 如果提供了无效的状态或会员类型，将返回空结果
- 日期时间格式需遵循 RFC3339 标准，如："2024-03-20T15:30:00+08:00"
- 邮箱和模型名称支持部分匹配
- 接口地址:
/userinfo - 请求方法: POST
- 认证方式: 请求体中包含token
- 请求格式:
{
"token": "string"
}- 响应格式:
{
"usage": {
"premium": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"standard": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"unknown": {
"requests": number,
"requests_total": number,
"tokens": number,
"max_requests": number,
"max_tokens": number
},
"start_of_month": "string"
},
"user": {
"email": "string",
"name": "string",
"id": "string",
"updated_at": "string"
},
"stripe": {
"membership_type": "free" | "free_trial" | "pro" | "enterprise",
"payment_id": "string",
"days_remaining_on_trial": number
}
}如果发生错误，响应格式为:
{
"error": "string"
}- 接口地址:
/token-upgrade - 请求方法: POST
- 认证方式: 请求体中包含token
- 请求格式:
{
"token": "string"
}- 响应格式:
{
"status": "success" | "failure" | "error",
"message": "string",
"result": "string" // optional
}- 接口地址:
/basic-calibration - 请求方法: POST
- 认证方式: 请求体中包含token
- 请求格式:
{
"token": "string"
}- 响应格式:
{
"status": "success" | "error",
"message": "string",
"user_id": "string",
"create_at": "string",
"checksum_time": number
}注意: user_id, create_at, 和 checksum_time 字段在校验失败时可能不存在。
- 使用 get-token 获取读取当前用户token，仅支持windows、linux与macos
- 使用 reset-telemetry 重置当前用户遥测数据，仅支持windows、linux与macos
感谢以下项目和贡献者:
- cursor-api - 本项目本身
- zhx47/cursor-api - 提供了本项目起步阶段的主要参考
- luolazyandlazy/cursorToApi
虽然作者觉得骗收点钱合理，但不强求，要是主动自愿发我我肯定收（因为真有人这么做，虽然不是赞助），赞助很合理吧
不是主动自愿就算了，不是很缺，给了会很感动罢了。
虽然不是很建议你赞助，但如果你赞助了，大概可以：
- 测试版更新
- 要求功能
- 问题更快解决
即使如此，我也保留可以拒绝赞助和拒绝要求的权利。
求赞助还是有点不要脸了，接下来是吐槽：
辛辛苦苦做这个也不知道是为了谁，好累。其实还有很多功能可以做，比如直接传token支持配置（其实这个要专门做一个页面），这个作为rc.4的计划之一吧。
主要没想做用户管理，所以不存在是否接入LinuxDo的问题。虽然那个半成品公益版做好了就是了。
就说这么多，没啥可说的，不管那么多，做就完了。[doge] 自己想象吧。
为什么一直说要跑路呢？主要是有时Cursor的Claude太假了，堪比gpt-4o-mini，我对比发现真没啥差别，比以前差远了，无力了，所以不太想做了。我也感觉很奇怪。
查询额度会在一开始检测导致和完成时的额度有些差别，但是懒得改了，反正差别不大，对话也没响应内容，恰好完成了统一。
有人说少个二维码来着，还是算了。如果觉得好用，给点支持。其实没啥大不了的，没兴趣就不做了。不想那么多了。
要不给我邮箱发口令红包？
过了差不多两个多月，继续吐槽：
我都不知道为什么现在还在更新，明明我自己都不用的，一看到bug反馈我就尽量马上去解决问题。不知道说什么好了。
真得给我磕一个。