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

# 在 Cherry Studio 中配置 Sub2API

> 在 Cherry Studio 桌面 AI 客户端中添加 Sub2API 作为自定义 OpenAI 兼容服务商，支持多模型对话。

Cherry Studio 是一款桌面端 AI 客户端，支持添加自定义 OpenAI 兼容服务商。将 Sub2API 配置到 Cherry Studio 后，你可以在一个界面中使用 OpenAI、Claude、Gemini、Grok 等多种模型。

## 前置条件

* 已下载并安装 Cherry Studio
* 已获取 Sub2API API Key（详见 [创建 API Key](/getting-started/create-api-key)）

## 配置步骤

<Steps>
  <Step title="打开 Cherry Studio">
    启动 Cherry Studio 桌面客户端。
  </Step>

  <Step title="进入服务商设置">
    点击设置图标，进入「服务商」或「Providers」页面。

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="添加新服务商">
    点击「添加服务商」或「Add Provider」按钮。 选择「OpenAI Compatible」类型。

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="填写服务商信息">
    根据提示填写以下信息：

    | 配置项       | 值                                 |
    | --------- | --------------------------------- |
    | 名称 / Name | `Sub2API`                         |
    | API URL   | `https://sub2api.ruilinlu.com/v1` |
    | API Key   | 你的 Sub2API API Key                |

    <Note>
      TODO：请在后台确认实际配置后填写。（API 路径 `/v1` 需根据实际配置确认）
    </Note>

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="添加模型">
    添加你希望使用的模型名称，例如：

    * `gpt-4o`
    * `claude-opus-4-5`

    <Tip>
      模型名称取决于 Sub2API 中实际提供的模型。建议查看 [模型选择指南](/models/how-to-choose) 了解可用模型。
    </Tip>

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="保存并启用">
    点击保存按钮，确保该服务商状态为「已启用」。 在对话界面中选择刚添加的 Sub2API 服务商及对应模型，开始对话测试。
  </Step>
</Steps>

## 故障排查

<Accordion title="保存后模型列表为空">
  * 确认 API URL 填写正确
  * 检查 API Key 是否有效
  * 参考 [API Key 无效排查](/troubleshooting/api-key-invalid)
</Accordion>

<Accordion title="对话返回 401 错误">
  * 确认使用的是 Sub2API 控制台生成的 API Key
  * 参考 [401 错误排查](/troubleshooting/401)
</Accordion>

<Accordion title="提示模型不可用">
  * 确认添加的模型名称与 Sub2API 支持的模型名称一致
  * 参考 [模型不可用排查](/troubleshooting/model-unavailable)
</Accordion>