[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [PATINA Extract Material](https://spiral.ai/integrations/instinct/patina-extract-material)

# How to Use PATINA Extract Material in Instinct

PATINA Extract Material turns a chosen surface in a photo into a seamless texture with PBR maps for 3D rendering. Unlike PATINA Image to Maps, it isolates and flattens the surface before predicting maps.

|  |  |
| --- | --- |
| Model | PATINA Extract Material |
| Available through | fal |
| Category | Image |
| Price | $0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with PATINA Extract Material in Instinct

- Every Friday, use PATINA Extract Material on new scouting photos that include an approved wall-surface description. Extract that surface, exclude the listed objects, and prepare a review sheet of the resulting textures.
- Each morning, use PATINA Extract Material on newly submitted floor photos with a specified target surface. Exclude furniture and rugs, and collect the texture and five material maps under the submission's name.
- Weekly, use PATINA Extract Material on new upholstery reference photos with approved surface labels. Extract only the named fabric panel and prepare a repeated-texture preview for review.
- Every Monday, use PATINA Extract Material on approved stone reference photos. Follow each photo's extraction description and show the output in a 2x2 repeat for inspection.
- Each evening, use PATINA Extract Material on newly approved concrete wall photos. Exclude objects listed in the submission and collect the source photo, extracted texture, and material maps in a review report.

## How to set up PATINA Extract Material in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

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

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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 Extract Material**: 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/material/extract",
    "input": {
      "prompt": "the wall",
      "image_url": "https://v3b.fal.media/files/b/0a95600b/IVhCXWN-sE1xj1SpYAGpL_31b6f371-90ae-4835-851e-23cd809cfb86.png"
    }
  }'
```

Then paste one of the prompts above: Instinct finds PATINA Extract Material on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## PATINA Extract Material tools and prices

- [PATINA · Extract Material](https://spiral.ai/tools/fal/fal-ai/patina/material/extract) (fal): $0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | square_hd | Output texture dimensions in pixels. |
| num_inference_steps | 1 to 8 | 8 | Number of denoising steps for texture generation. |
| seed |  | — | Random seed for reproducible generation. |
| num_images | 1 to 4 | 1 | Number of texture images to generate. |
| enable_prompt_expansion |  | true | Expand prompt with an LLM for richer detail. Adds ~0.0025 credits. |
| tiling_mode | both, horizontal, vertical | both | Tiling direction: 'both' (omnidirectional), 'horizontal', or 'vertical'. |

## What can you do with PATINA Extract Material in Instinct?

Build a growing material reference library from newly submitted surface photos. A scheduled agent can process photos with clear extraction instructions and collect the resulting textures and maps for review.

### Brick walls for game environments

Extract brickwork from a building photo for a repeating wall material. Specify the masonry and exclude windows, signs, and vegetation.

### Floor materials for interior scenes

Turn a room photo's wooden floor into a reusable surface for an interior visualization. Exclude furniture, rugs, and baseboards.

### Fabric for furniture models

Extract upholstery from a chair photo for a furniture material study. Identify the fabric panel and exclude the frame and surrounding room.

### Location references for digital sets

Build material studies from scouting photos by extracting one wall or floor surface at a time.

### Stone finishes for architectural previews

Extract a photographed stone countertop or wall finish for a 3D preview. Keep objects resting on the surface out of the extraction prompt.

### Concrete surfaces for environment art

Use a concrete wall photo as the source for a repeating material. Inspect a 2x2 repeat before applying it across a large surface.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## PATINA Extract Material in other agents

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

## More Instinct guides

- [Object Removal Prompt](https://spiral.ai/integrations/instinct/object-removal-prompt)
- [PATINA Image to Maps](https://spiral.ai/integrations/instinct/patina-image-to-maps)
- [Object Removal Mask](https://spiral.ai/integrations/instinct/object-removal-mask)
- [PATINA Text to Material](https://spiral.ai/integrations/instinct/patina-text-to-material)
- [Object Removal Bounding Box](https://spiral.ai/integrations/instinct/object-removal-bounding-box)
- [Parabolize](https://spiral.ai/integrations/instinct/parabolize)

## Questions about PATINA Extract Material in Instinct

**Can Instinct use PATINA Extract Material?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run PATINA Extract Material like any built-in tool.

**How much does PATINA Extract Material cost in Instinct?**

$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 from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.

**Do I need a fal account to use PATINA Extract Material in Instinct?**

You need no fal account. Instinct uses one Spiral API key for every tool, and Spiral runs PATINA Extract Material on its own fal account.

**How long does it take to set up PATINA Extract Material in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while PATINA Extract Material runs?**

PATINA Extract Material runs in the background. Instinct starts the run, checks on it and gives you the image when it's ready.

**What is PATINA Extract Material best for?**

Use it when a reference photo contains a surface you want to reuse in a 3D scene. It isolates that surface and turns it into a seamless texture with predicted material maps.

**Does it preserve the original photo unchanged?**

The extraction process changes the image to flatten and tile the selected surface. PATINA Image to Maps is the documented choice when you already have a finished texture and want map prediction without modifying it.

**What does PATINA Extract Material return?**

It returns a tileable texture plus predicted base color, normal, roughness, metalness, and height maps.

**How should I describe the surface to extract?**

Identify the surface precisely and name nearby objects to exclude. For example: the pale stone countertop, excluding the bowl, faucet, and backsplash.

**Can PATINA Extract Material produce 8K textures?**

The documented upscaling path can produce PBR maps up to 8K from a 2048-pixel texture. The base texture itself is not upscaled.

