# PATINA · Text to Material

Generate and edit images from text with PATINA · Text to Material from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

- Provider: fal
- Category: Image
- Runs: In the background
- Returns: image
- Tool id: `fal` / `fal-ai/patina/material`
- Page: https://spiral.ai/tools/fal/fal-ai/patina/material

## Pricing

$0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` (required) | text |  | — | The text prompt describing the material/texture to generate. |
| `image_size` | JSON |  | square_hd | Output texture dimensions in pixels. |
| `num_inference_steps` | number (whole) | 1 to 8 | 8 | Number of denoising steps for texture generation. |
| `seed` | number (whole) |  | — | Random seed for reproducible generation. |
| `num_images` | number (whole) | 1 to 4 | 1 | Number of texture images to generate. |
| `enable_prompt_expansion` | true or false |  | true | Expand prompt with an LLM for richer detail. Adds ~0.0025 credits. |
| `tiling_mode` | one of | both, horizontal, vertical | both | Tiling direction: 'both' (omnidirectional), 'horizontal', or 'vertical'. |
| `tile_size` | number (whole) | 32 to 256 | 128 | Tile size in latent space. Automatically capped to the generated image dimensions on tiled axes (64 = 512px, 128 = 1024px). |
| `tile_stride` | number (whole) | 16 to 128 | 64 | Tile stride in latent space. Automatically capped to half the effective tile size. |
| `image_url` | URL or file |  | — | URL of an input image for image-to-image or inpainting. When provided without mask_url, performs image-to-image; with mask_url, performs inpainting. |
| `mask_url` | URL or file |  | — | URL of a mask image for inpainting. White regions are regenerated, black regions are preserved. Requires image_url. |
| `strength` | number | … to 1 | 0.6 | How much to transform the input image. Only used when image_url is provided. |
| `maps` | list |  | ["basecolor","normal","roughness","metalness","height"] | Which PBR maps to predict. Deselect all to skip PBR estimation entirely. Defaults to all five. |
| `upscale_factor` | one of | 0, 2, 4 | 0 | Upscale factor for predicted PBR maps via SeedVR seamless upscaling. 0 = no upscaling, 2 = 2× resolution, 4 = 4× resolution. The base texture image is not upscaled. |
| `output_format` | one of | jpeg, png, webp | png | Output image format for textures and PBR maps. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/patina/material",
    "input": {
      "prompt": "mossy stone wall"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fpatina%2Fmaterial

## Common questions

### PATINA · Text to Material

**How much does PATINA · Text to Material cost?**

$0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use PATINA · Text to Material through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/patina/material"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use PATINA · Text to Material?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use PATINA · Text to Material?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

