# 用 CherryStudio + UModelverse 画图

CherryStudio 是一款多模型 AI 桌面客户端，支持直接在对话中调用图像生成模型。本文介绍如何通过 UModelverse 平台在 CherryStudio 中完成 AI 画图。

## **1. 安装 CherryStudio**

前往 [CherryStudio 官网](https://cherry-ai.com) 下载并安装对应平台的客户端。

## **2. 获取 API Key**

访问 [UModelverse 控制台](https://console.ucloud.cn/modelverse/api) 获取您的 API 密钥。

## **3. 添加 UModelverse 服务商**

1. 打开 CherryStudio，进入 **设置** → **模型服务**。

2. 点击 **添加服务商**，按下表填写：

| 项目 | 填写值 |
| --- | --- |
| 服务商名称 | `UModelverse` |
| API Key | 您的 UModelverse API Key |
| API 地址 | `https://api.modelverse.cn/v1` |

3. 点击左下角 **管理**，获取模型列表，添加需要的图像模型。

4. 确认右上角开关已开启。

UModelverse 支持的图像模型如下，按需选择：

| 模型 | 特点 |
| --- | --- |
| `gpt-image-2` | OpenAI 最新图像模型，指令理解强，支持中文提示词 |
| `flux-2-pro` | Black Forest Labs 最新一代，写实风格、复杂构图首选 |
| `flux-kontext-pro` | 支持参考图编辑和风格迁移 |
| `doubao-seedream-5-0-260128` | 豆包最新版，中文提示词友好，支持信息图和复杂场景 |

## **4. 开始画图**

1. 新建话题，在模型选择器中选择图像模型（如 `gpt-image-2`）。

2. 直接在对话框输入提示词，发送即可生成图片。提示词写法详见《AI 画图提示词写法》。

## **常见问题**

### 生成失败或报错认证失败？

请逐项确认：

1. API Key 来自 UModelverse 平台，复制完整且无空格。
2. API 地址为 `https://api.modelverse.cn/v1`（带 `/v1`）。
3. 模型 ID 与 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)完全一致。