Hunyuan3D API

About the Hunyuan3D API

What Hunyuan3D does, how it fits in the Tencent model lineup, and why teams reach for it.

All Hunyuan3D API endpoints

8 endpoints available now on WaveSpeedAI — pick the variant that matches your workflow.

Sketch To 3d

Transform your sketches into detailed 3D models with Tencent's Hunyuan3D V3. Convert hand-drawn sketches and concept art into high-quality 3D assets with textures, perfect for rapid prototyping and game development. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

image-to-3dfrom $0.38

Image To 3d

Transform your photos into ultra-high-resolution 3D models in seconds with Tencent's Hunyuan3D V3 Image to 3D. Film-quality geometry with PBR textures from single or multi-view images, ready for games, e-commerce, and 3D printing. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

image-to-3dfrom $0.25

Text To 3d

Turn text prompts into detailed, fully-textured 3D models with Tencent's Hunyuan3D V3. Generate high-quality 3D assets with PBR materials from simple descriptions, ready for Unity, Unreal, and Blender. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-3dfrom $0.25

v2.1

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.

image-to-3dfrom $0.40

v2 Multi View

Hunyuan3D V2 Multi-View generates accurate 3D reconstructions from multiple images. Tencent-developed and available on WaveSpeedAI. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

image-to-3dfrom $0.020

v2 Mini

Hunyuan3D-V2-Mini is a Tencent image-to-3D generative model available on WaveSpeedAI. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

image-to-3dfrom $0.10

v2 Base

Hunyuan3D-V2-Base is a state-of-the-art Image-to-3D model by Tencent that turns images into 3D assets for visualization and content. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

image-to-3dfrom $0.16

Hunyuan3d v2 Multi View

Hunyuan3D V2 Multi-View is Tencent's image-to-3D generative model on WaveSpeedAI that builds 3D reconstructions from multi-view images. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

image-to-3dfrom $0.010

See Hunyuan3D in action

Real outputs generated by the Hunyuan3D API. Hover any video to preview, click to open the full-size viewer.

How to use the Hunyuan3D API

Four steps from signup to a finished generation. Full Python, Node.js, and cURL examples are in the API section below.

1. 1

   Get an API key

   Sign up for a WaveSpeedAI account and copy your API key from the dashboard. New accounts come with free starter credits — enough to run the playground a few dozen times before billing kicks in.

2. 2

   Submit a prediction

   POST your input as JSON to https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base. The endpoint returns a prediction id immediately — generations are async so you don't hold an open connection during inference.

3. 3

   Poll for completion

   GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result every 1-2 seconds. The response includes a status field; keep polling until it flips from"queued" or"processing" to"completed".

4. 4

   Read the output URL

   Once status is"completed", read the URL from data.outputs[0]. The URL points to your generated media on the WaveSpeedAI CDN — image, video, audio, or 3D file depending on the Hunyuan3D variant you called.

What you can build with Hunyuan3D

Common workflows developers and creators use the Hunyuan3D API for.

Tips for prompting Hunyuan3D

Practical advice for getting better outputs from Hunyuan3D — drawn from the patterns that work across 3d models in production pipelines.

Hunyuan3D API pricing

Pricing is per-output. The final charge scales with the parameters you set in each variant's playground (resolution, duration, output count, references).

Call the Hunyuan3D API

Sign up for an API key at wavespeed.ai/accesskey, then submit a prediction via REST. The playground generates ready-to-paste samples for any combination of inputs.

# 1. Submit a prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{}'

# 2. Poll the result until status = "completed"
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Read the output URL from data.outputs[0].

// npm install wavespeed
const WaveSpeed = require('wavespeed');
const client = new WaveSpeed(); // reads WAVESPEED_API_KEY

const result = await client.run("wavespeed-ai/hunyuan3d/v2-base", {});
console.log(result.outputs[0]); // → URL of the generated output

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "wavespeed-ai/hunyuan3d/v2-base",
    {}
)
print(output["outputs"][0])  # → URL of the generated output

Hunyuan3D vs alternatives

When to pick Hunyuan3D over similar models on WaveSpeedAI.

Hunyuan3D API — Frequently asked questions

Pricing, license, integration — common questions about running Hunyuan3D on WaveSpeedAI.

About Tencent

The team behind Hunyuan3D and the broader Tencent model lineup on WaveSpeedAI.

Tencent's Hunyuan team produces Hunyuan3D, a family of image-to-3D models that convert photos into 3D meshes for visualization, game assets, and e-commerce. Variants cover single-image generation, lightweight Mini inference, multi-view reconstruction, and the v2.1 scalable asset-creation system.