GET

/v1/schemas/fal/image/fal-ai/patina/material

Accept:

kind inputactivity imagehash b93b3514…extracted Sep 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `d6e46fe0f88f9ba9243dec62618765ab3b2f3ed4adde68b102c934a0a8ba6553` { "fetchedAt": 1788670830, "extractorVersion": "1", "verifiedAt": null }

Request body

16 properties · 1 required · 1 $defs

property	type	description	constraints
prompt*	string	The text prompt describing the material/texture to generate.
strength	number	How much to transform the input image. Only used when image_url is provided.	0 < n ≤ 1 · default: 0.6
tile_size	integer	Tile size in latent space. Automatically capped to the generated image dimensions on tiled axes (64 = 512px, 128 = 1024px).	32 ≤ n ≤ 256 · default: 128
num_images	integer	Number of texture images to generate.	1 ≤ n ≤ 4 · default: 1
tile_stride	integer	Tile stride in latent space. Automatically capped to half the effective tile size.	16 ≤ n ≤ 128 · default: 64
num_inference_steps	integer	Number of denoising steps for texture generation.	1 ≤ n ≤ 8 · default: 8
upscale_factor	enum	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.	0 \| 2 \| 4 · default: 0
output_format	enum	Output image format for textures and PBR maps.	jpeg \| png \| webp · default: "png"
seed	integer	Random seed for reproducible generation.	nullable
tiling_mode	enum	Tiling direction: 'both' (omnidirectional), 'horizontal', or 'vertical'.	both \| horizontal \| vertical · default: "both"
image_url	string	URL of an input image for image-to-image or inpainting. When provided without mask_url, performs image-to-image; with mask_url, performs inpainting.	nullable
enable_safety_checker	boolean	Enable the safety checker for generated images.	default: true
maps	enum[]	Which PBR maps to predict. Deselect all to skip PBR estimation entirely. Defaults to all five.	default: ["basecolor","normal","roughness…
mask_url	string	URL of a mask image for inpainting. White regions are regenerated, black regions are preserved. Requires image_url.	nullable
enable_prompt_expansion	boolean	Expand prompt with an LLM for richer detail. Adds ~0.0025 credits.	default: true
image_size	ImageSize \| enum	Output texture dimensions in pixels.	default: "square_hd"

Types

1 $defs

ImageSizeobject

height	integer	The height of the generated image.	0 < n ≤ 14142 · default: 512
width	integer	The width of the generated image.	0 < n ≤ 14142 · default: 512

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/patina/material","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}