Skip to content
文档

服务商管理(速通版/Express)

速通版(Express)服务商的配置与管理,提供一站式聚合模型服务和统一配额管理。

概述

入口路径: 管理后台 → 模型管理

Express 模型管理主界面

Cherry Studio Express 是企业版专属的一站式模型聚合服务。Express 版通过统一的额度池,直接为您打通主流顶尖大模型(如 GLM-5.2、DeepSeek-V4 等)以及热门开源模型,无需您逐家去各模型官网申请 API Key。

核心价值:

  • 免运维:无需管理几十个不同的 API Key 和账号。
  • 开箱即用:无需逐家配置服务商,直接在企业内即可调用多家模型。
  • 统一结算:所有模型消耗统一从企业余额扣除。

资金看板与充值

在页面顶部,您可以看到当前企业的资源消耗情况。

资金看板
  • 总余额:企业账户当前的资金总量。点击「刷新」可获取最新余额。
  • 已使用:已消耗的金额及占比。
  • 剩余可用:当前可用于调用模型的余额及占比。
  • 请求次数:API 调用的总次数统计。

余额充值

点击右上角的 余额充值 按钮,输入充值金额或选择预设金额(¥100、¥500、¥1,000、¥5,000),选择支付方式完成充值。充值后,资金可用于所有 Express 模型的调用。

余额充值弹窗

模型上架与管理

系统默认提供了海量模型,管理员可以决定哪些模型对员工可见。页面底部提供三个操作标签页:管理模型、添加模型 和 检查连接。

启用/禁用模型

管理模型弹窗
  1. 点击列表底部的 管理模型 按钮。
  2. 在弹出的列表中,按服务商分组浏览模型。每个模型显示能力标签和输入/输出价格。
  3. 通过右侧的 +/- 号控制模型的可见性:
    • + (添加):将模型添加到可用列表,员工在前端可见。
    • - (移除):隐藏该模型,员工不可见。
  4. 可使用搜索框快速查找模型,或切换「仅已选」筛选当前已启用的模型。
  5. 点击 保存。

手动添加新模型

添加模型弹窗

如果 Express 官方发布了新模型(如 deepseek-v4),但列表尚未自动更新,您可以手动添加:

  1. 点击 + 添加模型。
  2. 输入官方通告的 模型 ID (如 qwen3-max)。
  3. 点击 确认 即可立即使用。

如果您希望让开发者在外部应用中直接调用这些 Express 模型,请让其使用完整格式 模型 ID@provider_id 作为 model,并参考 外部应用接入(Express 模型) 完成配置。


读懂模型能力标签 (Tags)

在模型列表中,每个模型名称后面都跟着一排彩色的小图标。这些图标代表了模型的"硬实力",对于分发模型非常重要。

含义说明
🧠 推理高智商模式。代表该模型(如 DeepSeek-V4、GLM-5.2)具备深度思考与推理能力,适合解决复杂逻辑、数学问题或代码架构设计。
👁️ 视觉识图能力。代表该模型可以解析图片内容。如果模型没有此图标,用户上传图片时会报错。
🌐 联网原生联网。部分模型具备原生的搜索整合能力(注意:大多数情况下 Cherry Studio 通过 MCP 实现联网,不依赖模型原生能力)。
🔧 工具插件支持。最重要的图标。只有带扳手图标的模型,才能支持知识库(RAG)、生成图表、或者调用 MCP 工具。
🆓 免费成本控制。代表该模型调用不消耗账户余额。通常出现在本地部署的模型(如 Ollama)或官方提供的免费测试模型上。适合用于高频调试或日常简单对话。
📊 嵌入知识库基石。此类模型不可用于对话。它的作用是将文本转化为"向量数据"(数字),是构建知识库索引的必选项。在聊天界面选择此模型会报错。
🔀 重排精准度优化。此类模型不可用于对话。它用于知识库检索的第二阶段,对搜索结果进行二次打分和重新排序,能显著提高回答的准确性。

配置建议:作为 默认助手模型,请务必选择带有 🔧 (工具) 图标的模型,否则助手将无法使用知识库。


检查连接

在使用模型前,您可以验证与服务商的连通性是否正常。

检查连接弹窗
  1. 点击底部的 检查连接 按钮。
  2. 在弹窗中选择需要检查的模型。
  3. 点击 确认,系统将自动测试该模型的可用性。
  4. 成功反馈:右下角弹出提示 "检查成功 API Key 有效"。

编辑与删除模型

管理员可以对已上架的模型进行编辑或删除操作。

编辑模型设置弹窗

编辑模型

  1. 点击模型右侧的 ⚙️ 设置 按钮,打开「编辑模型设置」弹窗。
  2. 可修改以下信息:
    • 模型 ID:模型的唯一标识(通常无需修改)。
    • 模型名称:自定义显示名称。
    • 模型描述:为模型添加说明文字。
    • 能力设置:展开后可手动指定模型支持的能力标签。
  3. 点击 保存。

请谨慎设置能力标签,错误配置可能导致模型无法正常使用。

删除模型

点击模型右侧的 🗑️ 删除 按钮,即可将该模型从列表中移除。


常见问题 (FAQ)

Q: 为什么我有余额,但提示 "Balance Insufficient"?

A: 请检查该模型是否属于极其昂贵的特殊模型(如某些预览版),或者您的企业设置了单日消费上限。


Q: 为什么某个模型突然变灰或消失了?

A: 上游服务商如果出现大面积故障,Express 会自动熔断该服务以保护系统稳定性。待上游恢复后会自动重新上线。