Hunyuan3D API
Tencent Hunyuan3D — génération image vers 3D, texte vers 3D et croquis vers 3D pour les workflows de visualisation et de contenu. Variantes V2 Base, Mini et Multi-View, plus les endpoints V3 Image-to-3D, Text-to-3D et Sketch-to-3D.
V2 : v2-base et v2-mini pour la 3D à partir d'une seule image ; v2-multi-view pour la reconstruction à partir de plusieurs images ; v2.1 pour la création d'assets à grande échelle. V3 : image-to-3d (très haute résolution à partir de photos), text-to-3d (modèles entièrement texturés à partir de prompts) et sketch-to-3d (du concept art au maillage).
Présentation
À propos de Hunyuan3D API
Ce que fait Hunyuan3D, sa place dans la gamme de modèles Tencent, et pourquoi les équipes l’adoptent.
Hunyuan3D est un modèle de génération d’assets 3D proposé par Tencent, disponible via l’API REST de WaveSpeedAI. Tencent Hunyuan3D — génération image vers 3D, texte vers 3D et croquis vers 3D pour les workflows de visualisation et de contenu. Variantes V2 Base, Mini et Multi-View, plus les endpoints V3 Image-to-3D, Text-to-3D et Sketch-to-3D.
V2 : v2-base et v2-mini pour la 3D à partir d'une seule image ; v2-multi-view pour la reconstruction à partir de plusieurs images ; v2.1 pour la création d'assets à grande échelle. V3 : image-to-3d (très haute résolution à partir de photos), text-to-3d (modèles entièrement texturés à partir de prompts) et sketch-to-3d (du concept art au maillage).
La famille Hunyuan3D sur WaveSpeedAI propose 7 points d’accès REST couvrant les workflows Image-To-3d, Text-To-3d. Chaque variante a ses propres tarifs, paramètres et exemples de résultats — choisissez celle qui correspond à votre type d’entrée et à vos contraintes de production, ou appelez-en plusieurs avec la même clé API pour composer des pipelines en plusieurs étapes.
Exécutez Hunyuan3D avec la même clé API, le même compte de facturation et les mêmes limites de débit que pour les plus de 1 000 autres modèles IA de WaveSpeedAI. Pas de configuration fournisseur distincte, pas de SDK par fournisseur, pas de limites de débit par fournisseur — une seule intégration couvre tout, du texte vers image et du texte vers vidéo à la synthèse audio, la génération 3D, l’agrandissement et l’édition.
Points d’accès
Tous les points d’accès de l’API Hunyuan3D
7 points d’accès Hunyuan3D disponibles dès maintenant sur WaveSpeedAI — choisissez la variante qui correspond à votre workflow.
/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.
Exemples
Hunyuan3D en action
De vrais résultats générés par l’API Hunyuan3D. Survolez une vidéo pour la prévisualiser, cliquez pour ouvrir la visionneuse en taille réelle.
Mode d’emploi
Comment utiliser l’API Hunyuan3D
Quatre étapes de l’inscription à une génération terminée. Des exemples complets en Python, Node.js et cURL se trouvent dans la section API ci-dessous.
- 01
Obtenez une clé API
Créez un compte WaveSpeedAI et copiez votre clé API depuis le tableau de bord. Les nouveaux comptes reçoivent des crédits de démarrage gratuits — de quoi utiliser le playground quelques dizaines de fois avant le début de la facturation.
- 02
Soumettez une prédiction
Envoyez votre entrée en JSON par POST à https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base. Le point d’accès renvoie immédiatement un identifiant de prédiction — les générations sont asynchrones, vous ne gardez donc pas de connexion ouverte pendant l’inférence.
- 03
Interrogez jusqu’à la fin
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Retournez les outputs sur completed ; arrêtez avec une erreur sur failed, cancelled, timeout ou deleted ; continuez d’interroger pour tout autre statut.
- 04
Lisez l’URL du résultat
Une fois le statut "completed", lisez l’URL dans data.outputs[0]. Elle pointe vers votre média généré sur le CDN de WaveSpeedAI — fichier image, vidéo, audio ou 3D selon la variante Hunyuan3D appelée.
Cas d’usage
Ce que vous pouvez créer avec Hunyuan3D
Les workflows courants pour lesquels développeurs et créateurs utilisent l’API Hunyuan3D.
D'une seule image à un asset 3D
wavespeed-ai/hunyuan3d/v2-base est un modèle Image-to-3D à l'état de l'art de Tencent qui transforme des images en assets 3D pour la visualisation et le contenu — l'endpoint par défaut pour la génération de maillages de produits et de personnages.
Variante Mini légère
wavespeed-ai/hunyuan3d/v2-mini est le modèle génératif image vers 3D compact de Tencent — utile pour l'itération rapide, les aperçus mobiles et les pipelines où le détail du maillage peut être affiné en aval.
Reconstruction multi-vues
wavespeed-ai/hunyuan3d/v2-multi-view génère des reconstructions 3D précises à partir de plusieurs images — fournissez des vues de face, de côté et de dos pour une géométrie plus solide sur les surfaces occultées.
v2.1 pour la création d'assets à grande échelle
wavespeed-ai/hunyuan3d/v2.1 est le système de création d'assets 3D évolutif de Tencent qui fait progresser l'état de l'art de la génération 3D — la variante pour les workflows d'assets de production exigeant une fidélité supérieure.
Texte vers 3D V3 à partir de prompts
wavespeed-ai/hunyuan3d-v3/text-to-3d transforme des prompts textuels en modèles 3D détaillés et entièrement texturés — générez des assets à partir de descriptions sans image source.
Croquis vers 3D V3 pour le concept art
wavespeed-ai/hunyuan3d-v3/sketch-to-3d convertit des croquis dessinés à la main et du concept art en modèles 3D détaillés — utile pour l'exploration de design en phase initiale.
Conseils
Conseils pour rédiger vos prompts avec Hunyuan3D
Des conseils pratiques pour obtenir de meilleurs résultats avec Hunyuan3D — tirés des pratiques qui fonctionnent sur les modèles 3D dans les pipelines de production.
- 01
Multi-vues pour la géométrie occultée
Lorsque vous disposez de photos de face, de côté et de dos, utilisez v2-multi-view — Base/Mini à image unique devinent les surfaces occultées ; multi-vues les reconstruit avec précision.
- 02
Mini pour l'itération rapide
v2-mini pour des maillages d'aperçu rapides pendant l'exploration de concepts ; passez à v2-base ou v2.1 lorsque la direction de la géométrie est arrêtée.
- 03
Images sources propres et bien éclairées
La qualité de l'image vers 3D est limitée par la qualité de la photo source. Un éclairage uniforme, peu d'ombres et une silhouette de sujet nette produisent des maillages plus propres.
- 04
Prévoyez les attentes PBR en aval
Hunyuan3D produit des maillages pour la visualisation — prévoyez votre passe de texturage et de matériaux PBR dans votre outil DCC ou votre moteur de rendu après la génération.
- 05
Photos de produits sur fonds neutres
Les photos de produits e-commerce sur fond blanc/neutre donnent l'extraction de géométrie la plus propre — les arrière-plans chargés ajoutent du bruit au maillage reconstruit.
Tarifs
Tarifs de l’API Hunyuan3D
La tarification se fait par résultat. Le montant final dépend des paramètres définis dans le playground de chaque variante (résolution, durée, nombre de résultats, références).
| Point d’accès | Type | Prix de départ |
|---|---|---|
| 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
Appelez l’API Hunyuan3D
Obtenez une clé API sur wavespeed.ai/accesskey, puis soumettez une prédiction via REST. Le playground génère des exemples prêts à copier pour toute combinaison d’entrées.
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)Comparer
Hunyuan3D face aux alternatives
Quand choisir Hunyuan3D plutôt que des modèles similaires sur WaveSpeedAI.
Hunyuan3D vs Tripo3D
Tripo3D propose de l'image vers 3D rapide avec cuisson des textures. Hunyuan3D couvre plusieurs niveaux de qualité (Base, Mini, Multi-View, v2.1) issus de la pile de recherche de Tencent — choisissez selon le type d'entrée (vue unique ou multi-vues) et les besoins de fidélité.
Hunyuan3D vs Meshy
Meshy est un outil de génération 3D pensé web d'abord. Hunyuan3D est pensé API d'abord sur WaveSpeedAI — mieux adapté aux pipelines automatisés, à la génération d'assets par lots et à l'intégration SaaS sans étape manuelle dans une interface.
Hunyuan3D vs Manual photogrammetry
La photogrammétrie exige des dizaines de photos et de longs temps de traitement. Hunyuan3D génère un maillage exploitable à partir d'une ou de quelques images en quelques secondes — plus rapide pour le prototypage, moins précis pour une reconstruction de qualité scan.
FAQ
Hunyuan3D API — Questions fréquentes
Tarifs, licence, intégration — les questions courantes sur l’utilisation de Hunyuan3D sur WaveSpeedAI.
Qu’est-ce que l’API Hunyuan3D ?
Hunyuan3D est un modèle Tencent de génération 3D exposé sous forme d’API REST sur WaveSpeedAI. Tencent Hunyuan3D — génération image vers 3D, texte vers 3D et croquis vers 3D pour les workflows de visualisation et de contenu. Variantes V2 Base, Mini et Multi-View, plus les endpoints V3 Image-to-3D, Text-to-3D et Sketch-to-3D. Vous pouvez l’appeler par programmation ou l’essayer depuis le playground indiqué ci-dessus.
Comment appeler l’API Hunyuan3D ?
Créez un compte WaveSpeedAI, copiez votre clé API depuis /accesskey, puis envoyez votre entrée en JSON par POST à https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base. Le point d’accès renvoie un identifiant de prédiction. Interrogez le point d’accès de résultat environ toutes les 2 secondes, augmentez l’intervalle pour les tâches longues et arrêtez-vous à tout statut final. Des exemples Python / Node.js / cURL orientés production figurent ci-dessus.
Combien coûte l’API Hunyuan3D ?
Hunyuan3D démarre à $0.12 par exécution. Le coût exact dépend des paramètres définis (résolution, durée, nombre de résultats, références). L’estimation en direct à côté du bouton Générer dans le playground affiche le prix exact pour votre saisie actuelle.
Quelles variantes de Hunyuan3D sont disponibles ?
WaveSpeedAI héberge 7 points d’accès Hunyuan3D actifs : 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. Chaque variante a sa propre page playground et ses propres tarifs.
Puis-je utiliser commercialement les résultats de Hunyuan3D ?
Les droits d’usage commercial suivent la licence du modèle Tencent. La plupart des modèles Tencent autorisent l’usage commercial des résultats ; consultez la page playground de chaque modèle pour le résumé de sa licence, et les Conditions d’utilisation de WaveSpeedAI pour les conditions au niveau de la plateforme.
Pourquoi utiliser Hunyuan3D sur WaveSpeedAI plutôt qu’en direct ?
Une seule clé API et un seul compte de facturation pour Hunyuan3D ET plus de 1 000 autres modèles IA d’autres fournisseurs. Pas de configuration de SDK par fournisseur, pas de limites de débit distinctes, pas de code d’intégration à réécrire pour chaque fournisseur. Les tarifs sont généralement au niveau de l’API directe de Tencent, ou en dessous.
Fournisseur
À propos de Tencent
L’équipe derrière Hunyuan3D et la gamme plus large de modèles Tencent sur WaveSpeedAI.
L'équipe Hunyuan de Tencent produit Hunyuan3D, une famille de modèles image vers 3D qui convertissent des photos en maillages 3D pour la visualisation, les assets de jeu et l'e-commerce. Les variantes couvrent la génération à partir d'une seule image, l'inférence légère Mini, la reconstruction multi-vues et le système évolutif de création d'assets v2.1.
Commencez à créer avec Hunyuan3D sur WaveSpeedAI
Crédits de démarrage gratuits à l’inscription. Une seule clé API pour plus de 1 000 modèles IA de Tencent et de tous les autres fournisseurs.