Skip to main content

Surface Virtual Try-On

POST 
/vto/surface

Apply a material or texture to a surface in a scene photo. The source image should contain the scene (e.g., a room, furniture, architectural space), and the material image should contain a swatch or sample of the material to apply. A target surface must be specified using a text-based maskPrompt describing which surface to apply the material to (e.g., "sofa cushions", "the floor", "the wall behind the bed").

An optional materialClass can be provided to enable material-specific generation for more realistic results. Supported classes are FABRIC, TILE, WOOD, PAINT, WALLPAPER, and STONE.

Images are automatically padded to a supported aspect ratio for processing and cropped back to the original dimensions in the output. The generated result image is returned inline as base64-encoded image data with its MIME type.

Request​

Responses​

Request successfully processed