返回博客

工具与集成指南

将 Cherry Studio 连接到 CheapTokens：自定义提供商、Base URL

在 Cherry Studio 中添加自定义提供商：带末尾斜杠的 Base URL、API 密钥、模型 id 和模型检查，以及 401 和 404 的修复方法。

作者：CheapTokens Team发布于 5 分钟阅读

Cherry Studio 连接到 CheapTokens：添加提供商、API 密钥、DeepSeek-V4-Flash
本页内容
  1. 打开应用前你需要准备什么
  2. 添加自定义提供商
  3. 为什么末尾斜杠很重要
  4. 密钥、模型和模型检查
  5. 发送第一条消息
  6. 桌面聊天中该用哪个模型
  7. 一次聊天会话的成本
  8. 如果它不工作

要在 Cherry Studio 中使用 CheapTokens，请添加一个自定义提供商（设置 → 模型提供商 → 添加提供商），在 OpenAI Base URL 字段中填入 https://api.cheaptokens.dev/v1/，粘贴你的 API 密钥，并手动添加模型 id deepseek-ai/DeepSeek-V4-Flash-0731。然后用模型检查验证密钥，并发送一条问候消息。这就是全部工作；唯一容易出问题的细节是 URL 末尾的斜杠。

你打开桌面聊天应用，是因为你想要一个窗口容纳多个模型、一个余额支撑它们，而不是每个服务开一个浏览器标签页。Cherry Studio 正是为此而建：它是一个面向 Windows、macOS 和 Linux 的开源 AI 工作台（AGPL-3.0 社区版），包含聊天、智能体和知识库，并接受任何 OpenAI 兼容服务作为自定义提供商。CheapTokens 使用 OpenAI Chat Completions 格式，因此可以适配。以下步骤遵循 Cherry Studio 文档中关于自定义提供商的页面，检查于 2026 年 11 月 7 日；应用本身会变化，所以如果某个标签移动了位置，请在附近寻找相同的词。

打开应用前你需要准备什么#

三样东西，都很简短：

  • Base URL：https://api.cheaptokens.dev/v1/（带末尾斜杠——原因见下一节）；
  • 来自你 CheapTokens 账户的 API 密钥，保存在可以复制的地方，不要粘贴到共享笔记中；
  • 完整的模型 id。价格列表中的短名称不会被 API 接受；请使用网关 id，例如 deepseek-ai/DeepSeek-V4-Flash-0731。其他 id 见列出模型指南和 CheapTokens 文档。

添加自定义提供商#

打开设置（齿轮图标），然后进入模型提供商。在提供商列表底部是 + 添加提供商。点击它，会出现 添加自定义提供商 对话框。

按如下方式填写：

字段 填写内容
提供商名称 CheapTokens（任何你能识别的名称）
API 密钥 你的 CheapTokens 密钥
OpenAI Base URL https://api.cheaptokens.dev/v1/

Cherry Studio 默认显示 'OpenAI' 和 'Anthropic' 端点字段。只填写你实际使用的协议；对于普通聊天，就是 OpenAI 那个，Anthropic 字段可以留空。在每个 Base URL 字段下方，应用会显示最终请求路径的预览。读一下它。这是在你发送任何内容之前发现错误地址的最快方法。

添加自定义提供商对话框的值
在 Cherry Studio 的添加自定义提供商对话框中要输入的值：名称、密钥、OpenAI Base URL 和模型 id

点击 添加 保存。

为什么末尾斜杠很重要#

Cherry Studio 根据其文档中的三条规则从你的 Base URL 构建请求 URL（检查于 2026 年 11 月 7 日）：

  • 像 https://example.com 这样的根地址会追加 /v1/chat/completions；
  • 以 / 结尾的地址只会追加 chat/completions；
  • 以 # 结尾的地址会完全按输入使用，不添加任何内容。

CheapTokens 位于 /v1 下，因此 https://api.cheaptokens.dev/v1/ 是变成 https://api.cheaptokens.dev/v1/chat/completions 的形式——即 API 期望的路径。字段下方的预览应正好显示该内容。如果你看到 /v1/v1/ 或完全没有 /v1，请在继续之前修正该字段。

两种 Base URL 结尾及各自产生的路径
Cherry Studio 如何补全 Base URL：末尾斜杠会添加 chat/completions，末尾 # 则按原样使用

密钥、模型和模型检查#

回到提供商页面，有五个小步骤。按此顺序执行：

排序

