Hunyuan3D V2 Mini | AI Image-to-3D Model API

Hunyuan3D V2 Mini — Image-to-3D

Hunyuan3D V2 Mini is part of Tencent's open-source Hunyuan3D-2 series — a state-of-the-art 3D generation system that transforms 2D images into high-fidelity 3D models with detailed textures. This lightweight version delivers fast, affordable 3D generation without sacrificing quality.

Why It Stands Out

Single image input: Generate complete 3D models from just one 2D image.
Fast generation: Completes model generation in as fast as 30 seconds.
High-fidelity output: Produces detailed 3D models with accurate geometry and high-resolution textures.
Decoupled architecture: Separates geometry generation and texture synthesis for improved quality.
Simple workflow: Just upload an image — no 3D expertise required.

Technical Highlights

The Hunyuan3D-2 system adopts a separated process of geometry generation + texture synthesis:

Geometry Generation (Hunyuan3D-DiT): Based on a flow diffusion model that generates untextured 3D geometric models, with 2.6B parameters, capable of precisely extracting geometric information from input images.
Texture Synthesis (Hunyuan3D-Paint): Adds high-resolution (4K) textures to geometric models, with 1.3B parameters, supporting multi-view diffusion generation technology to ensure realistic textures and consistent lighting.

By decoupling shape and texture generation, the system effectively reduces complexity and improves generation quality.

Performance and Efficiency

Fast Generation: Completes model generation in as fast as 30 seconds.
Accelerated Inference: The optimized version shortens inference time by 50% through guidance distillation techniques.
Multi-modal Support: Compatible with various input methods and integrations including Blender plugins and Gradio applications.

Parameters

Parameter	Required	Description
image	Yes	Source image to convert to 3D (upload or public URL).

How to Use

Upload your image — drag and drop a file or paste a public URL.
Click Run and wait for the 3D model to generate.
Preview and download the result.

Best Use Cases

Game Development — Quickly generate 3D assets from concept art or icons.
App & UI Design — Create 3D icons and UI elements from 2D designs.
E-commerce — Generate 3D product models for interactive displays.
3D Printing — Convert 2D designs into printable 3D models.
AR/VR Content — Generate 3D objects for augmented and virtual reality.
Rapid Prototyping — Visualize designs in 3D without manual modeling.

Pricing

Output	Price
Per 3D model	$0.10

Pro Tips for Best Quality

Use images with clear subjects against simple or transparent backgrounds.
Front-facing views typically produce the best results.
Ensure the subject is well-lit and clearly visible in the image.
Icons and objects with distinct shapes work particularly well.
Higher resolution source images generally yield more detailed 3D models.

Notes

Ensure uploaded image URLs are publicly accessible.
Processing time varies based on image complexity and current queue load.
For higher quality output, consider using the full Hunyuan3D V2 model.
Please ensure your content complies with usage guidelines.

Hunyuan3d v2 Mini API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-mini with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Hunyuan3d v2 Mini below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-mini" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "image": "https://example.com/your-input.jpg"
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey);

try {
  const result = await client.run("wavespeed-ai/hunyuan3d/v2-mini", {
        "image": "https://example.com/your-input.jpg"
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(api_key=os.environ["WAVESPEED_API_KEY"])

try:
    output = client.run(
        "wavespeed-ai/hunyuan3d/v2-mini",
        {
    "image": "https://example.com/your-input.jpg"
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Hunyuan3d v2 Mini API — Frequently asked questions

What is the Hunyuan3d v2 Mini API?

Hunyuan3d v2 Mini is a WaveSpeedAI model for 3D asset generation from images, exposed as a REST API on WaveSpeedAI. 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. You can call it programmatically or try it from the playground above.

How do I call the Hunyuan3d v2 Mini API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission 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. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/hunyuan3d-v2-mini.

How much does Hunyuan3d v2 Mini cost per run?

Hunyuan3d v2 Mini starts at $0.10 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Hunyuan3d v2 Mini accept?

Key inputs: `image`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/hunyuan3d-v2-mini.

How long does Hunyuan3d v2 Mini take to generate?

Average end-to-end generation time on WaveSpeedAI is around 510 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Hunyuan3d v2 Mini outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

示例查看全部

相關模型

README