multiview_to_model
Generate a 3D mesh from 2-4 views of one object (front required) or from a successful image_to_multiview task. Returns a Tripo task ID; call wait_for_task to finish.
Instructions
Generate a 3D mesh from 2-4 views of one object (front required), or from a successful image_to_multiview / edit_multiview task. Creates a Tripo task (spends credits) and returns its task_id immediately; then call wait_for_task.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pbr | No | Generate PBR materials (default true); implies texture | |
| quad | No | Quad topology; forces FBX output and 10k faces unless face_limit is set (+5 credits). Not on P1 | |
| input | No | Task ID of a successful image_to_multiview or edit_multiview task. Mutually exclusive with inputs | |
| model | No | Model version: v3.1-20260211 (H3.1, default), v3.0-20250812, v2.5-20250123, P1-20260311 (low-poly), P2-20260801 (low-poly preview). Aliases such as v3.1, p1 and p2 work. See list_models. | |
| inputs | No | Views of one object: front plus at least one of left, back, right. Each is a local path, URL or file token. Mutually exclusive with input | |
| delight | No | Remove baked-in lighting from textures (default true). Only texture_version v3.5-20260815 reads it | |
| texture | No | Generate textures (default true). false is cheaper and required for generate_parts | |
| compress | No | Compress the output geometry (meshopt) | |
| auto_size | No | Scale the mesh to real-world size in meters | |
| export_uv | No | Include UVs in the output (default true) | |
| face_limit | No | Target face count. H3.x up to 1.5M (2M with geometry_quality detailed); P1 50-20,000; P2 48-50,000; quad up to 150k | |
| model_seed | No | Seed for geometry generation | |
| orientation | No | align_image rotates the mesh to match the front image. Needs texture | |
| texture_seed | No | Seed for texture generation | |
| generate_parts | No | Generate separately editable parts (+20 credits). Requires texture false and pbr false. H3.x only | |
| smart_low_poly | No | Hand-crafted-style low-poly topology on H3.x (+10 credits). Use P1/P2 for game-ready low poly instead | |
| texture_quality | No | Texture quality (default standard). detailed is HD (+10 credits), extreme is 8K (+20). fast needs texture_version v3.5-20260815 | |
| texture_version | No | Texturing model version: v3.5-20260815, v3.0-20250812 or v2.5-20250123. Defaults to the one matching model | |
| geometry_quality | No | detailed (Ultra) adds geometric detail (+20 credits). H3.x only | |
| texture_alignment | No | Align textures to the original images (default) or to the geometry | |
| export_orientation | No | Facing axis of the output (default +x). Later operations do not inherit it; prefer setting it on convert_model |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| task_id | Yes | ||
| produces | Yes | ||
| warnings | No | ||
| operation | Yes |