Cherry Studio 接入教程

推荐使用内置的 New API 服务商。 只填站点根地址和密钥，再获取模型，不需要手工拼接接口路径。

准备材料

• 模型 API 密钥：还没有就先创建密钥，记下所属分组。
• API 地址：https://v1.123336.xyz；备用 https://api.123336.xyz。
• 模型 ID：从模型广场复制，或用密钥获取列表。

推荐：内置 New API 服务商

1. 打开 设置 → 模型服务 → New API。

2. 填入以下配置：

   字段	填写内容
   API 密钥	该分组的 sk- 密钥
   API 地址	https://v1.123336.xyz

3. 获取模型列表，选择需要的模型；手动添加时保持模型 ID 完全一致。

4. 执行检测，打开服务商的启用开关。

5. 回到聊天界面，选择该服务商下的模型，发送简短消息测试。

Cherry Studio 会按协议补全 /v1 或 /v1beta。不要填 /chat/completions 等完整路径，也不要在本站地址后加 #。 这套填法来自 Cherry Studio 官方 New API 教程。

旧版本：OpenAI 兼容方式

如果没有 New API 入口，添加 OpenAI / OpenAI 兼容服务商，使用相同根地址和密钥。模型选择支持的 OpenAI 协议即可；支持多协议的新版建议优先使用上一种方式。

常见问题

• 检测成功，但聊天没有该模型：确认服务商已启用，模型已添加，并在聊天界面选中了它。
• 404 / 地址重复出现 /v1/v1：恢复为根地址；不要复制 SDK 使用的带 /v1 地址。
• 部分协议仍请求旧站点：检查 New API 服务商中的协议专用地址，清除曾经保留的旧值后重新检测。
• 模型不在列表里：核对密钥分组；不同分组建议分别建立服务商配置。
• Claude MAX 缓存表现不佳：该渠道推荐使用 Claude Code，不要把其他客户端的缓存表现当成相同保证。