Hunyuan3D 2.0 nedir?

Kısa tanım: Hunyuan3D 2.0(*Hunyuan3D-2*), Tencent tarafından çok kipli girdilerden (metin, 1–4 görsel, eskizler) yüksek çözünürlüklü dokulu 3D varlıklar üretmek için geliştirilen iki aşamalı, büyük ölçekli bir üretici sistemdir. Sistem, şekil üretimini (Hunyuan3D-DiT / ShapeVAE) ve doku sentezini (Hunyuan3D-Paint) birbirinden ayırır; ayrıca bir üretim arayüzü/platformu da sunar (Hunyuan3D-Studio).

Başlıca özellikler

Çok kipli girdiler: Metinden 3D’ye, görselden 3D’ye (1–4 görünüm), eskizden 3D’ye. Global site ve dokümantasyon bu modları açıkça listeler.
İki aşamalı işlem hattı:
1. Şekil üretimi — Hunyuan3D-DiT (ShapeVAE latentleri üzerinde latent diffusion / flow-matching) dokusuz bir mesh üretir.
2. Doku sentezi — Hunyuan3D-Paint, geometriye koşullandırılmış çok görünümlü görseller üretir; çıktılar yüksek çözünürlüklü doku haritalarına bake edilir.
Çıktı biçimleri ve entegrasyon: Yaygın 3D formatlarına (OBJ, GLB) dışa aktarım yapar ve Unity, Unreal, Blender ile standart üretim iş akışlarına entegre olacak şekilde tasarlanmıştır. Kurumsal API, PBR malzeme üretimini ve topoloji seçeneklerini (üçgenler/dörtgenler) destekler.
Üretim özellikleri: Akıllı topoloji (mesh optimizasyonu), low-poly stilizasyon, doku bake etme ve stüdyo içinde animasyon desteği (Hunyuan3D-Studio’da basit retargeting için GNN aracılığıyla iskelet skinning).

Kıyaslama performansı (yayınlanmış metrikler)

Hunyuan3D 2.0 teknik raporu / değerlendirmesinden (makaledeki Tablo 4’ten temsilî metrikler; daha yüksek CLIP-score daha iyidir; daha düşük CMMD / FID metrikleri daha iyidir):

Model	CMMD (↓)	FID_CLIP (↓)	FID_Inception (↓)	CLIP-score (↑)
Trellis (açık kaynaklı temel model)	3.591	54.639	289.287	0.787
Kapalı kaynaklı Model 1	3.600	55.866	305.922	0.779
Kapalı kaynaklı Model 2	3.368	49.744	294.628	0.806
Kapalı kaynaklı Model 3	3.218	51.574	295.691	0.799
Hunyuan3D 2.0 (Bizim)	3.193	49.165	282.429	0.809

Yazarlar, otomatik metriklerde ve Hunyuan3D 2.0’ın görsel kalite ile koşullandırılmış görsele bağlılık açısından karşılaştırmalı yöntemleri geride bıraktığı 300 vakalık bir kullanıcı çalışmasında (50 katılımcı) üstün geometri ayrıntısı, koşul hizalama doğruluğu ve doku haritası kalitesi bildirmektedir.

Temsili üretim kullanım senaryoları

Oyun varlığı üretimi: Aksesuarların, sahne öğelerinin, düşük ve yüksek poligonlu karakter ya da aksesuar mesh’lerinin + bake edilmiş dokuların hızlı prototiplenmesi; Hunyuan3D’nin low-poly stilizasyon modülü + doku bake etme özelliği oyun iş akışlarına entegre olur.
3D e-ticaret / ürün görselleştirme: Ürün fotoğraflarını veya eskizlerini kataloglar için döndürülebilir 3D ürün önizlemelerine dönüştürme.
Yaratıcı araçlar / stüdyolar: Sanatçılar için eskiz→3D iş akışları, otomatik UV/doku bake etme ve görünüm geliştirme için hızlı yineleme.
AR/VR içerikleri ve hızlı prototipleme: Sürükleyici deneyimler için çevre varlıkları veya aksesuarlar üretme, ardından bunları low-poly stilizer ve retargeting/animasyon modülleriyle optimize etme.

Hunyuan3D 2.0 Nasıl Kullanılır

1. Adım: API Anahtarı için Kayıt Olun

cometapi.com’a giriş yapın. Henüz kullanıcımız değilseniz lütfen önce kayıt olun. CometAPI konsolunuzda oturum açın. Arayüzün erişim kimlik bilgisi olan API anahtarını alın. Kişisel merkezde API token bölümünde “Add Token” seçeneğine tıklayın, sk-xxxxx biçimindeki token anahtarını alın ve gönderin.

2. Adım: Hunyuan3D 2.0 API’sine İstek Gönderin

API isteğini göndermek için “"Hunyuan3D-2"” endpoint’ini seçin ve istek gövdesini ayarlayın. İstek yöntemi ve istek gövdesi web sitemizdeki API dokümanında yer almaktadır. Web sitemiz ayrıca sizin kolaylığınız için Apifox testi de sağlar. <YOUR_API_KEY> ifadesini hesabınızdaki gerçek CometAPI anahtarınızla değiştirin. Base URL Hunyuan3D şeklindedir.

İsteğinizi ve görselinizi content alanına ekleyin — modelin yanıt vereceği içerik budur. Oluşturulan yanıtı almak için API yanıtını işleyin.

Hunyuan3D

3. Adım: Sonuçları Alın ve Doğrulayın

