Hunyuan3D API
Tencent Hunyuan3D — image-to-3D and text-to-3D generation for visualization and content workflows, with the V3 Image-to-3D and Text-to-3D endpoints.
V3 image-to-3d turns a photo into a high-resolution textured 3D model, with optional extra views for better geometry. V3 text-to-3d builds fully textured models straight from a prompt.
Overview
About the Hunyuan3D API
What Hunyuan3D does, how it fits in the Tencent model lineup, and why teams reach for it.
Hunyuan3D is a 3D asset generation model from Tencent, available through the WaveSpeedAI REST API. Tencent Hunyuan3D — image-to-3D and text-to-3D generation for visualization and content workflows, with the V3 Image-to-3D and Text-to-3D endpoints.
V3 image-to-3d turns a photo into a high-resolution textured 3D model, with optional extra views for better geometry. V3 text-to-3d builds fully textured models straight from a prompt.
The Hunyuan3D family on WaveSpeedAI ships 2 REST endpoints covering Image-To-3d, Text-To-3d workflows. Each variant carries its own pricing, parameter knobs, and example outputs — pick the one that matches your input modality and production constraints, or call several from the same API key to compose multi-step pipelines.
Run Hunyuan3D through the same API key, billing account, and rate-limit envelope you use for the other 1,000+ AI models on WaveSpeedAI. No separate vendor setup, no per-provider SDKs, no per-vendor rate-limit envelopes — one integration covers everything from text-to-image and text-to-video through audio synthesis, 3D generation, upscaling, and editing.
Endpoints
All Hunyuan3D API endpoints
2 Hunyuan3D endpoints available now on WaveSpeedAI — pick the variant that matches your workflow.
/filters:quality(82)/media/images/1789121202949516194_iYoyHQZ9.webp)
Hunyuan3d v3 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.
/filters:quality(82)/media/images/1789116903089615525_rhenxGPZ.webp)
Hunyuan3d v3 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.
Examples
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
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.
- 01
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.
- 02
Submit a prediction
POST your input as JSON to https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d-v3/image-to-3d. The endpoint returns a prediction id immediately — generations are async so you don't hold an open connection during inference.
- 03
Poll for completion
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Return outputs on completed; stop with an error on failed, cancelled, timeout, or deleted; continue polling for every other status.
- 04
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.
Use cases
What you can build with Hunyuan3D
Common workflows developers and creators use the Hunyuan3D API for.
Photo to 3D asset
wavespeed-ai/hunyuan3d-v3/image-to-3d turns a single photo into a detailed 3D model — the default endpoint for product and character mesh generation.
Extra views for occluded geometry
Add left, right, and back images to wavespeed-ai/hunyuan3d-v3/image-to-3d for stronger geometry on surfaces the front photo cannot see.
V3 text-to-3D from prompts
wavespeed-ai/hunyuan3d-v3/text-to-3d turns text prompts into detailed, fully-textured 3D models — generate assets from descriptions without a source image.
Low-poly and geometry-only output
Choose a low-poly or geometry-only result for clean base meshes, or enable PBR materials when the model needs them.
Tips
Tips for prompting Hunyuan3D
Practical advice for getting better outputs from Hunyuan3D — drawn from the patterns that work across 3D models in production pipelines.
- 01
Add views for occluded geometry
When you have left, right, and back photos, add them to the V3 image-to-3d request — a single photo has to guess at surfaces it cannot see.
- 02
Pick the output type first
Use the low-poly or geometry-only output when you need a clean base mesh, and the standard textured output when the model is final.
- 03
Clean, well-lit source images
Image-to-3D quality is bottlenecked by source photo quality. Even lighting, minimal shadows, and a clear subject silhouette produce cleaner meshes.
- 04
Specify PBR expectations in downstream
Hunyuan3D outputs meshes for visualization — plan your texturing and PBR material pass in your DCC tool or rendering engine after generation.
- 05
Product photos on neutral backgrounds
E-commerce product shots on white/neutral backgrounds produce the cleanest geometry extraction — busy backgrounds add noise to the reconstructed mesh.
Pricing
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).
| Endpoint | Type | Starting price |
|---|---|---|
| wavespeed-ai/ | image-to-3d | $0.30 |
| wavespeed-ai/ | text-to-3d | $0.30 |
API
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.
POSThttps://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d-v3/image-to-3d
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d-v3/image-to-3d" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"enable_pbr": false,
"face_count": 500000,
"generate_type": "Normal"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d-v3/image-to-3d";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"enable_pbr": false,
"face_count": 500000,
"generate_type": "Normal"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"enable_pbr": False,
"face_count": 500000,
"generate_type": "Normal"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d-v3/image-to-3d", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Compare
Hunyuan3D vs alternatives
When to pick Hunyuan3D over similar models on WaveSpeedAI.
Hunyuan3D vs Tripo3D
Tripo3D ships fast image-to-3D with texture baking. Hunyuan3D V3 offers image-to-3D with optional extra views and text-to-3D, with low-poly and geometry-only output — pick based on input type and the mesh style you need.
Hunyuan3D vs Meshy
Meshy is a web-first 3D generation tool. Hunyuan3D is API-first on WaveSpeedAI — better for automated pipelines, batch asset generation, and SaaS integration without a manual UI step.
Hunyuan3D vs Manual photogrammetry
Photogrammetry requires dozens of photos and long processing times. Hunyuan3D generates a usable mesh from one or a few images in seconds — faster for prototyping, less accurate for scan-grade reconstruction.
FAQ
Hunyuan3D API — Frequently asked questions
Pricing, license, integration — common questions about running Hunyuan3D on WaveSpeedAI.
What is the Hunyuan3D API?
Hunyuan3D is a Tencent 3D model exposed as a REST API on WaveSpeedAI. Tencent Hunyuan3D — image-to-3D and text-to-3D generation for visualization and content workflows, with the V3 Image-to-3D and Text-to-3D endpoints. You can call it programmatically or try it from the playground linked above.
How do I call the Hunyuan3D API?
Sign up for a WaveSpeedAI account, copy your API key from /accesskey, then POST to https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d-v3/image-to-3d with your input as JSON. The endpoint returns a prediction id. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. Production-oriented Python / Node.js / cURL examples are above.
How much does the Hunyuan3D API cost?
Hunyuan3D starts at $0.30. The exact cost scales with the parameters you set (resolution, duration, output count, references). The live cost preview next to the Generate button in the playground shows the exact price for your current input.
Which Hunyuan3D variants are available?
WaveSpeedAI hosts 2 live Hunyuan3D endpoints: wavespeed-ai/hunyuan3d-v3/image-to-3d, wavespeed-ai/hunyuan3d-v3/text-to-3d. Each variant has its own playground page and pricing.
Can I use Hunyuan3D outputs commercially?
Commercial usage rights follow the Tencent model license. Most Tencent models permit commercial output use; see each model's playground page for the specific license summary, and WaveSpeedAI's Terms of Service for platform-level conditions.
Why use Hunyuan3D on WaveSpeedAI instead of going direct?
One API key + one billing account across Hunyuan3D AND 1,000+ other AI models from other providers. No per-vendor SDK setup, no separate rate-limit envelopes, no rewrite-per-vendor integration code. Pricing is typically at parity with or below Tencent's direct API.
Provider
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.
Start building with Hunyuan3D on WaveSpeedAI
Free starter credits on signup. One API key across 1,000+ AI models from Tencent and every other provider.