> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio 接入 APIONE

> 添加 OpenAI 兼容服务，在桌面端选择 APIONE 模型聊天。

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

## 准备

安装 Cherry Studio，并在 [APIONE 密钥页](https://apione.ai/zh/app/api-keys)创建密钥。先选一个支持 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](https://mintcdn.com/apione/bPc0c0uWIOMLKxcC/images/integrations/screenshots/cherry-studio-apione-provider-v2.png?fit=max\&auto=format\&n=bPc0c0uWIOMLKxcC\&q=85\&s=67d5f3fea9a8e1ee97e43ad93d47cb23)

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 地址](https://mintcdn.com/apione/OyYiEY31YyCo4SOx/images/integrations/screenshots/cherry-studio-apione-connection-marked.png?fit=max\&auto=format\&n=OyYiEY31YyCo4SOx\&q=85\&s=d2c25fa8ef593d29a1821a29a3392f9e)

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

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

![Cherry Studio 的 APIONE 模型搜索和选择弹窗](https://mintcdn.com/apione/OyYiEY31YyCo4SOx/images/integrations/screenshots/cherry-studio-apione-model-picker.png?fit=max\&auto=format\&n=OyYiEY31YyCo4SOx\&q=85\&s=d5fdf2e9c16ad80e06de093dda8c02c6)

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

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

![Cherry Studio 使用 APIONE 模型返回对话内容](https://mintcdn.com/apione/OyYiEY31YyCo4SOx/images/integrations/screenshots/cherry-studio-apione-chat-reply.png?fit=max\&auto=format\&n=OyYiEY31YyCo4SOx\&q=85\&s=b0889b0f6c18ae58f473ce7270bcc12f)

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

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

## 验证后再开启功能

先确认普通文本能回复，再测试图片、附件与工具。模型能出现在列表里，不代表支持所有输入类型。

* **认证失败**：重新粘贴密钥，检查空格、有效期和模型权限。
* **模型不存在**：核对实际模型 ID（请求中的 `model` 参数），不要用显示名称代替。模型 ID 用来选择模型；请求 ID 用来追踪某一次调用。
* **测试成功但聊天失败**：检查当前助手是否选中了 APIONE，以及是否启用了模型不支持的额外参数。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.