Hunyuan3d V2.1
Playground
Try it on WavespeedAI!Tencent Hunyuan3D v2.1 is a scalable 3D asset-creation system that advances state-of-the-art 3D generation for asset workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Hunyuan3D V2.1
Hunyuan3D V2.1 is Tencent’s advanced image-to-3D generation model. Upload a single photo and the model reconstructs it as a detailed, textured 3D asset — ready for use in games, product visualization, AR/VR, and creative pipelines.
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.
-
High geometric fidelity Accurately reconstructs object shape, surface detail, and proportions from the input image.
-
Rich texture output Produces clean, high-quality textures that closely match the colors and materials in the source photo.
-
Production-ready assets Output is suitable for direct use in game engines, 3D editors, and AR/VR workflows.
How to Use
- Upload your image — provide a clear, well-lit photo of the object you want to convert to 3D.
- Submit — the model reconstructs and textures the 3D asset automatically.
- Download your generated 3D model.
Pricing
Just $0.40 per generation.
Best Use Cases
- Game & Interactive Media — Rapidly prototype 3D props and assets from reference photos.
- E-commerce & Product Visualization — Create 3D product models for interactive viewers and AR try-on experiences.
- AR/VR Content — Generate real-world object reconstructions for immersive applications.
- Creative & Design — Turn concept art or physical objects into editable 3D assets without manual modeling.
- Digital Twins — Quickly digitize physical objects for simulation or archival purposes.
Pro Tips
- Use a clean, well-lit photo with the object centered and clearly visible for the most accurate reconstruction.
- Plain or neutral backgrounds help the model focus on the object geometry and texture.
- Avoid heavily reflective or transparent surfaces — these are harder for single-image reconstruction to handle accurately.
- Photos taken at a slight angle (rather than perfectly flat-on) tend to produce better depth estimation.
Notes
- image is the only required field.
- Ensure image URLs are publicly accessible if using a link rather than a direct upload.
- Please ensure your content complies with WaveSpeed AI’s usage policies.
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/wavespeed-ai/hunyuan3d/v2.1" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{}'
# 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 image to use while generating the 3D model. |
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 |