Hunyuan3D API
Tencent Hunyuan3D — görselleştirme ve içerik iş akışları için görselden 3D, metinden 3D ve eskizden 3D üretimi. V2 Base, Mini ve Multi-View varyantları ile V3 Image-to-3D, Text-to-3D ve Sketch-to-3D uç noktaları.
V2: tek görselli 3D için v2-base ve v2-mini; birden çok görselden yeniden yapılandırma için v2-multi-view; ölçeklenebilir varlık oluşturma için v2.1. V3: image-to-3d (fotoğraflardan ultra yüksek çözünürlük), text-to-3d (istemlerden tam dokulu modeller) ve sketch-to-3d (konsept çizimden mesh'e).
Genel Bakış
Hunyuan3D API Hakkında
Hunyuan3D ne yapar, Tencent model yelpazesindeki yeri nedir ve ekipler neden onu tercih eder.
Hunyuan3D, Tencent tarafından geliştirilen bir 3D varlık üretimi modelidir ve WaveSpeedAI REST API'si üzerinden kullanılabilir. Tencent Hunyuan3D — görselleştirme ve içerik iş akışları için görselden 3D, metinden 3D ve eskizden 3D üretimi. V2 Base, Mini ve Multi-View varyantları ile V3 Image-to-3D, Text-to-3D ve Sketch-to-3D uç noktaları.
V2: tek görselli 3D için v2-base ve v2-mini; birden çok görselden yeniden yapılandırma için v2-multi-view; ölçeklenebilir varlık oluşturma için v2.1. V3: image-to-3d (fotoğraflardan ultra yüksek çözünürlük), text-to-3d (istemlerden tam dokulu modeller) ve sketch-to-3d (konsept çizimden mesh'e).
WaveSpeedAI'daki Hunyuan3D ailesi, Image-To-3d, Text-To-3d iş akışını kapsayan 7 REST uç noktası sunar. Her varyantın kendi fiyatı, parametre seçenekleri ve örnek çıktıları vardır — girdi türünüze ve üretim gereksinimlerinize uyanı seçin ya da çok adımlı işlem hatları kurmak için aynı API anahtarıyla birkaçını birlikte çağırın.
Hunyuan3D modelini, WaveSpeedAI'daki diğer 1.000+ AI modeli için kullandığınız aynı API anahtarı, faturalandırma hesabı ve hız sınırı çerçevesi üzerinden çalıştırın. Ayrı bir sağlayıcı kurulumu, sağlayıcıya özel SDK'lar veya sağlayıcıya özel hız sınırları yok — tek bir entegrasyon, metinden görsele ve metinden videoya, ses sentezi, 3D üretimi, büyütme ve düzenlemeye kadar her şeyi kapsar.
Uç Noktalar
Tüm Hunyuan3D API uç noktaları
WaveSpeedAI'da şu anda 7 Hunyuan3D uç noktası kullanılabilir — iş akışınıza uyan varyantı seçin.
/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.
Örnekler
Hunyuan3D iş başında
Hunyuan3D API'siyle üretilmiş gerçek çıktılar. Önizlemek için bir videonun üzerine gelin, tam boyutlu görüntüleyiciyi açmak için tıklayın.
Nasıl Kullanılır
Hunyuan3D API'si nasıl kullanılır
Kayıttan tamamlanmış bir üretime dört adım. Python, Node.js ve cURL örneklerinin tamamı aşağıdaki API bölümünde.
- 01
API anahtarı alın
Bir WaveSpeedAI hesabı oluşturun ve API anahtarınızı kontrol panelinden kopyalayın. Yeni hesaplar ücretsiz başlangıç kredisiyle gelir — faturalandırma başlamadan önce playground'u birkaç düzine kez çalıştırmaya yeter.
- 02
Tahmin gönderin
Girdinizi JSON olarak https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base adresine POST edin. Uç nokta hemen bir tahmin kimliği döndürür — üretimler asenkrondur, bu yüzden çıkarım sırasında açık bir bağlantı tutmanız gerekmez.
- 03
Tamamlanmayı yoklayın
https://api.wavespeed.ai/api/v3/predictions/{request_id}/result adresine GET isteği gönderin. completed durumunda çıktıları alın; failed, cancelled, timeout veya deleted durumunda hata ile durun; diğer tüm durumlarda yoklamaya devam edin.
- 04
Çıktı URL'sini okuyun
Durum "completed" olduğunda URL'yi data.outputs[0] alanından okuyun. URL, WaveSpeedAI CDN'indeki üretilmiş medyanıza işaret eder — çağırdığınız Hunyuan3D varyantına göre görsel, video, ses veya 3D dosyası.
Kullanım Alanları
Hunyuan3D ile neler geliştirebilirsiniz
Geliştiricilerin ve içerik üreticilerin Hunyuan3D API'sini kullandığı yaygın iş akışları.
Tek görselden 3D varlığa
wavespeed-ai/hunyuan3d/v2-base, görselleri görselleştirme ve içerik için 3D varlıklara dönüştüren Tencent'in son teknoloji Image-to-3D modelidir — ürün ve karakter mesh üretimi için varsayılan uç nokta.
Hafif Mini varyantı
wavespeed-ai/hunyuan3d/v2-mini, Tencent'in kompakt görselden 3D üretken modelidir — hızlı iterasyon, mobil önizlemeler ve mesh detayının aşağı akışta iyileştirilebileceği iş hatları için kullanışlıdır.
Çok görünümlü yeniden yapılandırma
wavespeed-ai/hunyuan3d/v2-multi-view, birden çok görselden doğru 3D yeniden yapılandırmalar üretir — gizli yüzeylerde daha güçlü geometri için ön, yan ve arka görünümleri verin.
v2.1 ölçeklenebilir varlık oluşturma
wavespeed-ai/hunyuan3d/v2.1, son teknoloji 3D üretimi ilerleten Tencent'in ölçeklenebilir 3D varlık oluşturma sistemidir — daha yüksek doğruluk gerektiren üretim varlığı iş akışları için varyant.
İstemlerden V3 metinden 3D'ye
wavespeed-ai/hunyuan3d-v3/text-to-3d, metin istemlerini ayrıntılı, tam dokulu 3D modellere dönüştürür — kaynak görsel olmadan tariflerden varlıklar üretin.
Konsept çizim için V3 eskizden 3D'ye
wavespeed-ai/hunyuan3d-v3/sketch-to-3d, elle çizilmiş eskizleri ve konsept çizimleri ayrıntılı 3D modellere dönüştürür — erken aşama tasarım keşfi için kullanışlıdır.
İpuçları
Hunyuan3D için istem yazma ipuçları
Hunyuan3D ile daha iyi çıktı almak için pratik öneriler — üretim hatlarında 3D modelleri genelinde işe yarayan yöntemlerden derlendi.
- 01
Gizli geometri için çok görünüm
Ön, yan ve arka fotoğraflarınız varsa v2-multi-view kullanın — tek görselli Base/Mini gizli yüzeyleri tahmin eder; multi-view bunları doğru biçimde yeniden yapılandırır.
- 02
Hızlı iterasyon için Mini
Konsept keşfi sırasında hızlı önizleme mesh'leri için v2-mini; geometri yönü kilitlendiğinde v2-base veya v2.1'e geçin.
- 03
Temiz, iyi aydınlatılmış kaynak görseller
Görselden 3D kalitesi, kaynak fotoğraf kalitesiyle sınırlıdır. Eşit ışık, minimum gölge ve net bir özne silueti daha temiz mesh'ler üretir.
- 04
PBR beklentilerini aşağı akışta belirleyin
Hunyuan3D görselleştirme için mesh'ler üretir — dokulandırma ve PBR malzeme geçişinizi, üretimden sonra DCC aracınızda veya render motorunuzda planlayın.
- 05
Nötr arka planlarda ürün fotoğrafları
Beyaz/nötr arka planlı e-ticaret ürün çekimleri en temiz geometri çıkarımını verir — kalabalık arka planlar yeniden yapılandırılan mesh'e gürültü ekler.
Fiyatlandırma
Hunyuan3D API fiyatlandırması
Fiyatlandırma çıktı başınadır. Nihai ücret, her varyantın playground'unda belirlediğiniz parametrelere (çözünürlük, süre, çıktı sayısı, referanslar) göre değişir.
| Uç Nokta | Tür | Başlangıç fiyatı |
|---|---|---|
| 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
Hunyuan3D API'sini çağırın
wavespeed.ai/accesskey adresinden bir API anahtarı alın, ardından REST ile bir tahmin gönderin. Playground, girdilerin her kombinasyonu için yapıştırmaya hazır örnekler üretir.
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)Karşılaştır
Hunyuan3D ve alternatifleri
WaveSpeedAI'daki benzer modeller yerine ne zaman Hunyuan3D seçmeli.
Hunyuan3D ve Tripo3D
Tripo3D, doku pişirmeli hızlı görselden 3D sunar. Hunyuan3D, Tencent'in araştırma yığınından birden çok kalite katmanını (Base, Mini, Multi-View, v2.1) kapsar — girdi türüne (tek veya çok görünümlü) ve doğruluk ihtiyaçlarına göre seçin.
Hunyuan3D ve Meshy
Meshy web öncelikli bir 3D üretim aracıdır. Hunyuan3D, WaveSpeedAI'da API öncelikli — manuel bir arayüz adımı olmadan otomatik iş hatları, toplu varlık üretimi ve SaaS entegrasyonu için daha iyi.
Hunyuan3D ve Manual photogrammetry
Fotogrametri onlarca fotoğraf ve uzun işleme süreleri gerektirir. Hunyuan3D, bir veya birkaç görselden saniyeler içinde kullanılabilir bir mesh üretir — prototipleme için daha hızlı, tarama düzeyinde yeniden yapılandırma için daha az doğru.
SSS
Hunyuan3D API — Sıkça sorulan sorular
Fiyatlandırma, lisans, entegrasyon — Hunyuan3D modelini WaveSpeedAI'da çalıştırmaya dair sık sorulan sorular.
Hunyuan3D API'si nedir?
Hunyuan3D, WaveSpeedAI'da REST API olarak sunulan, Tencent tarafından geliştirilmiş bir 3D modelidir. Tencent Hunyuan3D — görselleştirme ve içerik iş akışları için görselden 3D, metinden 3D ve eskizden 3D üretimi. V2 Base, Mini ve Multi-View varyantları ile V3 Image-to-3D, Text-to-3D ve Sketch-to-3D uç noktaları. Onu programatik olarak çağırabilir veya yukarıda bağlantısı verilen playground'dan deneyebilirsiniz.
Hunyuan3D API'sini nasıl çağırırım?
Bir WaveSpeedAI hesabı oluşturun, API anahtarınızı /accesskey sayfasından kopyalayın, ardından girdinizi JSON olarak https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base adresine POST edin. Uç nokta bir tahmin kimliği döndürür. Sonuç uç noktasını yaklaşık 2 saniyede bir yoklayın, uzun süren görevlerde aralığı artırın ve herhangi bir son durumda durun. Üretime yönelik Python / Node.js / cURL örnekleri yukarıda.
Hunyuan3D API'sinin maliyeti nedir?
Hunyuan3D çalıştırma başına $0.12'dan başlar. Kesin maliyet, belirlediğiniz parametrelere (çözünürlük, süre, çıktı sayısı, referanslar) göre değişir. Playground'da Üret düğmesinin yanındaki canlı maliyet önizlemesi, mevcut girdiniz için kesin fiyatı gösterir.
Hangi Hunyuan3D varyantları mevcut?
WaveSpeedAI, 7 canlı Hunyuan3D uç noktası barındırır: 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. Her varyantın kendi playground sayfası ve fiyatı vardır.
Hunyuan3D çıktılarını ticari amaçla kullanabilir miyim?
Ticari kullanım hakları Tencent model lisansına tabidir. Çoğu Tencent modeli çıktıların ticari kullanımına izin verir; lisans özeti için her modelin playground sayfasına, platform düzeyindeki koşullar için WaveSpeedAI Hizmet Koşulları'na bakın.
Hunyuan3D modelini neden doğrudan kullanmak yerine WaveSpeedAI'da kullanmalıyım?
Hunyuan3D ve diğer sağlayıcıların 1.000+ AI modeli için tek bir API anahtarı ve tek bir faturalandırma hesabı. Sağlayıcıya özel SDK kurulumu yok, ayrı hız sınırı çerçeveleri yok, her sağlayıcı için entegrasyon kodunu yeniden yazmak yok. Fiyatlar genellikle Tencent'ın doğrudan API'siyle aynı düzeyde veya daha düşüktür.
Sağlayıcı
Tencent Hakkında
WaveSpeedAI'daki Hunyuan3D ve daha geniş Tencent model yelpazesinin arkasındaki ekip.
Tencent'in Hunyuan ekibi, fotoğrafları görselleştirme, oyun varlıkları ve e-ticaret için 3D mesh'lere dönüştüren bir görselden 3D modeller ailesi olan Hunyuan3D'yi üretir. Varyantlar tek görselli üretimi, hafif Mini çıkarımı, çok görünümlü yeniden yapılandırmayı ve v2.1 ölçeklenebilir varlık oluşturma sistemini kapsar.
WaveSpeedAI'da Hunyuan3D ile geliştirmeye başlayın
Kayıt olunca ücretsiz başlangıç kredisi. Tencent ve diğer tüm sağlayıcılardan 1.000+ AI modeli için tek API anahtarı.