---
title: Patina AI | Scenario Docs
---

> This page is auto-generated from model configurations. Last updated: 2026-09-01.

This reference lists all available **Patina AI** image generation models and their parameters. Use these parameter names when calling the [Generation API](/api/postgeneratecustom/index.md).

- [PATINA Image to Maps](#patina-image-to-maps)
- [PATINA Material](#patina-material)
- [PATINA Material Extract](#patina-material-extract)

---

## PATINA Image to Maps

Predict seamless PBR maps (base color, normal, roughness, metalness, height) from an existing texture or photo. The source image is analyzed, not rewritten.

**Model ID:** `model_patina`

**Capabilities:** `img2img`

**LLM Markdown:** <https://app.scenario.com/api/models/model_patina/markdown>

| Parameter | Type          | Required | Default                                       | Min | Max        | Allowed Values                                            | Description                                                                                                                                         |
| --------- | ------------- | -------- | --------------------------------------------- | --- | ---------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `image`   | file          | Yes      | -                                             | -   | -          | -                                                         | A flat texture or photo of a surface. PATINA predicts PBR maps from it without changing the original.                                               |
| `maps`    | string\_array | No       | `basecolor,normal,roughness,metalness,height` | -   | -          | `basecolor`, `normal`, `roughness`, `metalness`, `height` | Which PBR maps to generate. Defaults to all five.                                                                                                   |
| `seed`    | number        | No       | -                                             | 0   | 2147483647 | -                                                         | A number that makes results repeatable. Reusing the same seed and settings produces the same maps; leave it empty for a different result each time. |

## PATINA Material

Generate a seamlessly tiling PBR material from a text prompt, with optional image-to-image variations and inpainting. Outputs a texture plus base color, normal, roughness, metalness, and height maps, up to 8K with upscaling.

**Model ID:** `model_patina-material`

**Capabilities:** `txt2img`, `img2img`

**LLM Markdown:** <https://app.scenario.com/api/models/model_patina-material/markdown>

| Parameter               | Type          | Required | Default                                       | Min  | Max        | Allowed Values                                            | Description                                                                                                                                                      |
| ----------------------- | ------------- | -------- | --------------------------------------------- | ---- | ---------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`                | string        | Yes      | -                                             | -    | -          | -                                                         | Text description of the material to generate, for example weathered copper patina or mossy stone wall.                                                           |
| `image`                 | file          | No       | -                                             | -    | -          | -                                                         | An optional starting texture. Without a mask, PATINA creates variations. With a mask, it inpaints the marked region.                                             |
| `imageStrength`         | number        | No       | `0.6`                                         | 0.01 | 1          | -                                                         | How much to transform the input image. Higher values change it more. Only used when an image is provided.                                                        |
| `mask`                  | file          | No       | -                                             | -    | -          | -                                                         | A black-and-white mask for inpainting. White regions are regenerated, black regions are preserved. Requires an input image.                                      |
| `width`                 | number        | No       | `1024`                                        | 512  | 2048       | -                                                         | Output width in pixels. Upscaling applies to PBR maps only, not the base texture.                                                                                |
| `height`                | number        | No       | `1024`                                        | 512  | 2048       | -                                                         | Output height in pixels. Upscaling applies to PBR maps only, not the base texture.                                                                               |
| `maps`                  | string\_array | No       | `basecolor,normal,roughness,metalness,height` | -    | -          | `basecolor`, `normal`, `roughness`, `metalness`, `height` | Which PBR maps to predict. Deselect all to skip PBR estimation and only generate the texture.                                                                    |
| `upscaleFactor`         | number        | No       | `0`                                           | -    | -          | `0`, `2`, `4`                                             | Seamless upscale for predicted PBR maps. 0 keeps map resolution, 2 doubles it, 4 quadruples it (up to 8K from a 2048 texture). The base texture is not upscaled. |
| `tilingMode`            | string        | No       | `both`                                        | -    | -          | `both`, `horizontal`, `vertical`                          | Which directions the material repeats seamlessly. Both repeats in every direction; Horizontal repeats left-to-right; Vertical repeats top-to-bottom.             |
| `numOutputs`            | number        | No       | `1`                                           | 1    | 4          | -                                                         | Number of texture images to generate from the same prompt.                                                                                                       |
| `numInferenceSteps`     | number        | No       | `8`                                           | 1    | 8          | -                                                         | Number of denoising steps for texture generation. Higher values take longer.                                                                                     |
| `enablePromptExpansion` | boolean       | No       | `true`                                        | -    | -          | -                                                         | Expand the prompt with an LLM for richer material detail.                                                                                                        |
| `tileSize`              | number        | No       | `128`                                         | 32   | 256        | -                                                         | Seamless-tiling window in latent space. 64 ≈ 512px, 128 ≈ 1024px, 256 ≈ 2048px. Match this to the output resolution for cleaner repeats.                         |
| `tileStride`            | number        | No       | `64`                                          | 16   | 128        | -                                                         | How far the tiling window steps between passes. Smaller than tile size adds overlap and usually smoother seams; larger is faster but can show a grid.            |
| `seed`                  | number        | No       | -                                             | 0    | 2147483647 | -                                                         | A number that makes results repeatable. Reusing the same seed and settings produces the same material; leave it empty for a different result each time.          |

## PATINA Material Extract

Extract a clean, seamlessly tiling PBR material from a photo of a real surface. Isolates the chosen material, flattens it, and predicts base color, normal, roughness, metalness, and height maps.

**Model ID:** `model_patina-material-extract`

**Capabilities:** `img2img`

**LLM Markdown:** <https://app.scenario.com/api/models/model_patina-material-extract/markdown>

| Parameter               | Type          | Required | Default                                       | Min  | Max        | Allowed Values                                            | Description                                                                                                                                                      |
| ----------------------- | ------------- | -------- | --------------------------------------------- | ---- | ---------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`                | string        | Yes      | -                                             | -    | -          | -                                                         | Describe which material to extract from the photo, for example the brick wall or the wooden floor.                                                               |
| `image`                 | file          | Yes      | -                                             | -    | -          | -                                                         | A photo that contains the material you want. Perspective, shadows, and surrounding scene are flattened into a seamless texture.                                  |
| `imageStrength`         | number        | No       | `0.6`                                         | 0.01 | 1          | -                                                         | How much to transform the extracted material while making it tileable. Higher values change it more.                                                             |
| `width`                 | number        | No       | `1024`                                        | 512  | 2048       | -                                                         | Output width in pixels. Upscaling applies to PBR maps only, not the base texture.                                                                                |
| `height`                | number        | No       | `1024`                                        | 512  | 2048       | -                                                         | Output height in pixels. Upscaling applies to PBR maps only, not the base texture.                                                                               |
| `maps`                  | string\_array | No       | `basecolor,normal,roughness,metalness,height` | -    | -          | `basecolor`, `normal`, `roughness`, `metalness`, `height` | Which PBR maps to predict. Deselect all to skip PBR estimation and only extract the texture.                                                                     |
| `upscaleFactor`         | number        | No       | `0`                                           | -    | -          | `0`, `2`, `4`                                             | Seamless upscale for predicted PBR maps. 0 keeps map resolution, 2 doubles it, 4 quadruples it (up to 8K from a 2048 texture). The base texture is not upscaled. |
| `tilingMode`            | string        | No       | `both`                                        | -    | -          | `both`, `horizontal`, `vertical`                          | Which directions the extracted material repeats seamlessly. Both repeats in every direction; Horizontal repeats left-to-right; Vertical repeats top-to-bottom.   |
| `numOutputs`            | number        | No       | `1`                                           | 1    | 4          | -                                                         | Number of texture variations to extract from the same photo.                                                                                                     |
| `numInferenceSteps`     | number        | No       | `8`                                           | 1    | 8          | -                                                         | Number of denoising steps for texture generation. Higher values take longer.                                                                                     |
| `enablePromptExpansion` | boolean       | No       | `true`                                        | -    | -          | -                                                         | Expand the prompt for richer material detail.                                                                                                                    |
| `tileSize`              | number        | No       | `128`                                         | 32   | 256        | -                                                         | Seamless-tiling window in latent space. 64 ≈ 512px, 128 ≈ 1024px, 256 ≈ 2048px. Match this to the output resolution for cleaner repeats.                         |
| `tileStride`            | number        | No       | `64`                                          | 16   | 128        | -                                                         | How far the tiling window steps between passes. Smaller than tile size adds overlap and usually smoother seams; larger is faster but can show a grid.            |
| `seed`                  | number        | No       | -                                             | 0    | 2147483647 | -                                                         | A number that makes results repeatable. Reusing the same seed and settings produces the same extract; leave it empty for a different result each time.           |
