Cherry Studio

在 Cherry Studio 中使用 678API

通过 Cherry Studio 的自定义服务商功能添加 678API，可在桌面端管理模型、对话和助手。

获取 Cherry Studio

开源桌面客户端

支持多模型服务商的桌面客户端，可通过自定义 OpenAI 服务商接入 678API。

服务商名称678API

服务商类型OpenAI

API 地址https://www.678api.com/v1

API Key控制台创建的 API Key

模型 ID控制台显示的完整模型名

打开模型服务设置

点击 Cherry Studio 左下角的设置图标，进入 模型服务。

新增自定义服务商

点击服务商列表底部的添加，名称填写 678API，类型选择 OpenAI，然后保存。

填写 API Key

选择刚创建的 678API 服务商，粘贴控制台创建的 API Key。建议为 Cherry Studio 单独创建密钥。

填写 API 地址

API 地址填写 https://www.678api.com/v1。不要重复追加 /v1、/chat/completions 或其他接口路径。

检查连接

点击 API Key 右侧的检查。验证失败时先检查密钥、地址、余额和网络。

添加模型

在模型管理中点击添加，从 678API 控制台复制完整模型 ID。若版本支持拉取模型列表，也可以尝试自动获取。

启用并开始对话

打开服务商右侧的启用开关，在聊天界面选择 678API 服务商和模型，发送一条短消息验证。

现象	处理方式
检查密钥失败	确认 API 地址为 `https://www.678api.com/v1`，Key 没有空格且账户有可用额度。
模型列表为空	手动添加控制台中的模型 ID；部分兼容服务不会自动返回模型列表。
404 / model not found	检查模型 ID 的大小写、短横线和版本后缀，并确认账户分组拥有权限。
对话没有流式输出	检查模型设置中的 Stream / 流式输出选项，并升级 Cherry Studio 后重试。

地址格式

这里填写 Base URL https://www.678api.com/v1，不是完整的 /chat/completions 请求地址。

账号与切换

无需退出 Cherry Studio 或其他服务商账号。每次对话按所选服务商和模型发送请求；切回原服务商即可恢复原来的模型。