Patina Material

Patina Material generates a complete set of seamlessly tiling PBR material maps from a text description. Describe any surface — weathered wood, cracked clay, brushed metal — and the model produces a full material map set ready for use in game engines, 3D tools, and real-time rendering pipelines.

Have a reference image? Try Patina Image-to-Map to generate maps from an existing photo.

Why Choose This?

Text-driven PBR generation Generate complete material map sets from a natural language description — no reference photo or manual authoring required.
Seamless tiling control Choose omnidirectional tiling (both), horizontal-only, or vertical-only to match your specific UV mapping and surface application needs.
Custom output size Specify any output resolution to match your target quality and performance requirements.
Production-ready output Maps are formatted for direct use in game engines (Unreal, Unity), 3D tools (Blender, Maya), and real-time rendering pipelines.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the material to generate (e.g. "weathered oak wood planks", "cracked desert clay").
size	No	Output dimensions in width×height pixels. Default: 1024×1024.
tiling_mode	No	Seamless tiling direction: both (default), horizontal, or vertical.

How to Use

Write your prompt — describe the material surface, condition, and style (e.g. "mossy cobblestone path, wet, medieval").
Set size (optional) — specify output dimensions to match your target resolution.
Choose tiling_mode (optional) — select both for omnidirectional tiling, or horizontal/vertical for axis-specific tiling.
Submit — the model generates all 6 PBR material maps in a single run.
Download your complete tileable map set ready for use in your 3D pipeline.

Pricing

Just $0.48 per run (6 maps).

Best Use Cases

Game development — Generate complete tileable PBR materials from text for environments, props, and terrain.
3D environment art — Rapidly produce material sets for architectural visualization and scene building without sourcing reference photography.
Texture authoring — Create unlimited material variations from descriptive prompts for large-scale asset production.
Indie & rapid prototyping — Quickly populate 3D scenes with physically accurate, seamlessly tiling materials.
Procedural content pipelines — Integrate text-driven material generation into automated asset creation workflows.

Pro Tips

Be specific in your prompt — include material type, condition, age, and surface characteristics (e.g. "polished black granite with fine white veining" rather than just "granite").
Specify environmental context for more accurate weathering and aging effects (e.g. "salt-worn, coastal, sun-bleached").
Use tiling_mode = horizontal for road or fabric materials that only repeat along one axis.
Use tiling_mode = both for floor, wall, and terrain materials that tile in all directions.

Notes

Only prompt is required; size and tiling_mode are optional.
Each run generates 6 PBR map types as output.
Please ensure your content complies with WaveSpeed AI's usage policies.

Related Models

Patina Image-to-Map — Generate PBR maps from an existing photograph or render.

Patina Material API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/patina/material with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Patina Material below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/patina/material" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "1024*1024",
    "tiling_mode": "both"
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey);

try {
  const result = await client.run("wavespeed-ai/patina/material", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "size": "1024*1024",
        "tiling_mode": "both"
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(api_key=os.environ["WAVESPEED_API_KEY"])

try:
    output = client.run(
        "wavespeed-ai/patina/material",
        {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "1024*1024",
    "tiling_mode": "both"
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Patina Material API — Frequently asked questions

What is the Patina Material API?

Patina Material is a WaveSpeedAI model for image generation, exposed as a REST API on WaveSpeedAI. PATINA Material generates complete seamlessly tiling PBR material sets (basecolor, normal, roughness, metalness, height) from text prompts — perfect for game engines, 3D rendering, and material libraries. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Patina Material API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/patina-material.

How much does Patina Material cost per run?

Patina Material starts at $0.48 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Patina Material accept?

Key inputs: `prompt`, `size`, `tiling_mode`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/patina-material.

How do I get started with the Patina Material API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Patina Material outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

サンプルすべて表示

関連モデル

README