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

# Cherry Studio 配置指南

> 用 Cherry Studio 接入 YeLin AI，并快速切换 200+ 模型。

<Info>
  你只需要两项配置：**API key** 和 base URL。
  base URL 固定为 `https://api.yelinai.com/v1`。
</Info>

## 你先准备什么

1. 你在 **Console** 创建 **API key**。
2. 你已安装 Cherry Studio。

<CardGroup cols={2}>
  <Card title="API key 管理" icon="key" href="/faq/token-management">
    创建并安全保存 key。
  </Card>

  <Card title="模型列表" icon="list" href="/api-reference/models">
    找到你要用的模型 id。
  </Card>
</CardGroup>

## 配置步骤

1. 打开 Cherry Studio 的 **Settings**。
2. 找到 **OpenAI**（或 **API Provider**）相关配置。
3. 填入以下参数。

| 字段       | 你要填什么                        |
| -------- | ---------------------------- |
| Base URL | `https://api.yelinai.com/v1` |
| API key  | 你在 **Console** 复制的 key       |
| Model    | 例如 `gpt-4o-mini`             |

## 验证是否配置成功

你发送一条简单消息。
你能收到回复就说明配置成功。

<Tip>
  你先用 `gpt-4o-mini` 做联调。
  它更省钱。
</Tip>

## 常见问题

### 报 401 或 Unauthorized

你检查 **API key** 是否复制完整。
你也检查 key 是否已被禁用。

### 报 404 或 Not found

你检查 base URL 是否写成了 `https://api.yelinai.com/v1`。
你不要漏掉 `/v1`。