Tripo H3.1 Image-to 3D API
Generate high-quality 3D models from a single image using Tripo H3.1.
Tripo H3.1 Image-to-3D
Tripo H3.1 Image-to-3D reconstructs a textured 3D model from a single input image. It produces a mesh (GLB, or FBX when quad topology is requested) with optional PBR materials and a preview render — ideal for turning product photos, concept art, or references into 3D assets.
🌟 Key Features
🖼 Image-to-3D
Reconstruct a complete 3D mesh from one input image.
🎨 Textures & PBR Materials
Optionally generate textures and Physically Based Rendering (PBR) materials for production-ready shading.
🎯 Texture Alignment & Orientation
Align the texture to the original image or to the geometry, and control model orientation.
🔺 Adaptive or Fixed Face Count
Let the model choose the mesh density adaptively, or cap it with face_limit for lighter assets.
📦 Multiple Output Formats
Receive GLB by default, or FBX when quad is enabled, alongside base and PBR model variants.
⚙️ Parameters
| Parameter | Required | Description |
|---|---|---|
image_url | ✅ | URL of the input image used to create the 3D model. |
texture | ❌ | Enable texture generation (default: true). |
pbr | ❌ | Generate PBR materials (default: true). |
texture_quality | ❌ | Texture resolution level: standard (default) or detailed. |
geometry_quality | ❌ | Geometry quality level: standard (default) or detailed. |
texture_alignment | ❌ | Texture alignment: original_image (default) or geometry. |
orientation | ❌ | Model orientation: default or align_image. |
face_limit | ❌ | Target polygon count. Adaptive if unset. |
model_seed | ❌ | Seed for geometry generation reproducibility. |
texture_seed | ❌ | Seed for texture generation reproducibility. |
auto_size | ❌ | Auto-scale the model to real-world dimensions in meters (default: false). |
quad | ❌ | Generate a quad mesh topology; outputs FBX (default: false). |
💲 Pricing
| Configuration | Price |
|---|---|
| Without textures | $0.22 |
| With standard textures | $0.33 |
| With HD textures | $0.44 |
+ Detailed geometry (geometry_quality: detailed) | +$0.22 |
+ Quad mesh (quad: true) | +$0.055 |
💡 Input Tips
- Use a clear, well-lit image with the subject centered and a clean background.
- Set
texture_alignment: original_imageto keep the reconstructed texture faithful to the photo. - Use
orientation: align_imagewhen the model should face the same direction as the input. - Enable
pbrfor realistic materials in engines that support PBR shading. - Set
face_limitto keep meshes lightweight for real-time / mobile use.
🎯 Use Cases
- Product Digitization — Turn product photos into interactive 3D previews.
- Game & AR Assets — Convert concept art or references into usable meshes.
- Photogrammetry Alternative — Generate 3D from a single image without a full capture rig.
- Rapid Prototyping — Explore 3D reconstructions before manual modeling.
📝 Notes
image_urlis the only required field (besidesmodel). Our platform also acceptsimageas an alias.- Output model files are returned in
outputs(GLB/FBX and variants); the preview image is inthumbnailand appended tooutputslast. - Structured per-file metadata (type, content_type, size) is available in
files. - Task status values:
created,processing,completed,failed.
