Cherry Studio 接入词元圈完整教程

·7 分钟阅读·231 次阅读

Cherry Studio 接入词元圈

Cherry Studio 是一款开源的 AI 客户端工具,支持接入多种 OpenAI 兼容的 API 服务。本文将详细介绍如何将词元圈接入 Cherry Studio,5 分钟完成配置。


Cherry Studio 简介

Cherry Studio 是一款跨平台的桌面 AI 客户端,支持 Windows、macOS 和 Linux。它的核心特点包括:

  • 多模型切换:在同一界面内快速切换不同的 AI 模型
  • OpenAI 兼容:支持所有兼容 OpenAI API 格式的服务
  • 会话管理:支持多轮对话、会话历史、导出等功能
  • 本地优先:数据存储在本地,隐私有保障
  • 免费开源:完全免费使用,代码开源透明

第一步:下载安装 Cherry Studio

访问 Cherry Studio 官方网站,下载适合你操作系统的版本:

  • Windows:下载 .exe 安装包,双击安装即可
  • macOS:下载 .dmg 文件,拖入 Applications 文件夹
  • Linux:下载 .AppImage 或 .deb 包

安装完成后启动 Cherry Studio,你会看到一个简洁的对话界面。


第二步:配置词元圈 API

配置流程

2.1 添加供应商

在 Cherry Studio 左侧菜单中找到 「设置」,然后点击 「供应商」 或 「API Providers」。点击 「添加」 按钮,选择 「OpenAI 兼容」 类型。

2.2 填写配置信息

在弹出的配置窗口中,填入以下信息:

配置项填写内容
名称词元圈 或任意名称
API Base URLhttps://www.ciyuano.com/v1
API Key在词元圈用户中心获取的 API Key
模型手动添加或点击「获取模型列表」

2.3 保存并测试

填写完成后点击 「保存」。然后回到对话界面,在顶部模型选择器中选择你刚添加的供应商和模型,发送一条测试消息,确认能正常收到回复。


第三步:选择合适的模型

推荐模型

词元圈目前支持以下主流模型,你可以根据需求选择:

模型特点适用场景价格
DeepSeek V4通用能力强,中英文均衡日常对话、翻译、写作0.5/1 元
MiMo v2.5 PRO推理能力强,代码质量高编程、数学、Agent免费
GLM-5中文理解出色,知识丰富中文写作、知识问答0.8/1.5 元
Qwen Plus长上下文支持好长文档分析、总结0.4/0.8 元

进阶配置

添加多个模型

你可以为同一个供应商添加多个模型。在供应商配置中,点击模型列表旁的 「添加」 按钮,输入模型 ID(如 deepseek-v4、mimo-v2.5-pro、glm-5)。

设置系统提示词

在 Cherry Studio 的对话设置中,你可以为不同的对话配置不同的系统提示词(System Prompt)。例如:

  • 编程助手:「你是一个专业的编程助手,擅长 Python、JavaScript 等语言。」
  • 翻译助手:「你是一个专业的翻译,精通中英互译,保持原文风格。」
  • 写作助手:「你是一个写作助手,帮助用户润色文章、生成内容。」

调整参数

在对话设置中,你可以调整以下参数:

  • Temperature:控制回复的随机性(0.1 更精确,0.9 更创意)
  • Max Tokens:控制最大输出长度
  • Top P:控制采样范围

常见问题

Q: 提示「API Key 无效」怎么办?

A: 请确认 API Key 是否正确复制(以 sk- 开头),并确认账户余额是否充足。可以在词元圈用户中心检查 Key 状态。

Q: 连接超时怎么办?

A: 检查网络连接,确认 Base URL 是否正确填写。如果使用代理,请确保代理配置正确。

Q: 支持图片上传吗?

A: 部分模型支持图片输入(如 MiMo v2.5 PRO),需要在模型配置中开启「支持图片」选项。


总结

通过以上步骤,你已经成功将词元圈接入 Cherry Studio。整个过程只需 5 分钟:

  1. 下载并安装 Cherry Studio
  2. 添加 OpenAI 兼容供应商,填入词元圈的 API 地址和密钥
  3. 选择合适的模型,开始对话

Cherry Studio 的界面简洁直观,配合词元圈的多模型支持,你可以随时在不同模型之间切换,找到最适合当前任务的那一个。

下一步:尝试接入其他客户端工具,如 LobeChat、Cursor 等,词元圈的 API 完全兼容 OpenAI SDK,接入方式几乎一样。

查看完整 API 文档 · 浏览所有模型

评论功能暂未开放,敬请期待