Oluşturulan yanıtı almak için API yanıtını işleyin. İşlemeden sonra API, görev durumunu ve çıktı verilerini döndürür.

Hunyuan3D için Fiyatlandırma

Hunyuan3D için çeşitli bütçelere ve kullanım ihtiyaçlarına uygun rekabetçi fiyatlandırmayı keşfedin. Esnek planlarımız sadece kullandığınız kadar ödeme yapmanızı sağlar ve ihtiyaçlarınız büyüdükçe kolayca ölçeklendirme imkanı sunar. Hunyuan3D'in maliyetleri yönetilebilir tutarken projelerinizi nasıl geliştirebileceğini keşfedin.

Comet Fiyatı (USD / M Tokens)	Resmi Fiyat (USD / M Tokens)	İndirim
İstek Başına:$0.08	İstek Başına:$0.1	-20%

Hunyuan3D için örnek kod ve API

Hunyuan3D için kapsamlı örnek kodlara ve API kaynaklarına erişerek entegrasyon sürecinizi kolaylaştırın. Ayrıntılı dokümantasyonumuz adım adım rehberlik sağlayarak projelerinizde Hunyuan3D'in tüm potansiyelinden yararlanmanıza yardımcı olur.

Python
JavaScript
Curl

import os
import requests
import json

# Get your CometAPI key from https://api.cometapi.com/console/token
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/v1"

# Create output/ folder
folder_path = "output"
os.makedirs(folder_path, exist_ok=True)

# Hunyuan3D-2: 3D model generation from image + prompt
response = requests.post(
    f"{BASE_URL}/images/generations",
    headers={
        "Authorization": f"Bearer {COMETAPI_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "model": "Hunyuan3D-2",
        "prompt": "A cute baby sea otter",
        "image": "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2"
    }
)

result = response.json()
print(json.dumps(result, indent=2))

# If the response contains a URL or data, save it
if "data" in result and len(result["data"]) > 0:
    data = result["data"][0]
    if "url" in data:
        print(f"
3D Model URL: {data['url']}")
    if "b64_json" in data:
        import base64
        # Save 3D model data if present
        model_data = base64.b64decode(data["b64_json"])
        output_path = os.path.join(folder_path, "hunyuan3d-2-output.glb")
        with open(output_path, "wb") as f:
            f.write(model_data)
        print(f"
3D Model saved to: {output_path}")

Python Code Example

import os
import requests
import json

# Get your CometAPI key from https://api.cometapi.com/console/token
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/v1"

# Create output/ folder
folder_path = "output"
os.makedirs(folder_path, exist_ok=True)

# Hunyuan3D-2: 3D model generation from image + prompt
response = requests.post(
    f"{BASE_URL}/images/generations",
    headers={
        "Authorization": f"Bearer {COMETAPI_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "model": "Hunyuan3D-2",
        "prompt": "A cute baby sea otter",
        "image": "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2"
    }
)

result = response.json()
print(json.dumps(result, indent=2))

# If the response contains a URL or data, save it
if "data" in result and len(result["data"]) > 0:
    data = result["data"][0]
    if "url" in data:
        print(f"\n3D Model URL: {data['url']}")
    if "b64_json" in data:
        import base64
        # Save 3D model data if present
        model_data = base64.b64decode(data["b64_json"])
        output_path = os.path.join(folder_path, "hunyuan3d-2-output.glb")
        with open(output_path, "wb") as f:
            f.write(model_data)
        print(f"\n3D Model saved to: {output_path}")

JavaScript Code Example

import fs from "fs";
import path from "path";
import { fileURLToPath } from "url";

const __dirname = path.dirname(fileURLToPath(import.meta.url));

// Get your CometAPI key from https://api.cometapi.com/console/token
const COMETAPI_KEY = process.env.COMETAPI_KEY || "<YOUR_COMETAPI_KEY>";
const BASE_URL = "https://api.cometapi.com/v1";

// Create output/ folder
const folderPath = path.join(__dirname, "../output");
if (!fs.existsSync(folderPath)) {
  fs.mkdirSync(folderPath, { recursive: true });
}

// Hunyuan3D-2: 3D model generation from image + prompt
async function generateModel() {
  const response = await fetch(`${BASE_URL}/images/generations`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "Hunyuan3D-2",
      prompt: "A cute baby sea otter",
      image:
        "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2",
    }),
  });

  const result = await response.json();
  console.log(JSON.stringify(result, null, 2));

  // If the response contains a URL or data, save it
  if (result.data && result.data.length > 0) {
    const data = result.data[0];
    if (data.url) {
      console.log(`\n3D Model URL: ${data.url}`);
    }
    if (data.b64_json) {
      // Save 3D model data if present
      const modelData = Buffer.from(data.b64_json, "base64");
      const outputPath = path.join(folderPath, "hunyuan3d-2-output.glb");
      fs.writeFileSync(outputPath, modelData);
      console.log(`\n3D Model saved to: ${outputPath}`);
    }
  }
}

generateModel().catch(console.error);

Curl Code Example

#!/bin/bash

# Get your CometAPI key from https://api.cometapi.com/console/token
COMETAPI_KEY="${COMETAPI_KEY:-<YOUR_COMETAPI_KEY>}"

# Create output/ folder
mkdir -p output

# Hunyuan3D-2: 3D model generation from image + prompt
curl --location --request POST 'https://api.cometapi.com/v1/images/generations' \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "Hunyuan3D-2",
    "prompt": "A cute baby sea otter",
    "image": "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2"
}'