Spiral gives your agent every tool with one account. Browse the tools →

falImageAvailable now

PATINA · Extract Material

fal-ai/patina/material/extract

Edit and enhance images with PATINA · Extract Material from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

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

Runs
In the background
Returns
image
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

FieldKindDefaultDescription
prompt requiredtext—

Describe which texture to extract from the image.

image_sizeJSONsquare_hd

Output texture dimensions in pixels.

num_inference_stepsnumber (whole)
1 to 8
8

Number of denoising steps for texture generation.

seednumber (whole)—

Random seed for reproducible generation.

num_imagesnumber (whole)
1 to 4
1

Number of texture images to generate.

enable_prompt_expansiontrue or falsetrue

Expand prompt with an LLM for richer detail. Adds ~0.0025 credits.

tiling_modeone of
both, horizontal, vertical
both

Tiling direction: 'both' (omnidirectional), 'horizontal', or 'vertical'.

tile_sizenumber (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_stridenumber (whole)
16 to 128
64

Tile stride in latent space. Automatically capped to half the effective tile size.

image_url requiredURL or file—

URL of the image to extract a texture from.

strengthnumber
… to 1
0.6

How much to transform the input image. Only used when image_url is provided.

mapslist["basecolor","normal","roughness","metalness","height"]

Which PBR maps to predict. Deselect all to skip PBR estimation entirely. Defaults to all five.

upscale_factorone 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_formatone of
jpeg, png, webp
png

Output image format for textures and PBR maps.

Same request in code

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"
    }
  }'

Frequently asked questions

How much does PATINA · Extract 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 · Extract Material through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/patina/material/extract"` 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 · Extract Material?

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

Can my AI agent use PATINA · Extract Material?

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