Cherry Studio 接入

Cherry Studio 是桌面 AI 客户端。平台对它的支持是一键导入：不用手抄 Base URL 与 Key。

一键导入（推荐）

1. 控制台 →「API 密钥」，找到要用的 Key。
2. 点该行右侧的「更多」菜单 →「聊天 / Chat」→ Cherry Studio。
3. 客户端会被拉起并带上接入信息；确认后即可在模型列表里选择平台模型。

之所以能一键导入，是因为平台在 /api/status 里发布了客户端接入清单（chats）， 并且在令牌菜单里按清单生成对应的深链。

手动配置

如果客户端未自动拉起，按 OpenAI 兼容方式手动添加：

项	值
提供商类型	OpenAI（兼容）
API 地址 / Base URL	https://api.token.heimatianqi.com/v1
API Key	控制台创建的 sk-heima-xxxxxxxx
模型	控制台「模型与价格」里的公开模型名，例如 deepseek-v4-flash

验证

在客户端新建对话，选一个模型发一句「你好」。若返回内容即接入成功； 失败时先在控制台的「使用日志」里看有没有这条请求（有=请求已到平台）。

常见问题

• 401：Key 复制不完整或已被禁用。
• 403 no access to model：该 Key 的模型白名单里没有这个型号，去「API 密钥」里放开或换 Key。
• 连接超时：Base URL 必须以 /v1 结尾，且不要带多余路径。