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

# Cherry Studio

> 将 AIOHub 配置为 Cherry Studio 的模型服务商。

[Cherry Studio](https://www.cherry-ai.com) 是一个支持多模型的 AI 聊天客户端，体验接近 ChatGPT 或 Claude 官方客户端。支持 Linux、macOS 和 Windows。

## 前置条件

* 已安装 [Cherry Studio](https://www.cherry-ai.com/download)
* 已 [创建 AIOHub API 令牌](/cn/account/create-token)

## 配置方法

<Steps>
  <Step title="添加模型服务商">
    打开 **Settings** → **Model Provider**，创建新的模型服务商：

    | 设置项           | 值                        |
    | ------------- | ------------------------ |
    | Provider 名称   | AIOHub                   |
    | Provider Type | OpenAI API               |
    | API Key       | `sk-你的API令牌`             |
    | API Host      | `https://api.aiohub.org` |
  </Step>

  <Step title="选择模型">
    进入 **Models** → **Manage**，勾选你要使用的模型。
  </Step>

  <Step title="验证连接">
    点击 **Check** 按钮验证连接是否正常。
  </Step>

  <Step title="开始使用">
    进入 **Assistant**，添加新助手，选择刚配置的模型即可开始聊天。
  </Step>
</Steps>

<Note>本页按 Cherry Studio 的 OpenAI API Provider 字段说明。若你在 Cherry Studio 中选择 Anthropic、Gemini 或 Responses 类型，Base URL 和模型可用性会跟随对应协议变化；先用本页配置验证普通对话，再按需要切换 Provider Type。</Note>

## 图片模型

当前 AIOHub 公开支持 OpenAI Images 的生成和编辑端点。Cherry Studio 的绘图功能能否使用，取决于你选择的模型是否在当前 API 令牌的分组中支持图片生成或编辑。

如果只是想在浏览器里测试 GPT 图片生成，可以使用 [Imagine](/cn/clients/imagine)。

## 常见问题

<AccordionGroup>
  <Accordion title="连接测试失败">
    检查 API Host 是否正确填写（不要漏掉 `https://`），以及 API 令牌是否有效。
  </Accordion>

  <Accordion title="模型列表为空">
    确保 Provider Type 选择了正确的 API 格式（OpenAI API），然后手动勾选模型。
  </Accordion>
</AccordionGroup>