[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [PATINA Image to Maps](https://spiral.ai/integrations/muse-code/patina-image-to-maps)

# How to Use PATINA Image to Maps in Muse Code

PATINA Image to Maps turns an existing texture or surface photo into PBR maps for 3D materials. It predicts surface properties without redesigning the source image.

|  |  |
| --- | --- |
| Model | PATINA Image to Maps |
| Available through | fal |
| Category | Image |
| Price | Up to $0.078 per run at the default inputs. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with PATINA Image to Maps in Muse Code

- Use PATINA Image to Maps on assets/textures/brick.png, generate all five material maps, and add a wall preview to the project's existing 3D scene.
- Use PATINA Image to Maps on the project's wood texture. Generate normal and roughness maps, then add a comparison between the current material and the updated material.
- Use PATINA Image to Maps on assets/materials/stone.png. Generate normal and height maps and build separate previews for normal detail and mesh displacement.
- Use PATINA Image to Maps on the finished fabric texture in this project. Save the material maps together and create a furniture material preview.
- Use PATINA Image to Maps on the project's coated-metal reference. Generate the material maps and create a review scene with several light directions so I can inspect the result.

## How to set up PATINA Image to Maps in Muse Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run PATINA Image to Maps**: One request; the result comes back by polling or a webhook.

```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",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/gallery/patina-blog-hero-render.png"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds PATINA Image to Maps on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## PATINA Image to Maps tools and prices

- [PATINA · Image to Maps](https://spiral.ai/tools/fal/fal-ai/patina) (fal): Up to $0.078 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| maps |  | ["basecolor","normal","roughness","metalness","height"] | Which PBR maps to predict. Defaults to all five. |
| seed |  | — | Random seed for reproducible denoising. If not set, a random seed is used. |
| output_format | jpeg, png, webp | png | Output image format. |

## What can you do with PATINA Image to Maps in Muse Code?

Turn existing project textures into material maps for a 3D scene. Your coding agent can organize the outputs and build a preview for review.

### Brick surfaces for game environments

Generate material maps from a prepared brick texture for a wall asset.

### Wood finishes for architectural renders

Turn a flat wood reference into material maps for floors, cabinetry, or wall panels.

### Fabric materials for furniture

Use a prepared fabric swatch as the starting image for an upholstery material.

### Material maps for generated artwork

Add predicted surface properties to a texture image created in another image tool.

### Older texture library updates

Generate missing material maps for existing flat textures before reviewing them in a scene.

### Surface relief studies

Generate normal and height maps from a stone texture to compare apparent bumps with displacement.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## PATINA Image to Maps in other agents

- [Amp](https://spiral.ai/integrations/amp/patina-image-to-maps)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/patina-image-to-maps)
- [Claude](https://spiral.ai/integrations/claude-desktop/patina-image-to-maps)
- [Claude Code](https://spiral.ai/integrations/claude-code/patina-image-to-maps)
- [Cline](https://spiral.ai/integrations/cline/patina-image-to-maps)
- [Codex](https://spiral.ai/integrations/codex/patina-image-to-maps)
- [Cursor](https://spiral.ai/integrations/cursor/patina-image-to-maps)
- [Devin](https://spiral.ai/integrations/devin/patina-image-to-maps)
- [dots](https://spiral.ai/integrations/dots/patina-image-to-maps)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/patina-image-to-maps)
- [Gemini](https://spiral.ai/integrations/gemini/patina-image-to-maps)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/patina-image-to-maps)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/patina-image-to-maps)
- [goose](https://spiral.ai/integrations/goose/patina-image-to-maps)
- [Grok](https://spiral.ai/integrations/grok/patina-image-to-maps)
- [Grok Build](https://spiral.ai/integrations/grok-build/patina-image-to-maps)
- [Hermes](https://spiral.ai/integrations/hermes/patina-image-to-maps)
- [Instinct](https://spiral.ai/integrations/instinct/patina-image-to-maps)
- [Manus](https://spiral.ai/integrations/manus/patina-image-to-maps)
- [Muse](https://spiral.ai/integrations/muse/patina-image-to-maps)
- [n8n](https://spiral.ai/integrations/n8n/patina-image-to-maps)
- [Notion](https://spiral.ai/integrations/notion/patina-image-to-maps)
- [OpenClaw](https://spiral.ai/integrations/openclaw/patina-image-to-maps)
- [opencode](https://spiral.ai/integrations/opencode/patina-image-to-maps)
- [Perplexity](https://spiral.ai/integrations/perplexity/patina-image-to-maps)
- [Raycast](https://spiral.ai/integrations/raycast/patina-image-to-maps)
- [VS Code](https://spiral.ai/integrations/vscode/patina-image-to-maps)
- [Windsurf](https://spiral.ai/integrations/windsurf/patina-image-to-maps)
- [Zapier](https://spiral.ai/integrations/zapier/patina-image-to-maps)

## More Muse Code guides

- [PATINA Extract Material](https://spiral.ai/integrations/muse-code/patina-extract-material)
- [PATINA Text to Material](https://spiral.ai/integrations/muse-code/patina-text-to-material)
- [Object Removal Prompt](https://spiral.ai/integrations/muse-code/object-removal-prompt)
- [Parabolize](https://spiral.ai/integrations/muse-code/parabolize)
- [Object Removal Mask](https://spiral.ai/integrations/muse-code/object-removal-mask)
- [Perspective Change](https://spiral.ai/integrations/muse-code/perspective-change)

## Questions about PATINA Image to Maps in Muse Code

**Can Muse Code use PATINA Image to Maps?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run PATINA Image to Maps like any built-in tool.

**How much does PATINA Image to Maps cost in Muse Code?**

Up to $0.078 per run at the default inputs. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Muse Code plan is separate.

**Do I need a fal account to use PATINA Image to Maps in Muse Code?**

No. Spiral runs PATINA Image to Maps on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up PATINA Image to Maps in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while PATINA Image to Maps runs?**

PATINA Image to Maps runs in the background. Muse Code starts the run, checks on it and gives you the image when it's ready.

**What does PATINA Image to Maps produce?**

It predicts base color, normal, roughness, metalness, and height maps from one image. These describe material properties for rendering.

**Can PATINA Image to Maps create a material from a text description?**

It needs an existing image to analyze. Start with a photograph, render, or finished texture that already shows the appearance you want.

**Will PATINA Image to Maps redesign my texture?**

It predicts material properties without modifying the source image. Make any desired changes to the texture before generating its maps.

**What kind of source image should I use?**

Use a clean, flat view of the intended surface. If your reference is a room or street scene, prepare the desired material as a separate texture first.

**Which materials need extra review?**

The maker says the training library favors dielectric surfaces and needs broader coverage of metallic, coated, and translucent materials. Check those results in your renderer before accepting them.

