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

# Cherry Studio

> 在 Cherry Studio 中添加 OpenPAI 作为模型提供商

[Cherry Studio](https://www.cherry-ai.com/) 是一款跨平台的多模型 AI 桌面客户端。

## 配置步骤

<Steps>
  <Step title="打开设置">
    左下角齿轮图标 → **模型服务**。
  </Step>

  <Step title="选择 OpenAI 兼容服务商">
    在服务商列表中选择 **OpenAI** 或新增一个 **自定义 OpenAI 兼容** 服务商。
    建议命名为 `OpenPAI`。
  </Step>

  <Step title="填写连接信息">
    * **API 地址 / Base URL**:`https://openp.ai/v1`
    * **API 密钥**:粘贴 OpenPAI 控制台获取的 `sk-` 密钥
    * **模型**:点击 **添加模型**,填入需要使用的模型 ID(例如 `gpt-5.5`、`claude-opus-4-8`、`gemini-3.1-pro-preview`)
  </Step>

  <Step title="点击连接检查 / 启用">
    Cherry Studio 会发起一次 `/v1/models` 调用验证密钥可用。
  </Step>

  <Step title="新建对话">
    回到主界面 → 新建对话 → 模型选择刚刚配置的 OpenPAI 模型即可开始使用。
  </Step>
</Steps>

## 提示

* Cherry Studio 支持 **同时启用多个服务商**,可以把 OpenPAI 作为主要服务,其他服务商作为备用。
* 若需要使用 Anthropic 原生协议(`/v1/messages`)以获得 thinking、cache\_control 等高级特性,需要在 Cherry Studio 中选择 **Anthropic 兼容** 服务商,Base URL 填 `https://openp.ai`(不带 `/v1`)。
* Gemini 原生协议同理,选择 **Gemini** 服务商,Base URL 填 `https://openp.ai`。

## 常见问题

<AccordionGroup>
  <Accordion title="提示 401 invalid_api_key">
    * 检查密钥是否完整粘贴(末尾无空格 / 换行)。
    * 在 OpenPAI 控制台确认该令牌未被禁用 / 过期。
  </Accordion>

  <Accordion title="模型列表为空">
    * 点击 **从服务商获取模型** 按钮,Cherry Studio 会拉取 `/v1/models`。
    * 若仍为空,可手动 **添加模型** 输入模型 ID。
  </Accordion>

  <Accordion title="如何区分 OpenPAI 与 OpenAI 官方?">
    在服务商显示名中区分(例如 `OpenPAI` vs `OpenAI`)。
    左下角的对话历史会显示使用的服务商名。
  </Accordion>
</AccordionGroup>