添加提供商
设置 → 模型服务 → 拉到底点“+ 添加” → 提供商类型选 OpenAI → 名称填“二五云API” → API 地址填 https://ai.idcidiot.com/v1 → API 密钥填 sk-...。地址必须带 /v1,Cherry Studio 会在后面拼 /chat/completions。
类型别选成 Responses 那一项,那是另一个协议,站点对外提供的是 chat completions,选错会直接 404。名称只是显示用的,填什么都行,方便你自己在列表里认出来。
Cherry Studio 的配置分两层:提供商层面填地址和 Key,模型层面填 ID 和参数。地址填错时这个提供商下的所有模型都连不上;ID 填错时只有那一个模型报错。看错误是全局还是单个,就能判断该改哪一层。
手动添加模型 ID
Cherry Studio 的模型列表来自 /v1/models,站点返回的清单不一定覆盖所有可用模型,尤其是新上线的。点提供商右侧的“管理”,在模型列表底部点“+ 添加”,手填模型 ID:gemini-3.8-flash、glm-5.3、claude-opus-5。ID 里的点号和连字符要一模一样,gemini-3.8-flash 不是 gemini-3-8-flash。
添加完把提供商右上角的开关打开,回到聊天页,模型下拉里才会出现刚加的那几个。
模型页上带版本后缀的 ID 要当成不同模型对待,比如 glm-5.3-flash 和 glm-5.3-flashx,两个都加上,用的时候按任务挑。它们不会互相指向,只加一个就只多一个可选项。模型多了以后用列表上方的搜索框按前缀过滤,比翻页快。
加进客户端之前,先用 curl 确认这个 ID 在站点侧能正常返回:
curl -s https://ai.idcidiot.com/v1/chat/completions \
-H "Authorization: Bearer $YUN25_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"ping"}]}'验证与参数
点“检查”按钮,能返回模型数量说明地址和 Key 都对;返回空但对话能用,多半是 /v1/models 的权限问题,不影响正常调用。真正的验证还是发一条消息,看返回里有没有内容,再看站点日志里有没有对应的扣费记录。
模型设置里可以改上下文长度和最大输出,按真实值填:gemini-3.8-flash 的上下文是 1,048,576 token,最大输出 65,536 token。填大了不会立刻报错,但长对话会在上游被截断;填小了本地就先丢掉历史,模型看到的材料变少。温度这类参数在不同模型上的可用范围不一样,Gemini 系对 0 到 2 的容忍度高一些,Claude 系建议 0 到 1。
多模型分工
把便宜模型设为默认,贵的留给难任务。翻译、摘要、改写用 glm-5.3-flash;长文档分析用 claude-opus-5;需要看图时换支持图像输入的 gemini-3.8-flash。Cherry Studio 的每个助手可以绑定不同模型,不必全局只留一个。
1,048,576 的上下文能一次塞进整本技术手册,但输入按 token 计费,整篇丢进去比先切分再问贵得多。长文档先按章节拆开,只把相关段落发给模型,回答质量也更稳。
同一个提供商的 Key 是共用的,分组权限决定你能调到哪些模型。换 Key 之后记得把模型列表刷新一遍,旧列表里可能还留着已经没权限的 ID。助手绑定模型后,系统提示词和温度跟着助手走,切模型不用改提示词;上下文长度是模型级设置,换模型会跟着换。
价格
gemini-3.8-flash 的 model_ratio 是 0.75,Gemini Antigravity 分组 0.65 倍,输入价 = 0.75 × 2 × 0.65 = $0.975/百万 token,输出按 completion_ratio 5 折算为 $4.875/百万 token。glm-5.3-flash 在官渠国模 0.2 倍下是 $0.16/$0.56,差了一个数量级,日常问答用它更合适。
倍率表在 价格页,单模型页在 /model/gemini-3.8-flash/。按用量估:一天翻译 20 页、每页 3,000 输入 3,000 输出,用 gemini-3.8-flash 约 $0.35,用 glm-5.3-flash 约 $0.04。
配置改完先发一条短消息确认能出字,再去调长文档。改过地址或 Key 之后,旧会话不会自动换配置,重新选一次模型最省事。