# Cherry Studio 接入指南

https://omnimodel.me/apps/cherry-studio?lang=zh

> 桌面端多模型客户端，内置助手预设与本地知识库。

## 适用场景

适合在桌面上同时使用多个模型：为不同任务建立助手预设，在同一个对话里切换模型对比回答，也可以结合本地知识库做资料问答。

## 使用建议

建议给这个客户端单独创建一把密钥，并在密钥设置里限制可用模型，方便单独查看用量。

## 连不通时检查

1. API 地址填 `https://omnimodel.me/v1`，不要多写 `/chat/completions`。
2. 密钥以 `key_` 开头且没有被暂停或撤销，错误码 `auth.invalid_key` 表示密钥不可用。
3. 模型 ID 与[模型目录](/catalog)一致，并且在这把密钥的可用模型里。
4. 余额不足会返回 `billing.insufficient_credit`，更多错误见[常见错误](/docs/errors)。

## 配置步骤

1. 打开「设置 → 模型服务」，新增一个 OpenAI 兼容供应商。
2. 填入下面的 API 地址与密钥，点「检查」确认连通。
3. 在「模型」里添加要用的模型 ID，回到对话框选中即可。

## 配置参数

- API 地址：`https://omnimodel.me/v1`
- API 密钥：`YOUR_API_KEY`
- 模型：`MODEL_ID`

## 常见问题

### 可以同时添加多个模型吗？

可以。在同一个 OpenAI 兼容供应商下逐个添加模型 ID，对话时即可切换。

### 本地知识库会调用哪些模型？

知识库需要向量模型生成嵌入，请在模型目录里选择带「向量」能力的模型并添加到供应商里。