Cherry Studio 配置
用 OpenAI 兼容模式接入：端点
https://cn.fluxtoken.ai/v1，填令牌和模型名。
Cherry Studio 里选自定义 OpenAI 服务商（OpenAI 兼容）这一类， 端点填 https://cn.fluxtoken.ai/v1。
注意末尾的 /v1 不能少。
Cherry Studio 是第三方开源项目
Cherry Studio 由第三方维护，与 FluxToken 没有隶属关系。 它的界面、版本和设置项由它的维护者决定，以 Cherry Studio 官方文档为准。
本文档只讲该往那几个框里填什么值，不写死它的版本号和界面文案。
一、准备工作
1. 端点
Cherry Studio 走 OpenAI 兼容方式，地址要带 /v1：
港澳台及境外用户用全球站的对应地址 https://api.fluxtoken.ai/v1。
和其他客户端的区别
| 你要接的模型 | 该填的地址 |
|---|---|
| OpenAI 兼容模式（本页） | https://cn.fluxtoken.ai/v1 |
| Anthropic 兼容（Claude 系另配） | https://cn.fluxtoken.ai（不加 /v1） |
漏掉或错加 /v1 的表现是 404，不是认证失败。
2. 令牌与分组
控制台 → 令牌管理 → 添加令牌，分组按你打算用的模型选：
| 用途 | 分组 |
|---|---|
| Claude 对话 | 【Claude】Max · 稳享（主） |
| GPT / Codex | 【Codex】Pro · 稳享 |
| Gemini | 【Gemini】Pro · 企业级 |
| Grok / Kimi / DeepSeek / GLM | 对应的单一分组 |
| 画图 | 【GPT】生图模型 · 福利 或 【Gemini】banana生图模型 |
一个令牌只能选一个分组。 想在 Cherry Studio 里同时用 Claude 和 GPT， 就建两个令牌，在 Cherry Studio 里配成两个服务商。
3. 模型名
从模型列表逐字照抄。Cherry Studio 里通常是先填服务商， 再在模型管理里手动添加模型 ID。
模型 ID 必须和分组里的完全一致，写错的表现是 模型不存在。
生图模型要单独建令牌
生图模型（gpt-image-2 系列、gemini-3-pro-image-preview 等）在两个生图专用分组里， 和对话模型不在一起。要用生图功能就再建一个建在生图分组上的令牌。
生图按次计费，不按 token，详见生图模型。
二、配置要点
在 Cherry Studio 里添加服务商，填入以下三项：
| 填什么 | 值 |
|---|---|
| API 地址 / Base URL | https://cn.fluxtoken.ai/v1 |
| API 密钥 | 你的 sk- 令牌 |
| 模型 | 手动添加，如 claude-sonnet-5-5、gpt-5.6 |
具体的字段名称和菜单位置以 Cherry Studio 官方文档为准（界面会随版本变化）。
配好之后如果模型列表是空的，去它的模型管理里手动添加模型 ID—— 很多客户端不会自动拉取 /v1/models 的清单。
三、连通性验证
第一步：端点是否可达（期望 401）
curl -s -o /dev/null -w '%{http_code}' https://cn.fluxtoken.ai/v1/models; echo第二步：令牌与分组是否正确（期望 200）
curl -s https://cn.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"这份清单就是你这个令牌能用的全部模型。在 Cherry Studio 里添加的模型 ID 必须出自这份清单，否则会报 模型不存在。
第三步：在 Cherry Studio 里发一句话
能正常回复即链路打通。
四、排查顺序
| 你看到的 | 先查这里 |
|---|---|
| 404 | Base URL 漏了 /v1 |
| 401 | 密钥填错、复制不全，或带了多余空格 |
| 模型列表是空的 | 需要手动添加模型 ID，不会自动拉取 |
| 连不上 / 超时 | 端点选择问题，国内加速异常可回退 全球站 · 源站直连https://api.fluxtoken.ai港澳台及境外用户请用此地址；国内加速异常时也可回退到这里。 |
模型不存在 | 令牌分组不含该模型，或模型 ID 拼错 |
| 改了分组没反应 | 重启 Cherry Studio |