image_to_3d
Generate a 3D model from a reference image using a local file path or public URL. Poll task_status for progress and download_model to retrieve the result.
Instructions
Generate a 3D model from a reference image. Provide a local file path or public URL. This is an async operation — use task_status to poll progress and download_model to retrieve the result.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pbr | No | Enable PBR materials. When true, Tripo will also enable texture output | |
| quad | No | Generate quad mesh output when supported | |
| texture | No | Enable texturing. Set false to request a base model without textures | |
| autoSize | No | Automatically scale the model to real-world dimensions in meters | |
| compress | No | Compression mode. Set to geometry to request geometry compression | |
| exportUV | No | Control whether UV unwrapping is performed during generation | |
| imageUrl | No | Public URL of the reference image. Mutually exclusive with imagePath | |
| faceLimit | No | Target polygon face count | |
| imagePath | No | Local file path to the reference image. Mutually exclusive with imageUrl | |
| modelSeed | No | Optional seed for geometry generation | |
| orientation | No | Model orientation: default or align_image | |
| textureSeed | No | Optional seed for texture generation | |
| modelVersion | No | Model version (e.g. turbo, v3.0, v3.1, p1). Defaults to the latest supported H3 model | |
| smartLowPoly | No | Enable Tripo smart low-poly mesh optimization when supported | |
| generateParts | No | Generate semantic mesh parts when supported | |
| textureQuality | No | Texture quality: standard or detailed | |
| geometryQuality | No | Geometry detail mode for H3 models: standard or detailed | |
| textureAlignment | No | Texture alignment priority: original_image or geometry | |
| enableImageAutofix | No | Let Tripo optimize the reference image before generation |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| taskId | Yes |