> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/ai-image-generation-guide.md).

# Built-in AI Image Generation Tool

Learn about MaiAgent's built-in AI image generation tools and compare their results and use cases

### 📋 Feature Overview <a href="#feature-summary" id="feature-summary"></a>

MaiAgent includes three AI image generation tools. They can create new images or edit existing ones using reference images. Select them in your AI agent's tool settings to start generating images.

On the AI agent settings page, click <mark style="color:blue;">Select Tools</mark> under <mark style="color:blue;">Tools</mark>. Under <mark style="color:blue;">Built-in Tools</mark>, select any of these image generation tools:

* <mark style="color:blue;">Gemini 3 Pro Image</mark>
* <mark style="color:blue;">Gemini 3.1 Flash Image</mark>
* <mark style="color:blue;">GPT Image 2 image generation tool</mark>

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-79b7d7d056695fd0b39063bb5214a57698409eb5%2Fai-image-tools-select-tools.png?alt=media" alt="Gemini 3.1 Flash Image, GPT Image 2 image generation tool, and Gemini 3 Pro Image in the Select Tools dialog"><figcaption><p>Image generation tools in the Select Tools dialog</p></figcaption></figure>

{% hint style="info" %}
See [Configure tools for an AI agent](/maiagent-user-guide/en/build/tools/configure_tools.md).
{% endhint %}

***

### 🎨 Tool Comparison <a href="#tool-comparison-table" id="tool-comparison-table"></a>

| Tool                       | Key features                                                                          | Best for                                                         |
| -------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| **Gemini 3 Pro Image**     | Context understanding, Chinese prompts, reference images, conversational editing      | Creative work requiring context understanding or Chinese prompts |
| **Gemini 3.1 Flash Image** | Fast generation, Chinese prompts, reference images, multi-step editing instructions   | Rapid iteration and brainstorming                                |
| **GPT Image 2**            | Professional quality, iterative refinement, reference images, transparent backgrounds | Brand design and professional use                                |

### ⭐️ Generation Example <a href="#generation-examples" id="generation-examples"></a>

#### GPT Image 2: Professional Design Example <a href="#gpt-image-professional-example" id="gpt-image-professional-example"></a>

**Prompt:** "Draw a minimalist coffee cup logo with a transparent background, 1024x1024"

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-adda4bd85627865956b8d155649cd637e98c005f%2Fai-image-gpt-image-2-logo-example.png?alt=media" alt="Minimalist coffee cup logo with a transparent background generated by GPT Image 2"><figcaption><p>Coffee cup logo generated by GPT Image 2 (transparent background)</p></figcaption></figure>

**Highlights:** Transparent background, refined lines, and suitable for brand use

***

### 📝 How to Use the Tools and Best Practices <a href="#usage-and-best-practices" id="usage-and-best-practices"></a>

#### Basic Prompt Examples <a href="#basic-syntax" id="basic-syntax"></a>

| Use case                | Example prompt                                                  | Recommended tool       |
| ----------------------- | --------------------------------------------------------------- | ---------------------- |
| **Everyday creation**   | `Draw a cute puppy`                                             | Gemini 3 Pro Image     |
| **Professional design** | `Design a modern minimalist logo with a transparent background` | GPT Image 2            |
| **Rapid prototyping**   | `Quickly generate a concept image for a website home page`      | Gemini 3.1 Flash Image |

#### Multi-round Refinement (GPT Image 2) <a href="#multi-round-iteration-gpt-image" id="multi-round-iteration-gpt-image"></a>

```
Round 1: "Design a logo for a coffee shop"
Round 2: "Change the color to dark brown"
Round 3: "Add some steam"
Round 4: "Make the overall design more minimalist"

```

#### Edit Using a Reference Image <a href="#image-reference-editing-gemini-native" id="image-reference-editing-gemini-native"></a>

Gemini 3 Pro Image, Gemini 3.1 Flash Image, and GPT Image 2 all support editing with reference images. Upload the image you want to change in the conversation and describe only the changes you want. Unmentioned parts will remain as unchanged as possible:

```
"Use this image as a reference and change the background to a beach scene"
"Keep the person unchanged and only change the clothing color"
"Add some flowers to this scene"

```

{% hint style="info" %}
If the AI agent says it cannot access a previously generated image, upload that image again in the conversation before requesting changes.
{% endhint %}

***

### 🎯 Practical Use Cases <a href="#use-case-guide" id="use-case-guide"></a>

#### **Use Case 1: Social Media Content** <a href="#use-case-social-media-content" id="use-case-social-media-content"></a>

**Need:** Create an image for an Instagram post

**Recommended:** Gemini 3 Pro Image

**Example prompt:** `Create a cozy cafe scene for an IG post`

#### **Use Case 2: Corporate Brand Design** <a href="#use-case-enterprise-brand-design" id="use-case-enterprise-brand-design"></a>

**Need:** Design a company logo and brand assets

**Recommended:** GPT Image 2

**Example prompt:** `Design a minimalist, modern logo for a technology company with a transparent background`

#### **Use Case 3: Brainstorming and Prototyping** <a href="#use-case-creative-ideation-prototype" id="use-case-creative-ideation-prototype"></a>

**Need:** Quickly visualize ideas and refine them iteratively

**Recommended:** Gemini 3.1 Flash Image

**Example prompt:** `Concept art for a mobile app interface design`

***

### ❓ Frequently Asked Questions <a href="#faq-and-solutions" id="faq-and-solutions"></a>

#### Image Quality <a href="#image-quality-issues" id="image-quality-issues"></a>

**Q: How can I get the highest-quality images?**

**A:** Use GPT Image 2 or Gemini 3 Pro Image and provide a detailed description:

* ✅ Specify the style (for example, "professional photography")
* ✅ Describe the scene in detail (lighting, angle, atmosphere)
* ✅ State your quality requirements (for example, "high resolution" or "commercial quality")

**Q: Why doesn't the generated image match my expectations?**

**A:** Try improving your prompt:

* 🎯 Use concrete details instead of abstract descriptions
* 🎨 Specify the artistic style
* 📐 Describe the composition and viewing angle
* 🌈 Describe the colors and lighting

#### Features <a href="#feature-usage-issues" id="feature-usage-issues"></a>

**Q: How do I generate an image with a transparent background?**

**A:** Use GPT Image 2 and explicitly request a transparent background:

```
Design a logo with a transparent background
Create an icon with a transparent background

```

**Q: Can I edit an image I have already generated?**

**A:** Yes. Gemini 3 Pro Image, Gemini 3.1 Flash Image, and GPT Image 2 all support reference image editing. Upload the image you want to change, then describe the change:

```
Use this image as a reference and change the sky to sunset colors
Keep the composition unchanged and only change the person's clothing

```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/ai-image-generation-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.