Hunyuan3D API
Tencent Hunyuan3D – Image-to-3D-, Text-to-3D- und Sketch-to-3D-Generierung für Visualisierungs- und Content-Workflows. Varianten V2 Base, Mini und Multi-View sowie die Endpunkte V3 Image-to-3D, Text-to-3D und Sketch-to-3D.
V2: v2-base und v2-mini für 3D aus einem einzelnen Bild; v2-multi-view für die Rekonstruktion aus mehreren Bildern; v2.1 für skalierbare Asset-Erstellung. V3: image-to-3d (ultrahohe Auflösung aus Fotos), text-to-3d (vollständig texturierte Modelle aus Prompts) und sketch-to-3d (Konzeptzeichnung zu Mesh).
Überblick
Über Hunyuan3D API
Was Hunyuan3D leistet, wie es in die Modellpalette von Tencent passt und warum Teams darauf zurückgreifen.
Hunyuan3D ist ein Modell von Tencent für 3D-Asset-Generierung, verfügbar über die WaveSpeedAI-REST-API. Tencent Hunyuan3D – Image-to-3D-, Text-to-3D- und Sketch-to-3D-Generierung für Visualisierungs- und Content-Workflows. Varianten V2 Base, Mini und Multi-View sowie die Endpunkte V3 Image-to-3D, Text-to-3D und Sketch-to-3D.
V2: v2-base und v2-mini für 3D aus einem einzelnen Bild; v2-multi-view für die Rekonstruktion aus mehreren Bildern; v2.1 für skalierbare Asset-Erstellung. V3: image-to-3d (ultrahohe Auflösung aus Fotos), text-to-3d (vollständig texturierte Modelle aus Prompts) und sketch-to-3d (Konzeptzeichnung zu Mesh).
Die Familie Hunyuan3D auf WaveSpeedAI umfasst 7 REST-Endpunkte für die Workflows Image-To-3d, Text-To-3d. Jede Variante hat eigene Preise, Parameter und Beispielausgaben – wählen Sie die, die zu Ihrer Eingabemodalität und Ihren Produktionsanforderungen passt, oder rufen Sie mit demselben API-Schlüssel mehrere auf, um mehrstufige Pipelines zu bauen.
Nutzen Sie Hunyuan3D mit demselben API-Schlüssel, demselben Abrechnungskonto und denselben Rate Limits wie die über 1.000 weiteren KI-Modelle auf WaveSpeedAI. Keine separate Einrichtung bei Anbietern, keine SDKs pro Anbieter, keine Rate Limits pro Anbieter – eine Integration deckt alles ab, von Text-zu-Bild und Text-zu-Video über Audiosynthese, 3D-Generierung und Hochskalierung bis zur Bearbeitung.
Endpunkte
Alle Hunyuan3D-API-Endpunkte
7 Hunyuan3D-Endpunkte jetzt auf WaveSpeedAI verfügbar – wählen Sie die Variante, die zu Ihrem Workflow passt.
/filters:quality(82)/media/images/1789124787640423161_ZFOX7hqy.webp)
Hunyuan3d v3 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.
/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.
/filters:quality(82)/media/images/1789124963421423807_NtCLU3dn.webp)
Hunyuan3d 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.
/filters:quality(82)/media/images/20260408111455_pe9fgusa.webp)
Hunyuan3d 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.
/filters:quality(82)/media/images/20260408111453_hu9t8kxy.webp)
Hunyuan3d 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.
/filters:quality(82)/media/images/20260408111447_w87sl0cm.webp)
Hunyuan3d 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.
Beispiele
Hunyuan3D in Aktion
Echte Ausgaben der Hunyuan3D-API. Fahren Sie über ein Video für eine Vorschau und klicken Sie, um den Viewer in voller Größe zu öffnen.
Anleitung
So verwenden Sie die Hunyuan3D-API
Vier Schritte von der Registrierung bis zur fertigen Generierung. Vollständige Beispiele in Python, Node.js und cURL finden Sie unten im Abschnitt „API“.
- 01
API-Schlüssel holen
Registrieren Sie ein WaveSpeedAI-Konto und kopieren Sie Ihren API-Schlüssel aus dem Dashboard. Neue Konten erhalten kostenlose Start-Credits – genug, um den Playground einige Dutzend Mal zu nutzen, bevor die Abrechnung beginnt.
- 02
Prediction senden
Senden Sie Ihre Eingabe als JSON per POST an https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base. Der Endpunkt gibt sofort eine Prediction-ID zurück – Generierungen laufen asynchron, sodass Sie während der Inferenz keine Verbindung offen halten.
- 03
Auf Abschluss prüfen
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Geben Sie bei „completed“ die Ausgaben zurück; brechen Sie bei „failed“, „cancelled“, „timeout“ oder „deleted“ mit einem Fehler ab; fragen Sie bei allen anderen Status weiter ab.
- 04
Ausgabe-URL lesen
Sobald der Status „completed“ ist, lesen Sie die URL aus data.outputs[0]. Die URL verweist auf Ihre generierten Medien im WaveSpeedAI-CDN – Bild, Video, Audio oder 3D-Datei, je nach aufgerufener Variante von Hunyuan3D.
Anwendungsfälle
Was Sie mit Hunyuan3D bauen können
Gängige Workflows, für die Entwickler und Kreative die Hunyuan3D-API nutzen.
3D-Asset aus einem einzelnen Bild
wavespeed-ai/hunyuan3d/v2-base ist ein hochmodernes Image-to-3D-Modell von Tencent, das Bilder in 3D-Assets für Visualisierung und Content verwandelt – der Standardendpunkt für die Mesh-Generierung von Produkten und Figuren.
Leichtgewichtige Mini-Variante
wavespeed-ai/hunyuan3d/v2-mini ist Tencents kompaktes generatives Image-to-3D-Modell – nützlich für schnelle Iteration, mobile Vorschauen und Pipelines, in denen sich Mesh-Details nachgelagert verfeinern lassen.
Rekonstruktion aus mehreren Ansichten
wavespeed-ai/hunyuan3d/v2-multi-view erzeugt präzise 3D-Rekonstruktionen aus mehreren Bildern – liefern Sie Vorder-, Seiten- und Rückansicht für stärkere Geometrie an verdeckten Flächen.
v2.1 für skalierbare Asset-Erstellung
wavespeed-ai/hunyuan3d/v2.1 ist Tencents skalierbares System zur 3D-Asset-Erstellung, das den Stand der Technik bei der 3D-Generierung voranbringt – die Variante für Produktions-Workflows mit höheren Qualitätsanforderungen.
V3 Text-to-3D aus Prompts
wavespeed-ai/hunyuan3d-v3/text-to-3d macht aus Text-Prompts detaillierte, vollständig texturierte 3D-Modelle – erzeugen Sie Assets aus Beschreibungen ohne Quellbild.
V3 Sketch-to-3D für Konzeptzeichnungen
wavespeed-ai/hunyuan3d-v3/sketch-to-3d wandelt handgezeichnete Skizzen und Konzeptzeichnungen in detaillierte 3D-Modelle um – nützlich für die frühe Designerkundung.
Tipps
Tipps zum Prompting von Hunyuan3D
Praktische Ratschläge für bessere Ausgaben von Hunyuan3D – abgeleitet aus Mustern, die bei 3D-Modellen in Produktions-Pipelines funktionieren.
- 01
Multi-View für verdeckte Geometrie
Wenn Sie Fotos von vorn, von der Seite und von hinten haben, nutzen Sie v2-multi-view – Base/Mini mit einem einzelnen Bild raten verdeckte Flächen, Multi-View rekonstruiert sie präzise.
- 02
Mini für schnelle Iteration
v2-mini für schnelle Vorschau-Meshes bei der Konzepterkundung; wechseln Sie zu v2-base oder v2.1, wenn die Richtung der Geometrie feststeht.
- 03
Saubere, gut ausgeleuchtete Quellbilder
Die Qualität von Image-to-3D wird durch die Qualität des Quellfotos begrenzt. Gleichmäßiges Licht, minimale Schatten und eine klare Silhouette des Motivs liefern sauberere Meshes.
- 04
PBR-Erwartungen für nachgelagerte Schritte festlegen
Hunyuan3D liefert Meshes für Visualisierung – planen Sie Texturierung und PBR-Materialdurchgang nach der Generierung in Ihrem DCC-Tool oder Rendering-Engine ein.
- 05
Produktfotos auf neutralem Hintergrund
E-Commerce-Produktaufnahmen auf weißem/neutralem Hintergrund liefern die sauberste Geometrie-Extraktion – unruhige Hintergründe bringen Rauschen in das rekonstruierte Mesh.
Preise
Hunyuan3D-API-Preise
Die Abrechnung erfolgt pro Ausgabe. Der Endpreis richtet sich nach den Parametern, die Sie im Playground jeder Variante setzen (Auflösung, Dauer, Anzahl der Ausgaben, Referenzen).
| Endpunkt | Typ | Startpreis |
|---|---|---|
| wavespeed-ai/ | image-to-3d | $0.45 |
| wavespeed-ai/ | image-to-3d | $0.30 |
| wavespeed-ai/ | text-to-3d | $0.30 |
| wavespeed-ai/ | image-to-3d | $0.45 |
| wavespeed-ai/ | image-to-3d | $0.20 |
| wavespeed-ai/ | image-to-3d | $0.12 |
| wavespeed-ai/ | image-to-3d | $0.16 |
API
Die Hunyuan3D-API aufrufen
Holen Sie sich unter wavespeed.ai/accesskey einen API-Schlüssel und senden Sie dann eine Prediction per REST. Der Playground erzeugt einfügefertige Beispiele für jede Kombination von Eingaben.
POSThttps://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-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 '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
}')
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/v2-base";
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"
}),
});
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"
}
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/v2-base", 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)Vergleich
Hunyuan3D im Vergleich zu Alternativen
Wann Sie Hunyuan3D ähnlichen Modellen auf WaveSpeedAI vorziehen sollten.
Hunyuan3D vs. Tripo3D
Tripo3D bietet schnelles Image-to-3D mit Texture Baking. Hunyuan3D deckt aus Tencents Forschungs-Stack mehrere Qualitätsstufen ab (Base, Mini, Multi-View, v2.1) – wählen Sie nach Eingabetyp (einzelne oder mehrere Ansichten) und Qualitätsanforderung.
Hunyuan3D vs. Meshy
Meshy ist ein Web-first-Tool für 3D-Generierung. Hunyuan3D ist auf WaveSpeedAI API-first – besser für automatisierte Pipelines, Batch-Asset-Generierung und SaaS-Integration ohne manuellen UI-Schritt.
Hunyuan3D vs. Manual photogrammetry
Photogrammetrie braucht Dutzende Fotos und lange Verarbeitungszeiten. Hunyuan3D erzeugt aus einem oder wenigen Bildern in Sekunden ein brauchbares Mesh – schneller für Prototyping, weniger genau für Rekonstruktion in Scan-Qualität.
FAQ
Hunyuan3D API — Häufig gestellte Fragen
Preise, Lizenz, Integration – häufige Fragen zur Nutzung von Hunyuan3D auf WaveSpeedAI.
Was ist die Hunyuan3D-API?
Hunyuan3D ist ein Tencent-Modell für 3D, das auf WaveSpeedAI als REST-API bereitgestellt wird. Tencent Hunyuan3D – Image-to-3D-, Text-to-3D- und Sketch-to-3D-Generierung für Visualisierungs- und Content-Workflows. Varianten V2 Base, Mini und Multi-View sowie die Endpunkte V3 Image-to-3D, Text-to-3D und Sketch-to-3D. Sie können es programmatisch aufrufen oder im oben verlinkten Playground ausprobieren.
Wie rufe ich die Hunyuan3D-API auf?
Registrieren Sie ein WaveSpeedAI-Konto, kopieren Sie Ihren API-Schlüssel von /accesskey und senden Sie dann per POST an https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base Ihre Eingabe als JSON. Der Endpunkt gibt eine Prediction-ID zurück. Fragen Sie den Ergebnis-Endpunkt etwa alle 2 Sekunden ab, verlängern Sie das Intervall bei lang laufenden Aufgaben und hören Sie bei jedem Endstatus auf. Produktionsnahe Beispiele in Python / Node.js / cURL finden Sie oben.
Was kostet die Hunyuan3D-API?
Hunyuan3D beginnt bei $0.12 pro Aufruf. Die genauen Kosten richten sich nach den Parametern, die Sie setzen (Auflösung, Dauer, Anzahl der Ausgaben, Referenzen). Die Live-Kostenvorschau neben der Schaltfläche „Generieren“ im Playground zeigt den genauen Preis für Ihre aktuelle Eingabe.
Welche Varianten von Hunyuan3D sind verfügbar?
WaveSpeedAI stellt 7 aktive Hunyuan3D-Endpunkte bereit: wavespeed-ai/hunyuan3d-v3/sketch-to-3d, wavespeed-ai/hunyuan3d-v3/image-to-3d, wavespeed-ai/hunyuan3d-v3/text-to-3d, wavespeed-ai/hunyuan3d/v2.1, wavespeed-ai/hunyuan3d/v2-multi-view, wavespeed-ai/hunyuan3d/v2-mini, wavespeed-ai/hunyuan3d/v2-base. Jede Variante hat eine eigene Playground-Seite und eigene Preise.
Kann ich die Ausgaben von Hunyuan3D kommerziell nutzen?
Die kommerziellen Nutzungsrechte richten sich nach der Modelllizenz von Tencent. Die meisten Modelle von Tencent erlauben die kommerzielle Nutzung der Ausgaben; die konkrete Lizenzzusammenfassung finden Sie auf der Playground-Seite des jeweiligen Modells, die Bedingungen auf Plattformebene in den Nutzungsbedingungen von WaveSpeedAI.
Warum Hunyuan3D auf WaveSpeedAI nutzen statt direkt?
Ein API-Schlüssel und ein Abrechnungskonto für Hunyuan3D UND über 1.000 weitere KI-Modelle anderer Anbieter. Keine SDK-Einrichtung pro Anbieter, keine separaten Rate Limits, kein Neuschreiben von Integrationscode pro Anbieter. Die Preise liegen in der Regel auf dem Niveau der direkten API von Tencent oder darunter.
Anbieter
Über Tencent
Das Team hinter Hunyuan3D und der übrigen Modellpalette von Tencent auf WaveSpeedAI.
Das Hunyuan-Team von Tencent entwickelt Hunyuan3D, eine Familie von Image-to-3D-Modellen, die Fotos in 3D-Meshes für Visualisierung, Spiele-Assets und E-Commerce verwandeln. Die Varianten decken Generierung aus einem einzelnen Bild, leichtgewichtige Mini-Inferenz, Rekonstruktion aus mehreren Ansichten und das skalierbare Asset-Erstellungssystem v2.1 ab.
Starten Sie mit Hunyuan3D auf WaveSpeedAI
Kostenlose Start-Credits bei der Registrierung. Ein API-Schlüssel für über 1.000 KI-Modelle von Tencent und allen anderen Anbietern.