Wiro - Hunyuan3D-2.1 3D Model Generator
AI-generatedOverview
This node integrates with the Wiro Hunyuan3D-2.1 AI 3D model generator API to convert a given input image URL into a 3D mesh model. It is useful for designers and developers who want to automate the creation of 3D assets from 2D images, supporting advanced options like background removal, texture generation, and mesh simplification.
Use Case Examples
- Generating a 3D model from a product image for use in virtual showrooms.
- Creating 3D assets from concept art images for game development.
- Automating 3D model creation from photographs for augmented reality applications.
Properties
| Name | Meaning |
|---|---|
| Input Image URL | The URL of the image file to be converted into a 3D mesh. |
| Inference Steps | Number of inference steps to control the detail and quality of the 3D generation process. |
| Guidance Scale | Guidance scale parameter influencing the generation process. |
| Seed | Seed value for random number generation to ensure reproducibility. |
| Octree Resolution | Resolution of the octree structure used for mesh extraction; higher values create more detailed geometry. |
| Number Of Chunks | Number of chunks for parallel processing during mesh generation. |
| Max Number Of View | Number of viewpoints used for multi-view texture synthesis. |
| Texture Resolution | Resolution of the generated texture maps in pixels. |
| Max Facenum | Maximum polygon count for mesh simplification; set to 0 to disable face reduction. |
| Remove Background | Automatically removes the background from the input image before 3D generation. |
| Generate Texture | Enables PBR texture generation including albedo, metallic, and roughness maps. |
Output
JSON
taskid- The unique identifier of the 3D generation task.url- The URL to the generated 3D model asset, available upon successful completion.status- The status of the 3D generation task, e.g., 'completed' or 'failed'.
Dependencies
- Wiro API key and secret credentials for authentication
Troubleshooting
- If the node throws an error about missing task ID or socket access token, verify that the Wiro API credentials are correct and the API endpoint is reachable.
- A 'failed' status in the output indicates the 3D generation task did not complete successfully; check the input parameters and image URL validity.
- Ensure the input image URL is accessible and points to a valid image file to avoid request failures.
Links
- Wiro Hunyuan3D-2.1 API Documentation - Official API endpoint used by the node for 3D model generation.