跳至主要內容

Cherry Studio 配置

大约 6 分钟

Cherry Studio 配置

Cherry Studio 是一款颜值高、功能全的桌面图形客户端，支持 Windows / macOS / Linux 三端。它把聊天、生图、视频生成都装进了一个窗口里，鼠标点点点就能用，是平台主力推荐的图形客户端，也是想"一站式体验所有模型"的用户首选。

接入结论

  • API 地址（聊天默认）：https://www.yuzhixiaolongxia.com/v1
  • API 地址（生图 / 视频）：https://www.yuzhixiaolongxia.com/v1#（末尾多一个 #，是平台特性，必须加）
  • API 密钥：你的平台令牌
  • 认证方式：Authorization: Bearer <你的 API 令牌>
  • 模型 ID 查询：模型广场
  • 官方下载：https://cherry-ai.com

谁适合用 Cherry Studio

场景是否推荐说明
想一个客户端搞定聊天 + 生图 + 视频强烈推荐主力推荐图形客户端
想批量试不同模型对比效果强烈推荐支持任意切换 Claude / Codex / Gemini / 生图 / 视频模型
完全零基础、只想开聊不要花里胡哨不推荐建议先用 Chatbox
想在手机或平板上用不推荐桌面客户端，建议改用 NextChat
想做自动化流程 / 批处理不推荐建议用 n8n

下载与安装

去官网下载安装包：https://cherry-ai.com

系统文件类型安装方式
Windows.exe 安装包双击运行，一路下一步
macOS.dmg 镜像双击挂载后把图标拖到 Applications
Linux.AppImage赋予执行权限后双击运行

macOS 首次运行

首次启动若提示"无法验证开发者"，前往"系统设置 → 隐私与安全性"，找到 Cherry Studio 条目点"仍要打开"。

添加平台服务商

启动 Cherry Studio 后，按下面顺序操作。

1. 进入模型服务设置

  1. 点左下角的齿轮图标进入"设置"。
  2. 选择左侧菜单中的"模型服务"。
  3. 点击列表底部的"添加"，选择类型 OpenAI 兼容（或显示为"自定义"）。

2. 填写服务商信息

字段填写内容说明
名称例如 预制小龙虾自定义显示名，随意填
API 地址https://www.yuzhixiaolongxia.com/v1聊天用
API 密钥你的平台令牌在 令牌创建教程 创建

填完密钥后，点输入框旁边的"检查"按钮验证连通性。看到"验证通过"或绿色勾就表示连上了。

服务商开关

保存之后，确认服务商列表里这一条右上角的开关是"打开"状态。有些版本默认禁用，开关关着模型不会出现在选择器里。

3. 添加模型 ID

在刚配好的服务商页面，点"添加模型"或"管理模型"，逐个把要用的模型 ID 添加进来。

类型推荐模型 ID说明
聊天（Claude）claude-opus-4-7旗舰对话模型
聊天（Codex）gpt-5.5编程能力强
聊天（Gemini）gemini-3.1-pro-preview长上下文
生图（性价比）gemini-3.1-flash-imageNano Banana，便宜快
生图（高画质）image2GPT-Image2，高品质
视频（通用）sora-2Sora 标准版
视频（高画质）sora-2-proSora 高质量版
视频（带音频）veo_3_1-fast自带同步声音
视频（剧情）Seedance 系列详见 Seedance 教程

模型 ID 一字不差

模型 ID 必须精确粘贴，大小写、连字符、下划线都不能错。建议直接从 模型广场 复制。

发出第一条聊天消息

  1. 回到主界面，点左上角"新建对话"。
  2. 顶部模型选择器选择 claude-opus-4-7（或任意聊天模型）。
  3. 在输入框里发一句：
你好，请用一句话介绍你自己。
  1. 几秒内收到回复，说明配置完成。

画图模式

生图必须用带 # 的地址

Cherry Studio 调用生图接口时，平台需要末尾带 # 来区分图像通道。如果生图一直失败、提示"格式错误"或"未识别"，90% 是 API 地址末尾少了 #。

正确写法：https://www.yuzhixiaolongxia.com/v1#

建议复制一份服务商配置，命名为"预制小龙虾-生图"，专门把地址填成 /v1#，跟聊天分开管理。

使用步骤

  1. 新建对话，顶部模型选择器选 gemini-3.1-flash-image 或 image2。
  2. 在输入框里描述你要的画面，例如：
一只穿着厨师帽的小龙虾，正在用两只钳子炒一锅麻辣香锅，
厨房背景，卡通插画风格，色彩鲜艳。
  1. 回车发送，5-30 秒后图片直接显示在对话框里。
  2. 把鼠标移到图片上，点击下载按钮保存到本地。

平台便利特性

  • 想出 4K 大图：在 prompt 里直接写 "4K" 或 "4k 分辨率"，平台会自动按 4K 出图，不需要额外参数。
  • 参考图比例自适应：上传参考图但没指定输出尺寸时，平台会自动按参考图的宽高比出图。
  • 本地图直接拖：把本地图片直接拖进 Cherry Studio 对话框，自动上传作为参考图。

视频模式

视频生成是异步任务，从下单到出片通常 30 秒到 5 分钟不等。耐心等待，不要重复发送。

使用步骤

  1. 新建对话，顶部模型选择器选 sora-2 / veo_3_1-fast / Seedance 系列任意一个。
  2. 写一段画面描述，例如：
一只小龙虾缓缓爬过一片沙滩，夕阳余晖照在它红色的外壳上，
慢动作镜头，电影感光影。
  1. 发送后看到"生成中"状态，等几十秒到几分钟。
  2. 完成后视频会以播放器或下载链接形式出现在对话框里。

Seedance 系列的进阶玩法

Seedance 系列支持图生视频、参考视频、1080P 成片、参考音频等多种玩法，模型选择和参数细节较多。完整教程见：

Seedance 2.0 视频生成教程

常见坑

接不通 / "请求失败"

按顺序排查：

  1. API 地址是否填对：聊天用 /v1，生图视频用 /v1#，两个不一样。
  2. 令牌是否完整：复制时不要带前后空格或换行。
  3. 服务商开关是否打开：模型服务页面右上角开关要是绿色。
  4. 网络是否能访问 https://www.yuzhixiaolongxia.com：浏览器打开试试。

生图始终失败

最常见原因：API 地址末尾没加 #。把生图服务商的 API 地址改成 https://www.yuzhixiaolongxia.com/v1# 重试。

模型选择器里找不到模型

回到"模型服务 → 你的服务商"，确认：

  1. 模型 ID 真的添加并保存了。
  2. 模型 ID 拼写完全正确（大小写、连字符）。
  3. 服务商右上角开关是打开状态。

流式回复中途断掉

少数模型在流式模式下不稳定，可以在模型设置里关闭"流式输出（Stream）"再发送。重新发一次通常就好。

视频任务长时间没结果

视频生成本来就慢，正常等待 1-5 分钟。如果超过 5 分钟还没反应：

  • 不要重复发送，避免重复扣费。
  • 在对话历史里检查任务是否实际已完成但渲染没刷新——切换一次对话再切回来就能看到。

4K 出图没生效

确认 prompt 里写了 "4K" 或 "4k"。如果 prompt 是中文，写"4K 高清"或"4K 分辨率"也能识别。

上一步：Gemini 手动配置 | 下一步：n8n 自动化工作流

预制小龙虾 | 文档系统
Copyright © 2026 预制小龙虾