词源探索

外观

Cherry Studio 配置指南 ​

最近更新：2026 年 10 月 17 日（Asia/Shanghai）

关联：帮助中心 · 大模型 API

Cherry Studio 是支持多模型服务的桌面客户端，适合不想写代码、又想在图形界面里切换 Claude / Gemini / Kimi 等模型的用户。词源探索对 New API / OpenAI 兼容协议友好，接入步骤很短。

1. 准备令牌 ​

  1. 登录词源探索控制台，打开 「令牌管理」。
  2. 点击 「添加令牌」：名称随意（如 cherry）；过期时间按需；不确定分组时保持默认。
  3. 额度可先设合理上限（推荐给每个客户端单独令牌，避免一把钥匙打天下）。
  4. 保存后复制 sk- 开头的密钥。

警告

勿把 Key 发到群聊或截图。泄露后立即禁用并重建。

2. 下载安装 ​

前往 Cherry Studio 官网 或 GitHub Releases 下载对应系统安装包：

  • Windows：.exe 安装包
  • macOS：.dmg（Intel / Apple Silicon 选对应或通用版）
  • Linux：.AppImage / .deb 等

3. 添加模型服务 ​

  1. 打开 Cherry Studio，进入左下角 设置 → 模型服务。
  2. 点击底部 「添加」。
  3. 提供商类型优先选 New API；若没有该项，选 OpenAI 或 OpenAI Compatible。
  4. 填写：
    • API 地址：https://ai.afp.net（一般不要加 /v1，Cherry 会自动补全）
    • API 密钥：你的 sk-xxxxxxxx
  5. 点击 「检查」 测连通；再点 「管理」 拉取并勾选模型。

若希望走 Claude 原生协议，可再添加一个类型为 Anthropic 的提供商，API 地址同样填 https://ai.afp.net（不带 /v1），Key 相同。

4. 添加模型 ​

自动同步失败时，可手动添加模型 ID（须与平台完全一致）：

场景建议模型 ID
日常编码 / 对话claude-sonnet-4-6
更强推理claude-opus-4-8、claude-opus-5
快速便宜claude-haiku-4-5、gemini-3.5-flash、deepseek-v4-flash
Gemini Progemini-3.1-pro
Kimi / GLM / Qwenkimi-k3、glm-5.3、qwen3.8-max

完整列表见 帮助中心模型速查 或 GET /v1/models。

回到对话页，在顶部选择刚配置的提供商与模型即可开始聊天。流式输出默认开启。

5. 常见问题 ​

连接失败或 404？
检查地址是否为裸 https://ai.afp.net（勿误写成完整 /v1/chat/completions）；Key 是否完整；在 New API / OpenAI / OpenAI Compatible 之间切换试一次。

如何用 Claude / Gemini？
多数情况只需在 New API / OpenAI 提供商下添加对应模型 ID，无需再配官方 Google / Anthropic 账号。要用 Anthropic 原生特性时再单独加 Anthropic 提供商。

知识库 / Embedding？
Cherry 支持本地文档解析。平台若尚未上架嵌入模型，知识库向量化可能不可用——以 /v1/models 与控制台为准；也可先用客户端本地嵌入方案。

为什么客户端看不到余额？
余额与用量请在词源探索控制台查看。

可以配置多个提供商吗？
可以。词源探索、官方 Key、其它网关可并存，对话时按需切换。

返回：帮助中心