在 Cherry Studio 中使用 Tokenhot

Cherry Studio 是支持 Windows、macOS、Linux 的 AI 桌面客户端，提供多模型对话、知识库、文件解析和图片生成等功能。

通过 Tokenhot，可在 Cherry Studio 中接入支持 OpenAI、Anthropic、Gemini 协议的模型。

Cherry Studio 会将对话内容、附件和相关参数发送至你选择的模型服务。请勿上传敏感信息；不要在截图、提示词或公开配置中泄露 API Key。

准备工作

在 Tokenhot 模型列表确认目标模型支持的协议。

支持的接入方式

Cherry Studio 服务商类型	适用模型	API 地址
OpenAI	支持 OpenAI Chat Completions 或 Responses 的模型	`https://api.tokenhot.ai`
Anthropic	支持 Anthropic Messages 协议的模型	`https://api.tokenhot.ai`
Gemini	支持 Gemini 协议的模型	`https://api.tokenhot.ai`

在 Cherry Studio 中填写 API 地址时，通常只填写域名部分，不要手动追加 /v1/chat/completions、/v1/messages 或 /v1beta/models。Cherry Studio 会根据服务商类型自动拼接对应路径。
如使用 OpenAI Responses，请在 OpenAI 服务商配置中开启 Response 模式；不要将 Chat Completions 和 Responses 模式混用。

配置步骤

第 1 步：打开设置

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

第 2 步：新增服务商

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

使用 OpenAI Chat Completions 或 OpenAI Responses：选择 OpenAI

使用 Claude / Anthropic Messages：选择 Anthropic

使用 Gemini 协议：选择 Gemini

建议按协议分别创建服务商，例如：

Tokenhot OpenAI
Tokenhot Anthropic
Tokenhot Gemini

这样可以避免在同一个服务商中混用不同协议的模型。

第 3 步：填写 API 信息

在对应服务商中填写：

配置项	值
服务商名称	例如 `Tokenhot OpenAI`，可自定义
API 地址	`https://api.tokenhot.ai`
API Key	你的 Tokenhot API Key
Response 模式	仅 OpenAI Responses 模型需要开启

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

第 4 步：添加模型

点击管理获取或添加模型。

如果可自动获取模型列表：点击目标模型右侧的 +，将模型加入当前服务商。

如果无法自动获取：从 Tokenhot 模型列表复制完整模型 ID，再手动添加。

不要把 Anthropic、Gemini、OpenAI 协议不兼容的模型加入同一个服务商。

第 5 步：验证连接

点击检测，选择已添加的模型进行测试。提示通过即表示配置成功。

如果检测失败，请先检查 API Key、服务商类型、API 地址和模型协议是否一致。

开始对话

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

图片生成

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

仅当模型明确支持图片生成时才可使用本功能。图片尺寸、比例和输出格式以模型实际能力为准。

第 1 步：添加图片生成模型

新增一个 Gemini 类型服务商。

API 地址填写 https://api.tokenhot.ai。

添加已确认支持图片生成的模型。

第 2 步：配置助手参数

右键点击助手，选择 编辑助手，将默认模型切换为图片生成模型。

在自定义参数中添加一项：

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

常用比例示例：

{
  "responseModalities": ["IMAGE"],
  "imageConfig": {
    "aspectRatio": "1:1",
    "imageSize": "1K"
  }
}

如所选模型明确支持更高分辨率，可将 imageSize 改为模型支持的值，例如 "2K"；不支持时会返回参数或模型错误。

第 3 步：生成图片

保存配置后，在对话框中输入图片描述即可生成。

常见问题

模型列表为空

按以下顺序检查：

服务商开关是否已开启。

API Key 是否完整、有效。

服务商类型是否与模型协议一致。

是否已点击模型右侧 + 将模型加入服务商。

自动拉取失败时，是否已从 Tokenhot 模型列表手动添加完整模型 ID。

连接失败或返回 404

确认 API 地址仅填写：

https://api.tokenhot.ai

不要手动填入 /v1/chat/completions、/v1/messages 或 /v1beta/models，除非 Tokenhot 针对当前协议明确提供了特殊地址。

图片无法生成

检查：

当前模型是否支持图片生成，而不只是图片理解。

服务商类型是否为 Gemini。

generationConfig 是否为有效 JSON。

responseModalities 是否包含 "IMAGE"。

imageSize 是否为该模型支持的尺寸。

Cherry Studio

在 Cherry Studio 中使用 Tokenhot#

准备工作#

支持的接入方式#

配置步骤#

第 1 步：打开设置#

第 2 步：新增服务商#

第 3 步：填写 API 信息#

第 4 步：添加模型#

第 5 步：验证连接#

开始对话#

图片生成#

第 1 步：添加图片生成模型#

第 2 步：配置助手参数#

第 3 步：生成图片#

常见问题#

模型列表为空#

连接失败或返回 404#

图片无法生成#