Tencent3D APIFrom $0.30

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.

Hunyuan3D sample output

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.

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

01

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.

image-to-3dv3mesh
02

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.

multi-viewgeometryv3
03

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.

text-to-3dv3textured
04

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.

low-polygeometrypbr

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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).

Starting price

$0.30

2 endpoints · Hunyuan3D

Open Playground
EndpointTypeStarting price
wavespeed-ai/hunyuan3d-v3/image-to-3dimage-to-3d$0.30
wavespeed-ai/hunyuan3d-v3/text-to-3dtext-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
done

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.