接入软件
Cherry Studio
国内常用的桌面聊天客户端:添加一个自定义服务商。
约 6 分钟适合:用 Cherry Studio 聊天、写作的用户
开始之前
- 已安装 Cherry Studio
- 一把 Key 和一个模型名
步骤 1 · STEP 0x01
添加自定义服务商
设置 → 模型服务
1
+ 添加服务商
2
提供商名称
随便取,例如:我的 API
3
提供商类型
OpenAI
4
确定
- 点左下角的设置(齿轮),选「模型服务」,点「+ 添加服务商」。
- 名称随便取;类型选 OpenAI(OpenAI 兼容的服务都选它)。
步骤 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)。