> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio 接入 PPIO Embedding API

CherryStudio 是一款集多模型对话、知识库管理、AI 绘画、翻译等功能于一体的全能 AI 助手平台。 CherryStudio 的高度自定义的设计、强大的扩展能力和友好的用户体验，使其成为专业用户和 AI 爱好者的理想选择。无论是零基础用户还是开发者，都能在 CherryStudio 中找到适合自己的 AI 功能，提升工作效率和创造力。

PPIO 算力云特别推出**Embedding 模型 API 服务通道**——即时响应 + 99.9% 稳定性，让您直连顶尖模型无需等待！

搭配 Cherry Studio 客户端的知识库功能，仅需 3 步就能本地环境丝滑调用 baai/bge-m3，搭建自己的专属知识库，以**低成本高可靠**实现知识库的自动化管理。

下方教程含完整接入方案（含密钥配置），3 分钟上车享受「PPIO 高性能 API +Cherry Studio 知识库搭建」的黄金组合 🚀

## 1.进入 Cherry Studio，添加”PPIO"作为模型供应商

首先前往官网下载 Cherry Studio：[ https://www.cherry-ai.com/download ](https://www.cherry-ai.com/download)（如果进不去可以打开下面的百度云链接下载自己需要的版本：[ https://pan.baidu.com/s/1EgMxS-pdb4wq1zMdxjHNpw?pwd = mcy2 ](https://pan.baidu.com/s/1EgMxS-pdb4wq1zMdxjHNpw?pwd=mcy2)）

（1）先点击左下角设置，自定义提供商名称为：PPIO，点击“确定”

<Frame>
  <img src="https://mintcdn.com/ppinfra/UGbFBbGGBJeRybcz/third-party/images/cherry-studio-embedding/1.png?fit=max&auto=format&n=UGbFBbGGBJeRybcz&q=85&s=c236ed45c0b94ee0f0173c1e307d222e" alt="" width="1280" height="687" data-path="third-party/images/cherry-studio-embedding/1.png" />
</Frame>

（2）前往 [PPIO 派欧云 API 密钥管理 ](https://ppio.com/settings/key-management)，点击【用户头像】—【API 密钥管理】进入控制台

<Frame>
  <img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/cherry-studio-embedding/2.png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=082ed0193a027714210da0fffa420989" alt="" width="1280" height="638" data-path="third-party/images/cherry-studio-embedding/2.png" />
</Frame>

点击 【+ 创建】按钮来创建新的 API 密钥。自定义一个密钥名称，**生成的密钥仅在生成时呈现，务必复制并保存到文档中，以免影响后续使用**<img src="https://mintcdn.com/ppinfra/UGbFBbGGBJeRybcz/third-party/images/cherry-studio-embedding/156.png?fit=max&auto=format&n=UGbFBbGGBJeRybcz&q=85&s=3c08a0579cf2bcc3d71d377ee3bb741a" alt="" width="2544" height="560" data-path="third-party/images/cherry-studio-embedding/156.png" />

3）在 CherryStudio 填入密钥和地址
直接复制粘贴：`https://api.ppio.com/openai`

<Frame>
  <img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/cherry-studio-embedding/4.png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=6735467779c896466637c205873fe131" alt="" width="1280" height="1079" data-path="third-party/images/cherry-studio-embedding/4.png" />
</Frame>

（4）将官网模型名称：baai/bge-m3 直接复制到【模型 ID】，下方自动填充

<Frame>
  <img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/cherry-studio-embedding/55.png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=7357a1aa1c9e643d18048db9bdc62e5e" alt="" width="1122" height="758" data-path="third-party/images/cherry-studio-embedding/55.png" />
</Frame>

如需更换其他模型，前往 [PPIO 模型列表 ](https://ppio.com/model-api/pricing)复制模型名称。例如：baai/bge-m3；最后点击【添加模型】

## 2.<u>模型使用配置</u>

### 创建知识库

（1）在 CherryStudio 左侧工具栏，点击知识库图标，即可进入管理页面；点击添加，开始创建知识库；

<Frame>
  <img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/cherry-studio-embedding/6.png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=2c9f4068138e6511d307e93723e71278" alt="" width="1280" height="794" data-path="third-party/images/cherry-studio-embedding/6.png" />
</Frame>

（2）输入知识库的名称并添加嵌入模型，以 bge-m3 为例，即可完成创建。

<Frame>
  <img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/cherry-studio-embedding/7.png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=b74f4d220d647af3220c6b09188d9a48" alt="" width="1263" height="823" data-path="third-party/images/cherry-studio-embedding/7.png" />
</Frame>

### 添加文件并向量化

（1）点击添加文件的按钮，打开文件选择；

<Frame>
  <img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/cherry-studio-embedding/8.png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=c3e5d161af2029a14763a9d410d8f958" alt="" width="1280" height="576" data-path="third-party/images/cherry-studio-embedding/8.png" />
</Frame>

（2）选择支持的文件格式，如 pdf，docx，pptx，xlsx，txt，md，mdx 等，并打开；

<Frame>
  <img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/cherry-studio-embedding/9.png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=11763d118b71621051e7fa9ea27f474e" alt="" width="628" height="365" data-path="third-party/images/cherry-studio-embedding/9.png" />
</Frame>

（3）系统会自动进行向量化处理，当显示完成时（绿色 ✓），代表向量化已完成。

<Frame>
  <img src="https://mintcdn.com/ppinfra/UGbFBbGGBJeRybcz/third-party/images/cherry-studio-embedding/10.png?fit=max&auto=format&n=UGbFBbGGBJeRybcz&q=85&s=96b47a2c8e461aa665a8dd079c641229" alt="" width="1280" height="535" data-path="third-party/images/cherry-studio-embedding/10.png" />
</Frame>

### 搜索知识库

当文件等资料向量化完成后，可以进行查询，步骤如下：

（1）点击页面下方的搜索知识库按钮；

<Frame>
  <img src="https://mintcdn.com/ppinfra/UGbFBbGGBJeRybcz/third-party/images/cherry-studio-embedding/11.png?fit=max&auto=format&n=UGbFBbGGBJeRybcz&q=85&s=df3ba4be18ab46ced945444d779b8100" alt="" width="1280" height="670" data-path="third-party/images/cherry-studio-embedding/11.png" />
</Frame>

（2）输入查询的内容；

<Frame>
  <img src="https://mintcdn.com/ppinfra/UGbFBbGGBJeRybcz/third-party/images/cherry-studio-embedding/12.png?fit=max&auto=format&n=UGbFBbGGBJeRybcz&q=85&s=140d874274005a134ff710875319897a" alt="" width="1280" height="1028" data-path="third-party/images/cherry-studio-embedding/12.png" />
</Frame>

（3）呈现搜索的结果；

（4）并显示该条结果的匹配分数。

<Frame>
  <img src="https://mintcdn.com/ppinfra/UGbFBbGGBJeRybcz/third-party/images/cherry-studio-embedding/11.png?fit=max&auto=format&n=UGbFBbGGBJeRybcz&q=85&s=df3ba4be18ab46ced945444d779b8100" alt="" width="1280" height="670" data-path="third-party/images/cherry-studio-embedding/11.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/ppinfra/UGbFBbGGBJeRybcz/third-party/images/cherry-studio-embedding/12.png?fit=max&auto=format&n=UGbFBbGGBJeRybcz&q=85&s=140d874274005a134ff710875319897a" alt="" width="1280" height="1028" data-path="third-party/images/cherry-studio-embedding/12.png" />
</Frame>

### 对话中引用知识库生成回复

（1）创建一个新的话题，在对话工具栏中，点击知识库，会展开已经创建的知识库列表，选择需要引用的知识库；

<Frame>
  <img src="https://mintcdn.com/ppinfra/UGbFBbGGBJeRybcz/third-party/images/cherry-studio-embedding/13.png?fit=max&auto=format&n=UGbFBbGGBJeRybcz&q=85&s=d645906a81a0fcfd7dc9c123add6628e" alt="" width="1280" height="943" data-path="third-party/images/cherry-studio-embedding/13.png" />
</Frame>

（2）输入并发送问题，模型即返回通过检索结果生成的答案 ；

（3）同时，引用的数据来源会附在答案下方，可快捷查看源文件。

<Frame>
  <img src="https://mintcdn.com/ppinfra/UGbFBbGGBJeRybcz/third-party/images/cherry-studio-embedding/14.png?fit=max&auto=format&n=UGbFBbGGBJeRybcz&q=85&s=fbbd0075922fc512efed008ddfc71724" alt="" width="1280" height="606" data-path="third-party/images/cherry-studio-embedding/14.png" />
</Frame>

## 3.PPIO×Cherry Studio 知识库使用详情教程

若您想了解更多 PPIO 与 Cherry Studio 知识库应用教程，可以访问 Cherry Studio 官方平台帮助文档，探索更多 PPIO 嵌入模型 API 的应用场景。点击下方链接直达教程文档→[https://docs.cherry-ai.com/knowledge-base/knowledge-base](https://docs.cherry-ai.com/knowledge-base/knowledge-base)

【教程来源：Cherry Studio】

## <u>PPIO 全新福利重磅来袭</u>

🎁 新人专享：立即使用邀请码【VOJL20】完成注册并实名认证获得5元代金券。

🎉限时活动：分享邀请链接邀请好友注册，邀请返利详情请查看 [邀请返利](https://ppio.com/settings/invitation-rebate)。