按此顺序连接提供商

  1. 打开提供商的启用开关（其页面右上角）
  2. 输入 API 密钥
  3. 点击模型检查以验证密钥
  4. 检查 Base URL
  5. 在模型管理中用 + 按钮添加模型 id

关于第 5 步的说明。页面还有一个 同步模型 按钮，会从服务获取模型列表。可靠的方式是用 + 自己添加 id：准确输入 deepseek-ai/DeepSeek-V4-Flash-0731，包括 deepseek-ai/ 部分。你可以添加哪些模型：

模型 要输入的模型 id 上下文 最大回答
DeepSeek-V4-Flash deepseek-ai/DeepSeek-V4-Flash-0731 380K 32,768 tokens
GLM-5.3-Flash zai-org/GLM-5.3-Flash 390K 8,192 tokens
MiniMax-M2.7 MiniMaxAI/MiniMax-M2.7 180K 8,192 tokens

模型检查 是密钥字段旁边的按钮；根据 Cherry Studio 文档，它会检查密钥是否有效。如果它报错，请跳到下面的错误部分：原因通常是三个字段之一。

发送第一条消息#

打开一个新聊天，在顶部的模型选择器中选择 CheapTokens 提供商和你添加的模型，然后写一些简短的内容，比如“用两句话解释什么是 token。”模型回复意味着整条链路都正常：密钥、地址、模型 id。

想不通过应用查看请求？这里有一个普通的 Chat Completions 调用：

bash
export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

回复是 JSON，文本在 choices[0].message.content 中，token 计数在 usage 中。

桌面聊天中该用哪个模型#

聊天窗口与智能体循环是不同的工作：你提问、阅读、再提问。这时有两件事重要：回答可以有多长，以及对话能容纳多大。

  • DeepSeek-V4-Flash——通用聊天和长文档的默认选择：每次回答最多 32,768 个输出 token，380K 上下文，任何时段同一价格。总体而言，输入和输出合计，它比 OpenRouter 便宜。
  • GLM-5.3-Flash——日常聊天，三者中窗口最大（390K），输入和输出都比 OpenRouter 便宜。
  • MiniMax-M2.7——聊天和智能体风格任务，180K 上下文，两边都比 OpenRouter 便宜。

三者共用一个余额，因此你可以把三个 id 都添加到同一个提供商，并在模型选择器中切换，而无需改动密钥。

一次聊天会话的成本#

这里是一个粗略的图景。假设你有一个 20 条消息的对话。每条消息都会重新发送之前的历史记录，因此一次请求平均约 6,000 个输入 token 和 500 个输出 token（原因见为什么长聊天成本更高）。在 DeepSeek-V4-Flash 上，一次请求花费 $0.00014。二十次请求在下面的计算器中；移动滑块以匹配你自己的聊天。

成本计算器

一次 20 条消息的聊天会话

每次请求的输入 token 数: 6,000 · 每次请求的输出 token 数: 500 · 每日请求数: 20

模型每天每月
GLM-5.3-Flash$0.0028$0.084
DeepSeek-V4-Flash$0.0028$0.084
MiniMax-M2.7$0.0075$0.225

下表在所有模型上运行同一会话，并附有 OpenRouter 列用于比较：

模型 每次请求 20 次请求 OpenRouter，20 次请求
GLM-5.3-Flash $0.00014 $0.0028 $0.0049
DeepSeek-V4-Flash $0.00014 $0.0028 $0.0098
MiniMax-M2.7 $0.00038 $0.0075 $0.09

每次请求 6,000 个输入 token 和 500 个输出 token。每 100 万 token 的价格为当前价格，会随我们的资费一同变动；OpenRouter 列显示相同工作负载的参考价格。

当前每 1M token 的价格见 CheapTokens 定价。

如果它不工作#

大多数问题来自同样的三个字段：密钥、URL、模型 id。将你看到的情况与原因对应：

配对

将症状与可能原因对应

  • 401 UnauthorizedAPI 密钥缺失、输入错误或有多余空格
  • 404 Not FoundBase URL 错误：路径预览没有以 /v1/chat/completions 结尾
  • 应用报告未知模型可能是模型 id 用了短名称；请输入带前缀的完整 id
  • 应用报告余额不足可能是余额为空，需要充值

关于这些错误的更详细说明，见 API 401 或 404：错误的密钥、base URL 或模型 id。如果你更喜欢基于浏览器的聊天而不是桌面应用，Open WebUI 的工作方式相同。

来源：Cherry Studio 文档，自定义提供商和提供商设置页面，检查于 2026 年 11 月 7 日；项目位于 github.com/CherryHQ/cherry-studio。

标签: