Source: https://wiki.niceai.dev/guide/clients/cherry-studio

# Cherry Studio 接入自定义 API

在 Cherry Studio 的「设置 → 模型服务」中添加一个 **OpenAI** 类型的服务商，API 地址填 `https://api.niceai.dev`（不用加 `/v1`，Cherry Studio 会自动补全），再填入 NiceAI 密钥并添加模型。

## 准备工作

1. 从 Cherry Studio 官网下载安装客户端。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组按所用模型选择。

## 配置步骤

1. 打开 Cherry Studio，进入 **设置 → 模型服务**，点击 **添加**。
2. 名称填 `NiceAI`，提供商类型选择 **OpenAI**。
3. 填写：

| 设置项 | 填写内容 |
| --- | --- |
| API 密钥 | 你的 NiceAI 密钥 |
| API 地址 | `https://api.niceai.dev` |

4. 点击 **管理** 或 **添加**，从列表中选择模型，或手动输入 [模型广场](https://niceai.dev/model-plaza) 中的模型名。
5. 点击 **检测**，通过后打开右上角的启用开关。
6. 回到对话页，在顶部选择 NiceAI 下的模型开始对话。

## API 地址的结尾规则

根据 Cherry Studio 官方文档，API 地址输入框下方会显示实际请求地址的预览，以预览为准：

| 填法 | 实际请求 | 结果 |
| --- | --- | --- |
| `https://api.niceai.dev` | `https://api.niceai.dev/v1/chat/completions` | 正确 |
| `https://api.niceai.dev/v1` | `https://api.niceai.dev/v1/v1/chat/completions` | 多一段 `/v1`，404 |
| 以 `#` 结尾的完整地址 | 原样使用，不再拼接版本路径 | 一般不需要 |

**用 Anthropic 或 Gemini 类型**
Cherry Studio 也提供 Anthropic、Gemini 类型的服务商。选 Anthropic 时 API 地址同样填 `https://api.niceai.dev`，密钥用 Claude 分组；选 Gemini 时密钥用 Gemini 分组。具体拼接以输入框下方的预览为准。


## 常见问题

### 检测失败，提示 404？

最常见的是 API 地址多填了 `/v1`。按上表改成 `https://api.niceai.dev`。

### 提示 401？

检查密钥是否完整、是否启用，以及分组是否支持所选模型。

### 模型列表里没有想要的模型？

手动添加模型名，名称以模型广场为准。

## 下一步

- [ChatBox 接入](https://wiki.niceai.dev/guide/clients/chatbox)
- [LobeChat 接入](https://wiki.niceai.dev/guide/clients/lobechat)
