跳转到主要内容
Cherry Studio 的模型服务与聊天助手分开管理。先添加 APIONE 服务，再把模型加入列表，最后在会话中选用。

准备

安装 Cherry Studio，并在 APIONE 密钥页创建密钥。先选一个支持 Chat Completions 的文本模型。

建立连接

  1. 打开 Settings → Model Provider，点击 Add。
  2. 名称填写 APIONE，类型选择 OpenAI。
  3. API Key 填入 APIONE 密钥；API Host 填入 https://api.apione.ai/v1/。
  4. 保存后进入 Manager，刷新模型列表，勾选需要的模型。
  5. 返回聊天页，选择 APIONE 下的模型，发送一条简单问题。
Cherry Studio 自定义供应商的 APIONE 地址与掩码 Key

Cherry Studio 新增 APIONE 自定义服务商的配置示例。按所选协议填写对应地址。

地址与模型

不同协议使用对应的基础地址。OpenAI 兼容请求最终应到达 https://api.apione.ai/v1/chat/completions；Anthropic 请求最终应到达 https://api.apione.ai/v1/messages。以客户端地址预览核对路径。

使用 Anthropic 协议

  1. 在 设置 → 模型服务 中添加 APIONE 服务商，协议选择 Anthropic。
  2. API 密钥填写 APIONE API Key，API 地址填写 https://api.apione.ai。
  3. 确认下方预览为 https://api.apione.ai/v1/messages，启用该服务商。
Cherry Studio 中突出标注的 APIONE 密钥与 API 地址

APIONE 服务商的密钥和地址配置，Anthropic 地址预览为 /v1/messages。

点击 获取模型列表，在弹窗中搜索并添加需要的模型。模型 ID 和访问权限以当前 Key 返回结果为准。
Cherry Studio 的 APIONE 模型搜索和选择弹窗

获取模型列表后，搜索并选择 APIONE 模型。

返回聊天页，在助手顶部选择 APIONE 服务商下的模型，发送简短问题。下图展示已选择模型并收到回复的会话。
Cherry Studio 使用 APIONE 模型返回对话内容

在助手会话中选择 APIONE 模型并查看回复。

截图中的模型名称用于演示操作位置，实际选择以当前账号可用模型为准。自动列表失败时，可从 APIONE 模型目录复制准确 ID 手动添加。

验证后再开启功能

先确认普通文本能回复，再测试图片、附件与工具。模型能出现在列表里，不代表支持所有输入类型。
  • 认证失败：重新粘贴密钥，检查空格、有效期和模型权限。
  • 模型不存在：核对实际模型 ID（请求中的 model 参数），不要用显示名称代替。模型 ID 用来选择模型；请求 ID 用来追踪某一次调用。
  • 测试成功但聊天失败：检查当前助手是否选中了 APIONE，以及是否启用了模型不支持的额外参数。
返回集成目录 · 模型选择 · 错误排查