在 Cherry Studio 中使用 Tokenhot

Cherry Studio 是一款支持 Windows、macOS、Linux 的 AI 桌面客户端，内置多模型对话、知识库等功能。

我们可以将 Tokenhot 配置为服务商后，调用 GPT、Claude、Gemini、DeepSeek 等主流大模型。

支持的接入协议

Tokenhot 兼容以下四种协议：

OpenAI Chat — 路径 /v1/chat/completions，用于 GPT 系列，如 openai/gpt-4.1。

OpenAI Response — 路径 /v1/responses，同样适用于 GPT 系列，如 openai/gpt-5.4-mini。

Claude — 路径 /anthropic/v1/messages，用于 Claude 系列，如 anthropic/claude-sonnet-4.6。

Gemini — 路径 /gemini/v1beta/models，用于 Gemini 系列，如 google/gemini-3.1-pro-preview。

准备工作

在 Tokenhot 控制台注册并获取 API Key

下载并安装 Cherry Studio

配置步骤

第 1 步：打开设置

启动 Cherry Studio，点击左下角设置图标。

第 2 步：新增服务商

进入 模型服务，点击底部 + 添加，填写名称并选择对应类型：

OpenAI Chat / OpenAI Response → 类型选 OpenAI

Claude → 类型选 Anthropic

Gemini → 类型选 Gemini

OpenAI Response 需在配置页额外开启 Response 模式。

第 3 步：填写 API 信息

各协议对应的 API 地址如下：

协议	API 地址
OpenAI Chat / Response	`https://api.tokenhot.cn/v1`
Claude	`https://api.tokenhot.cn`
Gemini	`https://api.tokenhot.cn`

API 密钥统一填写你的 Tokenhot API Key。

确认右上角开关处于 开启（ON） 状态，否则该服务商不会显示在模型选择器中。

第 4 步：添加模型

点击管理按钮拉取模型列表，点击模型右侧 + 加入启用列表。

第 5 步：验证

点击检测，选择一个模型测试，提示通过即配置完成。

开始对话

回到主界面，点击顶部模型选择器，在对应服务商下选择模型即可开始使用。

图片生成

Cherry Studio 支持通过 Gemini 协议调用 Tokenhot 的图片生成能力。

配置步骤

新增一个 Gemini 类型的服务商，API 地址填 https://api.tokenhot.cn

添加所需的生图模型

右键点击助手 → 编辑助手，将默认模型切换为生图模型，并添加以下自定义参数：

参数名	类型	值
`responseModalities`	JSON	`["IMAGE"]`
`imageConfig`	JSON	`{"aspectRatio": "1:1", "imageSize": "1K"}`

如需 2K 分辨率，将 imageSize 改为 "2K" 即可。

保存后在对话框输入描述，直接生成图片。

常见问题

模型列表为空：检查 API 地址末尾没有多余斜杠，API Key 是否完整粘贴。

连接失败：确认 API Key 和地址无误，检查本地网络是否正常。

服务商不显示：确认配置页右上角开关已开启。

模型列表为空：手动添加所需模型。

Cherry Studio

在 Cherry Studio 中使用 Tokenhot#

支持的接入协议#

准备工作#

配置步骤#

第 1 步：打开设置#

第 2 步：新增服务商#

第 3 步：填写 API 信息#

第 4 步：添加模型#

第 5 步：验证#

开始对话#

图片生成#

配置步骤#

常见问题#

在 Cherry Studio 中使用 Tokenhot

支持的接入协议

准备工作

配置步骤

第 1 步：打开设置

第 2 步：新增服务商

第 3 步：填写 API 信息

第 4 步：添加模型

第 5 步：验证

开始对话

图片生成

配置步骤

常见问题