外观
Cherry Studio 接入自定义 API
在 Cherry Studio 的「设置 → 模型服务」中添加一个 OpenAI 类型的服务商,API 地址填 https://api.niceai.dev(不用加 /v1,Cherry Studio 会自动补全),再填入 NiceAI 密钥并添加模型。
准备工作
- 从 Cherry Studio 官网下载安装客户端。
- 在 NiceAI 控制台「API 密钥」页面创建密钥,分组按所用模型选择。
配置步骤
- 打开 Cherry Studio,进入 设置 → 模型服务,点击 添加。
- 名称填
NiceAI,提供商类型选择 OpenAI。 - 填写:
| 设置项 | 填写内容 |
|---|---|
| API 密钥 | 你的 NiceAI 密钥 |
| API 地址 | https://api.niceai.dev |
- 点击 管理 或 添加,从列表中选择模型,或手动输入 模型广场 中的模型名。
- 点击 检测,通过后打开右上角的启用开关。
- 回到对话页,在顶部选择 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?
检查密钥是否完整、是否启用,以及分组是否支持所选模型。
模型列表里没有想要的模型?
手动添加模型名,名称以模型广场为准。