# Generating Images with CherryStudio + UModelverse

CherryStudio is a multi-model AI desktop client that supports calling image generation models directly within conversations. This guide explains how to generate AI images in CherryStudio using the UModelverse platform.

## **1. Install CherryStudio**

Go to the [CherryStudio official website](https://cherry-ai.com) to download and install the client for your platform.

## **2. Obtain an API Key**

Visit the [UModelverse Console](https://console.ucloud.cn/modelverse/api) to retrieve your API key.

## **3. Add UModelverse as a Service Provider**

1. Open CherryStudio and navigate to **Settings** → **Model Services**.

2. Click **Add Provider** and fill in the fields as shown in the table below:

| Field | Value |
| --- | --- |
| Provider Name | `UModelverse` |
| API Key | Your UModelverse API Key |
| API Base URL | `https://api-us-ca.umodelverse.ai/v1` |

3. Click **Manage** in the lower-left corner to fetch the model list, then add the image models you need.

4. Confirm that the toggle in the upper-right corner is enabled.

The image models supported by UModelverse are listed below — choose according to your needs:

| Model | Highlights |
| --- | --- |
| `gpt-image-2` | OpenAI's latest image model; strong instruction understanding, supports Chinese prompts |
| `flux-2-pro` | Black Forest Labs' latest generation; best for photorealistic style and complex compositions |
| `flux-kontext-pro` | Supports reference-image editing and style transfer |
| `doubao-seedream-5-0-260128` | Latest Doubao version; Chinese-prompt friendly, supports infographics and complex scenes |

## **4. Start Generating Images**

1. Create a new conversation and select an image model (e.g. `gpt-image-2`) in the model selector.

2. Type your prompt directly in the input box and send it to generate an image. For prompt-writing tips, see the *AI Image Prompt Writing Guide*.

## **Frequently Asked Questions**

### Generation failed or authentication error?

Check each of the following:

1. The API Key is from the UModelverse platform, copied in full with no leading or trailing spaces.
2. The API Base URL is `https://api-us-ca.umodelverse.ai/v1` (including `/v1`).
3. The model ID exactly matches one of the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform.