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

# Cherry Studio

> Cherry Studio 接入 ViVi-API 的配置教程。

准备好 [ViVi-API 控制台](https://api.viviai.cc/dashboard)创建的令牌 Key，并确认分组支持所选模型。已有配置请先备份，再合并所需字段。

**1. 进入模型设置**

打开 **设置 → 模型服务**，找到添加服务商或添加模型入口。不同版本的入口名称可能略有差异。

**2. 添加服务商**

填写便于识别的名称，例如 `ViVi-API`，选择与调用方式匹配的提供商类型。

* 通用对话：选择 OpenAI 兼容类型。
* Gemini 原生或生图：选择 Gemini 类型，并使用对应模型。
* Claude 原生：选择 Anthropic 类型。

**3. 填写密钥、地址并添加模型**

填入 ViVi-API Key 和对应 API 地址。OpenAI 兼容方式通常使用 `https://api.viviai.cc/v1`；其他方式按软件字段要求填写，避免重复拼接版本路径。

点击 **管理 / 添加模型**，输入完整模型 ID，并启用该模型。

**4. 返回对话并选择模型**

返回首页或对话界面，切换到刚添加的模型，发送一条简短消息测试。

## Nanobanana Pro 的 2K / 4K 参数

部分 Cherry Studio 版本对 Nanobanana 的参数支持不完整。若模型支持高分辨率，可在模型设置的自定义参数中添加：

| 配置项 | 内容 |
| - | - |
| 参数名 | `imageConfig` |
| 类型 | `JSON` |

```json imageConfig theme={null}
{
  "aspectRatio": "9:16",
  "imageSize": "4K"
}
```

按需要调整比例；如需 2K，可将 `imageSize` 改为 `2K`。最终是否生效取决于所选模型、渠道和客户端是否正确传递该参数。

也可以使用 [Nanobanana 在线生图](https://nano.viviai.cc)，在右上角填入 Key。

更多说明见[接入概览](https://docs.viviai.cc/scenarios.md)与[常见问题](https://docs.viviai.cc/faq.md)。


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