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

Gemini CLI · Image

How to Use PATINA Extract Material in Gemini CLI

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.

Prompts to try with PATINA Extract Material in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use PATINA Extract Material on the brick facade photo in this project. Extract only the brickwork, excluding windows and signs, then add a 2x2 texture preview.

PATINA Extract MaterialGemini CLI
Try asking
  • Use PATINA Extract Material on the room reference photo in the project. Extract the wooden floor, excluding the rug and furniture, and organize the texture and five PBR maps under one material name.

  • Use PATINA Extract Material on the project's chair reference. Extract only the woven upholstery, excluding the frame, and prepare a material preview on the chair mesh.

  • Use PATINA Extract Material on the concrete reference image in our assets. Compare two transformation strengths while keeping the extraction instruction and other settings unchanged.

  • Use PATINA Extract Material on the stone wall reference in this project. Exclude plants and trim, save the texture and maps together, and create a tiled plane preview for review.

How to set up PATINA Extract Material in Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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.

    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.

    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: Gemini CLI finds PATINA Extract Material on Spiral, shows the price and runs it.

PATINA Extract Material providers and prices

Spiral runs PATINA Extract Material through fal. Open a card for today's price, with every fee included.

falImage
PATINA · Extract Material
fal-ai/patina/material/extract

Settings you can ask for

PATINA Extract Material works from your prompt and image URL. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Number of inference steps1 to 88

Number of denoising steps for texture generation.

Seeda whole number

Random seed for reproducible generation.

Number of images1 to 41

Number of texture images to generate.

Enable prompt expansionon or offon

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

Tiling modeboth, horizontal, or verticalboth

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

Tile size32 to 256128

Tile size in latent space. Automatically capped to the generated image dimensions on tiled axes (64 = 512px, 128 = 1024px).

Tile stride16 to 12864

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

Strengtha number up to 10.6

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

Upscale factor0, 2, or 40

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 formatjpeg, png, or webppng

Output image format for textures and PBR maps.

Every API field of PATINA · Extract Material is on its tool page: open its card above.

What can you do with PATINA Extract Material in Gemini CLI?

Turn reference photos in your project into reusable materials for 3D scenes. A coding agent can organize the extracted textures and maps and build a preview for checking their repetition.

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.

Questions about PATINA Extract Material in Gemini CLI

Can Gemini CLI use PATINA Extract Material?

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

How much does PATINA Extract Material cost in Gemini CLI?

$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 Gemini CLI plan is separate.

Do I need a fal account to use PATINA Extract Material in Gemini CLI?

No. Spiral runs PATINA Extract 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 Extract Material in Gemini CLI?

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

Does Gemini CLI wait while PATINA Extract Material runs?

PATINA Extract Material runs in the background. Gemini CLI 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.

Get started

Start using PATINA Extract Material in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options