Skip to content

Cherry Studio 接入自定义 API ​

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

准备工作 ​

  1. 从 Cherry Studio 官网下载安装客户端。
  2. 在 NiceAI 控制台「API 密钥」页面创建密钥,分组按所用模型选择。

配置步骤 ​

  1. 打开 Cherry Studio,进入 设置 → 模型服务,点击 添加。
  2. 名称填 NiceAI,提供商类型选择 OpenAI。
  3. 填写:
设置项填写内容
API 密钥你的 NiceAI 密钥
API 地址https://api.niceai.dev
  1. 点击 管理 或 添加,从列表中选择模型,或手动输入 模型广场 中的模型名。
  2. 点击 检测,通过后打开右上角的启用开关。
  3. 回到对话页,在顶部选择 NiceAI 下的模型开始对话。

API 地址的结尾规则 ​

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

填法实际请求结果
https://api.niceai.devhttps://api.niceai.dev/v1/chat/completions正确
https://api.niceai.dev/v1https://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? ​

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

模型列表里没有想要的模型? ​

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

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站