Cherry Studio / ChatBox / Cursor 接入 AI API 中转教程

这类客户端都支持「自定义 OpenAI 兼容接口」。只要知道三个参数：接口地址、密钥、模型名，任何客户端都能接上。

一、通用参数（所有客户端都填这三个）

参数值说明
API 地址 / Base URLhttps://api.forsienna.art/v1多数客户端要求带 /v1，个别只要域名，见下文
API Keysk-...在站内「令牌」页创建，可给每个客户端单独发一把
模型名如 combo:recommended-free必须和站内模型列表里的名字完全一致
建议每个客户端单独建一个令牌，命名写清楚（如 cherry-mac）。将来某个客户端泄露，单独吊销就行，不用全部重配。

二、Cherry Studio

  1. 设置 → 模型服务 → 添加提供商
  2. 类型选 OpenAI（兼容模式）
  3. API 地址填 https://api.forsienna.art/v1
  4. API 密钥填 sk-...
  5. 点「检查」或「获取模型列表」，正常情况下会自动拉到全部可用模型
  6. 如果列表为空，手动添加模型名（如 reflection/beam-free）即可

三、ChatBox

  1. 设置 → 模型提供方 → 添加自定义提供方
  2. API 模式选 OpenAI API 兼容
  3. API 域名填 https://api.forsienna.art（注意这个客户端通常不要带 /v1）
  4. API 路径保持默认 /v1/chat/completions
  5. 填入密钥与模型名，保存

四、Cursor

Cursor 的自定义接口入口在「设置 → Models → OpenAI API Key」，并需要打开 Override OpenAI Base URL：

  1. 打开 Settings → Models
  2. 在 Override OpenAI Base URL 填 https://api.forsienna.art/v1
  3. API Key 填 sk-...，点 Verify
  4. 在模型列表里手动添加你要用的模型名
Cursor 部分版本会把模型名映射到自家内置列表，自定义模型可能不出现在下拉框里。这种情况需要在 Settings → Models → Add model 手动输入名字。

五、模型列表为空 / 报错的排查顺序

现象最可能的原因怎么修
获取模型列表为空/v1/models 请求 401密钥错，或地址少了 /v1
401 Unauthorized密钥带空格 / 已被禁用重新复制，检查令牌状态
404 model not found模型名拼错对照站内「模型与价格」页复制全名
429 Too Many Requests免费池限流换模型，或用自动降级组
回答被截断客户端 max_tokens 设太小调到 2048 以上
连接超时本地代理拦截给该域名加直连规则

六、两个提高稳定性的做法

用自动降级组

模型名填 combo:recommended-free，网关会在多个免费模型间自动切换。比固定某个模型稳得多——尤其免费池经常单点 429。

给不同用途分开发令牌

聊天一个令牌、写代码一个令牌、跑脚本一个令牌。这样用量统计能看出哪类场景最费 token，出问题也能精准吊销。

七、验证是否真的接通了

在客户端里问一句「你是什么模型」，能正常回答就说明链路通了。如果回答里出现奇怪的中转提示，通常是模型名映射到了别的模型，检查模型名拼写。

注册并创建令牌 →

相关阅读