[Integrations](https://spiral.ai/integrations) › [VS Code](https://spiral.ai/integrations/vscode) › [PATINA Text to Material](https://spiral.ai/integrations/vscode/patina-text-to-material)

# How to Use PATINA Text to Material in VS Code

PATINA Text to Material turns a surface description into a tileable texture plus five PBR maps for 3D rendering. It creates the starting texture as well as the maps, with base textures up to 2048 pixels and maps reaching 8K through upscaling.

|  |  |
| --- | --- |
| Model | PATINA Text to 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, no API key |

## Prompts to try with PATINA Text to Material in VS Code

- Read the environment brief in this project, then use PATINA Text to Material to generate a 1024 by 1024 limestone floor material with shallow pits, chipped edges, and dust inside the cracks. Make it repeat in both directions and save the texture and maps beside the scene assets.
- Use PATINA Text to Material to create a 1024 by 1024 plaster wall material for the interior scene: muted gray, fine sand grain, and hairline cracks concentrated around worn patches. Save the outputs in a new material folder and record the prompt.
- Inspect the project's material naming conventions, then use PATINA Text to Material to generate a 1024 by 1024 dark oak texture with narrow grain and pale salt deposits inside the grooves. Organize the resulting texture and PBR maps using those conventions.
- Use PATINA Text to Material to generate a 1024 by 1024 unglazed terracotta material with small pores, uneven clay grain, and lightly abraded patches. Add a preview to the project's existing material review scene.
- Use PATINA Text to Material to create a 1024 by 1024 weathered stone wall material with moss concentrated in recessed joints. Save all returned images and add a repeated-surface preview so I can inspect the pattern.

## How to set up PATINA Text to Material in VS Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to VS Code on the console's Agents & MCP page, or run:

```bash
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
```

2. **Sign in**: VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

### Use the Spiral skill

1. **Send VS 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 Text to 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",
    "input": {
      "prompt": "mossy stone wall"
    }
  }'
```

Then paste one of the prompts above: VS Code finds PATINA Text to Material on Spiral, shows the price and runs it.

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

## PATINA Text to Material tools and prices

- [PATINA · Text to Material](https://spiral.ai/tools/fal/fal-ai/patina/material) (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 Text to Material in VS Code?

Create tileable materials that match a project's environment or product brief. A coding agent can inspect scene files, generate surface candidates, and organize the resulting texture and PBR maps for review.

### Game environment surfaces

Generate tileable stone, clay, or concrete materials for floors and walls. Describe cracks, pores, and deposits to give each location a specific surface treatment.

### Architectural finish studies

Create plaster, limestone, and ceramic material candidates for interior renders. Compare surface grain and wear before choosing a finish.

### Film set weathering

Build materials for aged sets by specifying moss in joints, salt along boards, or paint peeling around edges. Use the resulting maps in the scene's material workflow.

### Product surface exploration

Try ceramic, leather, or textured concrete finishes on a product visualization. Generate material candidates from descriptions before committing to a surface direction.

### Prop material development

Create wood grain, cracked clay, or worn leather materials for 3D props. Describe the scale and placement of surface damage to guide the result.

### Reusable material libraries

Build a collection of tileable PBR materials organized by surface and condition, such as dry plaster, dusty stone, and weathered timber.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All VS Code guides](https://spiral.ai/integrations/vscode)

## PATINA Text to Material in other agents

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

## More VS Code guides

- [PATINA Image to Maps](https://spiral.ai/integrations/vscode/patina-image-to-maps)
- [Parabolize](https://spiral.ai/integrations/vscode/parabolize)
- [PATINA Extract Material](https://spiral.ai/integrations/vscode/patina-extract-material)
- [Perspective Change](https://spiral.ai/integrations/vscode/perspective-change)
- [Object Removal Prompt](https://spiral.ai/integrations/vscode/object-removal-prompt)
- [Phota Enhance](https://spiral.ai/integrations/vscode/phota-enhance)

## Questions about PATINA Text to Material in VS Code

**Can VS Code use PATINA Text to Material?**

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

**How much does PATINA Text to Material cost in VS Code?**

$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 VS Code plan is separate.

**Do I need a fal account to use PATINA Text to Material in VS Code?**

No. Spiral runs PATINA Text to Material 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 Text to Material in VS Code?**

About two minutes: add the hosted server, then sign in.

**Does VS Code wait while PATINA Text to Material runs?**

PATINA Text to Material runs in the background. VS Code starts the run, checks on it and gives you the image when it's ready.

**What does PATINA Text to Material produce?**

It produces a tileable texture plus five physically based rendering maps: base color, normal, roughness, metalness, and height. The result is material imagery for a 3D rendering workflow.

**Does PATINA Text to Material generate native 8K textures?**

Base texture generation reaches 2048 pixels. The predicted PBR maps can reach 8K through upscaling, which does not enlarge the original generated texture.

**How should I describe a material?**

Describe visible surface details such as grain, cracks, pores, or worn edges. Specify where weathering appears, such as moss inside mortar joints or pale dust inside cracks.

**Which materials need extra review?**

Review metals, coated surfaces, and translucent materials carefully. Fal says its training library favors nonmetallic surfaces and identifies those other material classes as underrepresented.

**Is PATINA Text to Material useful for game and film environments?**

Yes. Creating tileable material libraries and matching weathering for environment art and set dressing are documented uses.

