算力猫
← 返回教程列表

接入软件

Cherry Studio

国内常用的桌面聊天客户端:添加一个自定义服务商。

约 6 分钟适合:用 Cherry Studio 聊天、写作的用户

开始之前

  • 已安装 Cherry Studio
  • 一把 Key 和一个模型名

步骤 1 · STEP 0x01

添加自定义服务商

设置 → 模型服务
1
+ 添加服务商
2

提供商名称

随便取,例如:我的 API
3

提供商类型

OpenAI
4
确定
示意图,以软件当前版本界面为准
  • 点左下角的设置(齿轮),选「模型服务」,点「+ 添加服务商」。
  • 名称随便取;类型选 OpenAI(OpenAI 兼容的服务都选它)。

去创建 Key →

步骤 2 · STEP 0x02

填 API 密钥和地址

设置 → 模型服务 → 你的服务商
1

API 密钥

<你的 Key>
2

API 地址

https://api.suanlimao.shop
3
检查
示意图,以软件当前版本界面为准
官方说明:API 地址通常只填根地址 https://api.suanlimao.shop,Cherry Studio 会自动补上 /v1/chat/completions。如果你填了带 /v1 的地址想让它原样使用,在末尾加一个 #(以 # 结尾时不再自动拼接)。
  • 多个 Key 可以用英文逗号隔开,会按顺序轮询;一般只填一把就够。

步骤 3 · STEP 0x03

获取模型并启用

设置 → 模型服务 → 你的服务商
1
获取模型列表
2
+(手动添加模型)
3

右上角的开关

开
示意图,以软件当前版本界面为准
  • 点「获取模型列表」拉取我们支持的模型,勾选要用的;也可以点「+」手动填模型名。
  • 务必打开右上角的开关,服务商才算启用。
  • 点「检查」并选一个模型测试:失败时官方提示先检查模型列表里有没有填错或不支持的模型。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。

打开模型广场 →

步骤 4 · STEP 0x04

新建对话并选择模型

对话
1

对话框上方的模型选择

你刚添加的模型
2

输入框

你好
示意图,以软件当前版本界面为准
新建对话后要在上方手动选模型,否则可能还在用默认模型而报错。

✓ 怎么确认成功了

  • 对话能正常回答,控制台「用量」页出现请求。

常见问题

「检查」失败?

先看 Key 有没有复制完整,再看地址和模型名。余额不足也会失败,去控制台看一下余额。

报 404?

多半是地址拼接出了问题:按官方规则只填根地址 https://api.suanlimao.shop;如果你的版本必须填带 /v1 的地址,在末尾加 # 让它原样使用。

模型列表是空的?

先点「获取模型列表」;仍然没有就手动添加模型名(从模型广场复制)。

添加后选不到模型?

检查右上角的开关是否打开,以及模型是否已勾选 / 添加。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。