跳转到主要内容
准备好 ViVi-API 控制台创建的令牌 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
按需要调整比例；如需 2K，可将 imageSize 改为 2K。最终是否生效取决于所选模型、渠道和客户端是否正确传递该参数。 也可以使用 Nanobanana 在线生图，在右上角填入 Key。 更多说明见接入概览与常见问题。