Hunyuan3D API
Tencent Hunyuan3D — generowanie obraz na 3D, tekst na 3D i szkic na 3D do workflow wizualizacji i treści. Warianty V2 Base, Mini i Multi-View oraz endpointy V3 Image-to-3D, Text-to-3D i Sketch-to-3D.
V2: v2-base i v2-mini dla 3D z jednego obrazu; v2-multi-view do rekonstrukcji z wielu obrazów; v2.1 do skalowalnego tworzenia zasobów. V3: image-to-3d (ultrawysoka rozdzielczość ze zdjęć), text-to-3d (w pełni teksturowane modele z promptów) i sketch-to-3d (od concept artu do siatki).
Przegląd
O modelu Hunyuan3D API
Co robi Hunyuan3D, jakie miejsce zajmuje w linii modeli Tencent i dlaczego zespoły po niego sięgają.
Hunyuan3D to model generowania zasobów 3D od Tencent, dostępny przez REST API WaveSpeedAI. Tencent Hunyuan3D — generowanie obraz na 3D, tekst na 3D i szkic na 3D do workflow wizualizacji i treści. Warianty V2 Base, Mini i Multi-View oraz endpointy V3 Image-to-3D, Text-to-3D i Sketch-to-3D.
V2: v2-base i v2-mini dla 3D z jednego obrazu; v2-multi-view do rekonstrukcji z wielu obrazów; v2.1 do skalowalnego tworzenia zasobów. V3: image-to-3d (ultrawysoka rozdzielczość ze zdjęć), text-to-3d (w pełni teksturowane modele z promptów) i sketch-to-3d (od concept artu do siatki).
Rodzina Hunyuan3D w WaveSpeedAI zawiera 7 endpointów REST obejmujące workflowy: Image-To-3d, Text-To-3d. Każdy wariant ma własny cennik, parametry i przykładowe wyniki — wybierz ten, który pasuje do Twoich danych wejściowych i wymagań produkcyjnych, albo wywołuj kilka z jednego klucza API, aby składać wieloetapowe pipeline'y.
Uruchamiaj Hunyuan3D z tym samym kluczem API, kontem rozliczeniowym i limitami, których używasz dla ponad 1000 innych modeli AI w WaveSpeedAI. Bez osobnej konfiguracji u dostawcy, bez osobnych SDK, bez osobnych limitów — jedna integracja obejmuje wszystko: od tekstu na obraz i tekstu na wideo, przez syntezę dźwięku i generowanie 3D, po upscaling i edycję.
Endpointy
Wszystkie endpointy API Hunyuan3D
7 endpointów Hunyuan3D dostępnych teraz w WaveSpeedAI — wybierz wariant pasujący do Twojego 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.
Przykłady
Hunyuan3D w akcji
Prawdziwe wyniki wygenerowane przez API Hunyuan3D. Najedź na wideo, aby zobaczyć podgląd, kliknij, aby otworzyć pełnowymiarowy podgląd.
Jak zacząć
Jak korzystać z API Hunyuan3D
Cztery kroki od rejestracji do gotowego wyniku. Pełne przykłady w Pythonie, Node.js i cURL znajdziesz w sekcji API poniżej.
- 01
Uzyskaj klucz API
Załóż konto WaveSpeedAI i skopiuj klucz API z panelu. Nowe konta otrzymują darmowe kredyty na start — wystarczy na kilkadziesiąt uruchomień w playground, zanim zaczną się opłaty.
- 02
Wyślij predykcję
Wyślij dane wejściowe jako JSON metodą POST na https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base. Endpoint od razu zwraca identyfikator predykcji — generowanie jest asynchroniczne, więc nie trzymasz otwartego połączenia na czas inferencji.
- 03
Sprawdzaj ukończenie
Wywołaj GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Przy statusie completed odbierz wyniki; przy failed, cancelled, timeout lub deleted zakończ z błędem; przy każdym innym statusie odpytuj dalej.
- 04
Odczytaj adres wyniku
Gdy status to "completed", odczytaj adres URL z data.outputs[0]. Wskazuje on wygenerowane media w CDN WaveSpeedAI — obraz, wideo, dźwięk lub plik 3D, zależnie od wywołanego wariantu Hunyuan3D.
Zastosowania
Co możesz zbudować z Hunyuan3D
Typowe workflowy, do których deweloperzy i twórcy używają API Hunyuan3D.
Zasób 3D z pojedynczego obrazu
wavespeed-ai/hunyuan3d/v2-base to najnowocześniejszy model Image-to-3D od Tencent, który zamienia obrazy w zasoby 3D do wizualizacji i treści — domyślny endpoint do generowania siatek produktów i postaci.
Lekki wariant Mini
wavespeed-ai/hunyuan3d/v2-mini to kompaktowy generatywny model obraz na 3D od Tencent — przydatny do szybkiej iteracji, podglądów mobilnych i potoków, w których detal siatki można dopracować w dalszych etapach.
Rekonstrukcja z wielu widoków
wavespeed-ai/hunyuan3d/v2-multi-view generuje dokładne rekonstrukcje 3D z wielu obrazów — podaj widoki z przodu, z boku i z tyłu, aby uzyskać lepszą geometrię zasłoniętych powierzchni.
v2.1 do skalowalnego tworzenia zasobów
wavespeed-ai/hunyuan3d/v2.1 to skalowalny system tworzenia zasobów 3D od Tencent, który przesuwa granice generowania 3D — wariant do produkcyjnych workflow zasobów wymagających wyższej wierności.
V3 tekst na 3D z promptów
wavespeed-ai/hunyuan3d-v3/text-to-3d zamienia prompty tekstowe w szczegółowe, w pełni teksturowane modele 3D — generuj zasoby z opisów bez obrazu źródłowego.
V3 szkic na 3D dla concept artu
wavespeed-ai/hunyuan3d-v3/sketch-to-3d zamienia ręcznie rysowane szkice i concept art w szczegółowe modele 3D — przydatne we wczesnej fazie eksploracji projektu.
Wskazówki
Wskazówki do promptów dla Hunyuan3D
Praktyczne rady, jak uzyskiwać lepsze wyniki z Hunyuan3D — oparte na wzorcach, które sprawdzają się w produkcyjnych pipeline'ach dla modeli 3D.
- 01
Multi-view dla zasłoniętej geometrii
Gdy masz zdjęcia z przodu, z boku i z tyłu, użyj v2-multi-view — jednoobrazowe Base/Mini zgadują zasłonięte powierzchnie; multi-view rekonstruuje je dokładnie.
- 02
Mini do szybkiej iteracji
v2-mini do szybkich siatek podglądowych podczas eksploracji koncepcji; przełącz się na v2-base lub v2.1, gdy kierunek geometrii jest ustalony.
- 03
Czyste, dobrze oświetlone obrazy źródłowe
Jakość obraz na 3D jest ograniczona jakością zdjęcia źródłowego. Równomierne oświetlenie, minimalne cienie i wyraźna sylwetka bohatera dają czystsze siatki.
- 04
Określ oczekiwania PBR na dalszym etapie
Hunyuan3D zwraca siatki do wizualizacji — zaplanuj teksturowanie i przebieg materiałów PBR w swoim narzędziu DCC lub silniku renderującym po wygenerowaniu.
- 05
Zdjęcia produktów na neutralnych tłach
Zdjęcia produktowe e-commerce na białym/neutralnym tle dają najczystsze wyodrębnienie geometrii — zagracone tła dodają szum do zrekonstruowanej siatki.
Cennik
Cennik API Hunyuan3D
Cena jest naliczana za wynik. Końcowa opłata zależy od parametrów ustawionych w playground każdego wariantu (rozdzielczość, czas trwania, liczba wyników, referencje).
| Endpoint | Typ | Cena początkowa |
|---|---|---|
| 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
Wywołaj API Hunyuan3D
Uzyskaj klucz API na wavespeed.ai/accesskey, a następnie wyślij predykcję przez REST. Playground generuje gotowe do wklejenia przykłady dla dowolnej kombinacji danych wejściowych.
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)Porównanie
Hunyuan3D a alternatywy
Kiedy wybrać Hunyuan3D zamiast podobnych modeli w WaveSpeedAI.
Hunyuan3D a Tripo3D
Tripo3D oferuje szybki obraz na 3D z wypalaniem tekstur. Hunyuan3D obejmuje wiele poziomów jakości (Base, Mini, Multi-View, v2.1) ze stosu badawczego Tencent — wybieraj według typu wejścia (pojedynczy vs wiele widoków) i potrzeb wierności.
Hunyuan3D a Meshy
Meshy to narzędzie do generowania 3D oparte przede wszystkim na wersji webowej. Hunyuan3D jest zorientowany na API w WaveSpeedAI — lepszy dla zautomatyzowanych potoków, masowego generowania zasobów i integracji SaaS bez ręcznego kroku w interfejsie.
Hunyuan3D a Manual photogrammetry
Fotogrametria wymaga dziesiątek zdjęć i długiego przetwarzania. Hunyuan3D generuje użyteczną siatkę z jednego lub kilku obrazów w kilka sekund — szybciej do prototypowania, mniej dokładnie niż rekonstrukcja klasy skanu.
FAQ
Hunyuan3D API — najczęściej zadawane pytania
Cennik, licencja, integracja — typowe pytania o uruchamianie Hunyuan3D w WaveSpeedAI.
Czym jest API Hunyuan3D?
Hunyuan3D to model 3D od Tencent, udostępniony jako REST API w WaveSpeedAI. Tencent Hunyuan3D — generowanie obraz na 3D, tekst na 3D i szkic na 3D do workflow wizualizacji i treści. Warianty V2 Base, Mini i Multi-View oraz endpointy V3 Image-to-3D, Text-to-3D i Sketch-to-3D. Możesz wywoływać go programowo lub wypróbować w playground, do którego prowadzi link powyżej.
Jak wywołać API Hunyuan3D?
Załóż konto WaveSpeedAI, skopiuj klucz API z /accesskey, a następnie wyślij POST na https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base z danymi wejściowymi w JSON. Endpoint zwraca identyfikator predykcji. Odpytuj endpoint wyniku mniej więcej co 2 sekundy, wydłużaj odstęp przy długich zadaniach i zatrzymaj się przy dowolnym statusie końcowym. Produkcyjne przykłady w Pythonie / Node.js / cURL znajdziesz powyżej.
Ile kosztuje API Hunyuan3D?
Hunyuan3D zaczyna się od $0.12 za uruchomienie. Dokładny koszt zależy od ustawionych parametrów (rozdzielczość, czas trwania, liczba wyników, referencje). Podgląd kosztu na żywo obok przycisku Generuj w playground pokazuje dokładną cenę dla bieżących danych.
Jakie warianty Hunyuan3D są dostępne?
WaveSpeedAI udostępnia 7 aktywnych endpointów Hunyuan3D: 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. Każdy wariant ma własną stronę playground i cennik.
Czy mogę używać wyników Hunyuan3D komercyjnie?
Prawa do komercyjnego użycia wynikają z licencji modelu Tencent. Większość modeli Tencent zezwala na komercyjne wykorzystanie wyników; skrót licencji znajdziesz na stronie playground każdego modelu, a warunki na poziomie platformy w Warunkach świadczenia usług WaveSpeedAI.
Dlaczego korzystać z Hunyuan3D w WaveSpeedAI zamiast bezpośrednio?
Jeden klucz API i jedno konto rozliczeniowe dla Hunyuan3D ORAZ ponad 1000 innych modeli AI od innych dostawców. Bez osobnej konfiguracji SDK, bez osobnych limitów, bez przepisywania kodu integracji pod każdego dostawcę. Ceny są zazwyczaj na poziomie bezpośredniego API Tencent lub niższe.
Dostawca
O Tencent
Zespół stojący za Hunyuan3D i szerszą linią modeli Tencent w WaveSpeedAI.
Zespół Hunyuan z Tencent tworzy Hunyuan3D, rodzinę modeli obraz na 3D, które zamieniają zdjęcia w siatki 3D do wizualizacji, zasobów gier i e-commerce. Warianty obejmują generowanie z jednego obrazu, lekką inferencję Mini, rekonstrukcję z wielu widoków oraz skalowalny system tworzenia zasobów v2.1.
Zacznij budować z Hunyuan3D w WaveSpeedAI
Darmowe kredyty na start po rejestracji. Jeden klucz API do ponad 1000 modeli AI od Tencent i wszystkich innych dostawców.