Cherry Studio

Cherry Studio 可按通用 OpenAI-compatible 方式手动配置。本页不是 Cherry Studio 的厂商认证，也不承诺它的所有助手、插件、媒体能力或模型选择器都已经端到端验证。

开始前

从 Cherry Studio 当前官方发布页安装对应 Windows、macOS 或 Linux 版本。创建一个只供该桌面客户端使用的 API Key，并用它请求模型列表：

curl 'https://ai.tavonilo.com/v1/models' \
  -H "Authorization: Bearer $AI_SHOP_API_KEY"

只记录返回的一个 <MODEL_ID>。Windows、macOS 和 Linux 都应在应用的安全凭据存储或用户级设置中保存 Key；不要把它放入同步文件夹、公开仓库或截图。

手动配置

在当前版本的供应商设置中创建 OpenAI-compatible / Custom OpenAI 供应商。表单名称可能变化，但值应保持如下：

字段	值
Provider protocol	OpenAI-compatible
Base URL	https://ai.tavonilo.com/v1
API Key	独立 API Key
Default model	/v1/models 返回的 <MODEL_ID>

不要把完整 /chat/completions 地址填进 Base URL，也不要重复拼接 /v1。

验证与恢复

保存后重启应用，先发送一条短小、非敏感聊天。普通对话成功后，才逐步启用流式、工具、视觉输入或其他可选能力。

• 401：Key 无效、撤销或未正确写入供应商设置。
• 403：检查 Key 的组、模型白名单、余额和路由权限。
• 404：检查 Base URL 是否重复 /v1 或误填成完整接口路径。
• 400：先移除目标模型不支持的可选字段。
• 429 / 5xx：等待后仅安全重试，保留时间、模型、路由、状态和 request ID。

支持请求只提供脱敏诊断信息，绝不发送 API Key、完整私有对话、密码、验证码或付款信息。