Tripo3d H3.1 Image To 3d
Playground
Try it on WavespeedAI!Tripo3D H3.1 Image-to-3D converts a single image into high-quality 3D models with textures and PBR materials. Supports standard and HD texture quality, detailed geometry, quad mesh topology, texture alignment, and orientation control. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Tripo3D H3.1 Image-to-3D
Tripo3D H3.1 Image-to-3D reconstructs a production-ready 3D model from a single reference image. Upload one photo — the model generates accurate geometry with optional PBR textures, quad mesh topology, and detailed quality tiers for both geometry and texture.
- Need more accuracy? Try Tripo3D H3.1 Multiview-to-3D with 2–4 angle shots.
Why Choose This?
-
Single-image 3D reconstruction Generate a fully textured 3D model from just one reference photo — no multi-view capture or manual modeling required.
-
PBR material generation Generate Physically Based Rendering materials alongside the mesh for realistic real-time rendering in game engines and 3D tools.
-
Geometry and texture quality tiers Choose between standard and detailed quality independently for geometry and texture — optimizing for speed, cost, or maximum fidelity.
-
Quad mesh support Generate quad (4-sided) mesh topology instead of triangles for cleaner topology compatible with animation and sculpting workflows.
-
Texture alignment control Align textures to the original input image or to the generated geometry for different use case requirements.
-
Orientation control Use align_image to auto-rotate the model to match the input image orientation.
Parameters
| Parameter | Required | Description |
|---|---|---|
| image | Yes | URL of the input image for 3D model creation. |
| texture | No | Whether to generate textures for the model. Default: true. |
| pbr | No | Whether to generate PBR materials. Requires texture to be enabled. Default: true. |
| texture_quality | No | Texture quality: standard (default) or detailed (higher resolution). |
| geometry_quality | No | Geometry quality: standard (default) or detailed. |
| texture_alignment | No | How textures are aligned: original_image (default) or geometry. |
| auto_size | No | Auto-scale the model to real-world dimensions. Default: false. |
| orientation | No | Model orientation: default or align_image (auto-rotates to match input image). |
| quad | No | Generate quad mesh topology instead of triangles. Default: false. |
How to Use
- Upload your image — provide a clear, well-lit reference image URL of the object.
- Configure texture settings (optional) — enable or disable texture and PBR generation, and choose standard or detailed texture quality.
- Set geometry quality (optional) — choose standard for faster results or detailed for higher geometric fidelity.
- Configure additional options (optional) — set texture alignment, orientation, quad mesh, and auto-size as needed.
- Submit — generate and download your 3D model.
Pricing
| Texture | Texture Quality | Geometry Quality | Quad | Cost |
|---|---|---|---|---|
| No | — | Standard | No | $0.20 |
| No | — | Detailed | No | $0.40 |
| Yes | Standard | Standard | No | $0.30 |
| Yes | Standard | Detailed | No | $0.50 |
| Yes | Detailed | Standard | No | $0.40 |
| Yes | Detailed | Detailed | No | $0.60 |
Add +$0.05 to any combination above when quad is enabled.
Billing Rules
- Base: $0.20 × texture multiplier (no texture: ×1, standard texture: ×1.5, detailed texture: ×2)
- Detailed geometry surcharge: +$0.20
- Quad surcharge: +$0.05
- Default configuration (texture standard, geometry standard, no quad): $0.30
Best Use Cases
- Game asset production — Reconstruct clean, textured 3D models from product or object photography for use in game engines.
- E-commerce 3D — Generate 3D product models from a single product photo for interactive viewers and AR.
- Animation & VFX — Use quad mesh output for animation-ready topology compatible with rigging and sculpting workflows.
- Digital twins — Accurately reconstruct real-world objects from a single reference photograph.
- AR/VR content — Generate PBR-textured models for immersive application development.
- Rapid prototyping — Quickly convert reference photos into 3D assets for concept visualization.
Pro Tips
- Use a clear, well-lit photo with the subject centered and clearly visible for the most accurate reconstruction.
- Plain or neutral backgrounds help the model focus on the object geometry and texture.
- Use detailed geometry quality for objects with fine surface detail like mechanical parts or organic shapes.
- Use quad mesh when the model will be used for animation or further sculpting.
- Enable auto_size when you need the model to match real-world scale.
- For better accuracy with complex objects, consider using Multiview-to-3D with multiple angle shots.
Notes
- image is the only required field; all other parameters are optional.
- Please ensure your content complies with Tripo3D’s usage policies.
Related Models
- Tripo3D H3.1 Multiview-to-3D — Higher accuracy 3D reconstruction from 2–4 reference images.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/tripo3d/h3.1/image-to-3d" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"texture_alignment": "original_image",
"orientation": "default",
"texture": true,
"pbr": true,
"texture_quality": "standard",
"geometry_quality": "standard",
"auto_size": false,
"quad": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| image | string | Yes | - | URL of the input image for 3D model creation. | |
| texture_alignment | string | No | original_image | original_image, geometry | How textures are aligned. 'original_image' aligns to input image, 'geometry' aligns to generated geometry. |
| orientation | string | No | default | default, align_image | Model orientation. 'align_image' auto-rotates to match the input image. |
| texture | boolean | No | true | - | Whether to generate textures for the model. |
| pbr | boolean | No | true | - | Whether to generate PBR (Physically Based Rendering) materials. If true, texture is also enabled. |
| texture_quality | string | No | standard | standard, detailed | Quality level for textures. 'detailed' produces higher-resolution textures. |
| geometry_quality | string | No | standard | standard, detailed | Quality level for geometry. |
| auto_size | boolean | No | false | - | Auto-scale the model to real-world dimensions. |
| quad | boolean | No | false | - | Generate quad (4-sided) mesh topology instead of triangles. |
| face_limit | integer | No | - | 1000 ~ 2000000 | Target number of faces for the generated mesh. If not set, the model adaptively determines the count. |
| model_seed | integer | No | - | - | Seed for geometry generation reproducibility. |
| image_seed | integer | No | - | - | Seed for the text-to-image step. |
| texture_seed | integer | No | - | - | Seed for texture generation reproducibility. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |