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

# AI generation

> Describe a texture, generate images with credits, and add the one you like as a layer.

The **AI** tab turns a description into images and adds the one you choose as a layer on the texture you are editing. It is available on any editable texture except the minimap, and it needs a signed-in account and credits. Plans and credits are explained at [rageon.dev/pricing](https://rageon.dev/pricing).

## Generate a texture

**1. Open the AI tab and describe the result**

Write what the texture should show in the **Request** box, up to 2000 characters. **Improve the request** (the sparkle icon in the box) rewrites your text and also uses credits; **Undo** restores your original.

**Add photos** attaches reference images in your own style. You can also paste with **Ctrl+V** or drop image files on the column. References larger than 1024 on the longest side are reduced to fit. The chosen model may accept fewer photos than you attached; dimmed photos are left out of the request.

![Editor with the AI tab open: a request, Photos, Model, Quality, Type, Size, Candidates, Context toggles, and the cost next to Generate](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-ai-panel.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=3952a930573ed935b32aae4e05bf1c74)

The AI tab with a request written.

**2. Choose the type**

**Material** makes a pattern that repeats across a surface: a plate, asphalt, fabric. **UV template** paints the part unfolded and flattened on the sheet, like the bodywork of a livery.

![AI tab with UV template selected, Candidates fixed at one, and the Context toggles on](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-ai-uv-template.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=48f4f40e52d4140d1a0185fa27af36f6)

UV template with the context options.

**3. Choose model, quality, size, and candidates**

**Model** and **Quality** set the image model and its tier: further right on the slider means higher quality and more credits. **Size** is the image's longest side, or the longest side of each view when **UV template** uses model views. It cannot exceed the texture. **Candidates** asks for one, two, or four variations, each charged in full.

**4. Check the cost and click Generate**

The cost of the request is at the bottom, next to the button. The price is an estimate: the final amount is calculated when the request is sent. Progress runs through the steps with timers, and you can switch tabs or textures while it works. The result lands in that texture's history.

![AI tab during a generation with four candidates requested, a step timer in the footer, and a Cancel button](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-ai-running.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=cbabfea542e3c0893c6c2814e604e6f4)

While a generation runs, the button becomes Cancel and the footer counts the steps and the time.

**5. Use a result**

Each candidate appears under **Results (…)** with its seed. Click **Use as layer** to add an **AI generated** layer stretched over the sheet. Images you do not use stay under **Library** › **AI generated**.

![Results (4) with three candidate images, each with a seed and Use as layer, and a card marked Moderated · refunded](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-ai-results.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=6f0bfc39e8f3ebb35f7a9604e2eb7edc)

Four results: three candidates with Use as layer and one moderated and refunded.

An **AI generated** layer keeps the description, model, and seed. Click **Reopen in AI** in its settings to load them back into the tab. The **Seed** field then appears: keep it to start from the same draw, or click **Clear** for a new variation.

## Credits and refunds

Credits are charged when the request is sent. A candidate that fails shows **Failed · refunded**, and one blocked by the content filter shows **Moderated · refunded**; each gets its credit back. Reusing an image from **Library** › **AI generated** costs nothing, and neither do the normal and specular maps derived from a result.

**Cancel** stops the tab from following the request. The request keeps running and its credits are already charged.

![AI tab with a written request, two candidates selected, and the Generate button greyed out](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-ai-no-credits.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=e1529b5e1054bc109536251c0c9253a8)

Generate is disabled when the credits do not cover the request.

## Options

| Option | What it does | Default |
| - | - | - |
| **Type** | **Material** or **UV template**. | **Material** |
| **Size** | `512`, `1024`, or `2048`. Sizes above the texture or the model's ceiling are disabled. With model views, this is the longest side of each view. | `1024`, reduced to fit smaller textures |
| **Candidates** | `1`, `2`, or `4`. Fixed at `1` with **UV template** when the model has views. | `1` |
| **Use geometry** (**Context**) | Uses the part's layout to place the art. Disabled with model views, which already include the geometry. | On |
| **Include base texture** | Uses the game pixels as a reference. Disabled when the edit starts transparent. | On when game pixels exist |
| **Include other parts** | Available with model views when other parts exist: includes headlights, glass, wheels, and light bars as context. | On when available |
| **Upscale views** | Available with model views: doubles their resolution when they are smaller than the texture. | On with model views |
| **Review sheet** | Refines areas that model views did not cover well. Available with model views; charged only when areas need review. | On with model views |
| **Clip to UV** | Cuts the result to the part's UV. | On |
| **Normals**, **Specular** (**PBR maps**) | Derive a normal and a specular layer from the color result, at no credit cost. Tune with **Relief strength**, **Height blur**, **Brightness contrast**, and **Invert brightness**. | Off |

**PBR maps** need a normal or specular texture linked to the one you edit. **Relief strength** and **Height blur** require **Normals**; **Brightness contrast** and **Invert brightness** require **Specular**. If another model shares the linked texture, the map changes all of them.

## Troubleshooting

> **Sign in to your account to generate a texture.**
>
> Sign in to your Rageon account, then generate again.

> **Your credits don't cover this generation, which costs ….**
>
> Lower **Quality**, **Size**, or **Candidates**, turn off options, or get more credits at [rageon.dev/pricing](https://rageon.dev/pricing).

> **Write what the texture should show.**
>
> The **Request** box is empty.

> **… × … exceeds this model's … MP ceiling.**
>
> Choose a smaller **Size**.

> **Larger than the texture (… × …): the extra pixels would be paid for and discarded.**
>
> Choose a **Size** at or below the texture size.

> **The price went above the amount shown, so nothing was charged. Check the new amount and generate again.**
>
> Read the new cost at the bottom and click **Generate** again.

> **The service refused the request because of its content filter. Change the description and try again.**
>
> Rewrite the description and generate again.

> **The image service did not respond. Try again in a moment.**
>
> Wait a moment and generate again. Failed candidates are refunded.

> **Too many requests in a row. Wait a moment and try again.**
>
> Wait, then try again.

> **No connection to the generation server.**
>
> Check your internet connection, then try again.

> **This computer isn't registered on your account. Reopen the app to register it.**
>
> Close and reopen Rageon, then generate again.

> **No candidate was ready. What failed was refunded.**
>
> Every candidate failed and was refunded. Try again.

> **… of … views were left out of the sheet. …**
>
> Some views were left out in **UV template** mode, and the sheet was built from the rest. The message reports any refund. Delivered views discarded because they changed the object's shape are not refunded. Generate again if parts are missing.

> **Charged … credits; the estimate was … (…).**
>
> The final price differed from the estimate. The message names what changed.

Other errors that come from the generation service mean it failed on its side. Try again; if it persists, contact support.


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