Hunyuan3D 2.0 کیا ہے ؟

مختصر تعریف: Hunyuan3D 2.0(*Hunyuan3D-2*) Tencent کا ایک دو مرحلوں پر مشتمل، بڑے پیمانے کا جنریٹو نظام ہے جو ملٹی موڈل اِن پٹس (متن، 1–4 تصاویر، اسکیچز) سے ہائی ریزولوشن ٹیکسچرڈ 3D اثاثے تیار کرتا ہے۔ یہ نظام شکل سازی (Hunyuan3D-DiT / ShapeVAE) اور ٹیکسچر سنتھیسِس (Hunyuan3D-Paint) کو الگ رکھتا ہے، اور ایک پروڈکشن UI/پلیٹ فارم (Hunyuan3D-Studio) بھی فراہم کرتا ہے۔

اہم خصوصیات

ملٹی موڈل اِن پٹس: ٹیکسٹ-ٹو-3D، امیج-ٹو-3D (1–4 ویوز)، اسکیچ-ٹو-3D۔ گلوبل سائٹ اور دستاویزات میں یہ موڈز واضح طور پر درج ہیں۔
دو مراحل پر مشتمل پائپ لائن:
1. شکل سازی — Hunyuan3D-DiT (لیٹنٹ ڈیفیوشن / فلو-میچنگ، ShapeVAE لیٹنٹس پر) ایک بغیر ٹیکسچر والا میش تیار کرتا ہے۔
2. ٹیکسچر سنتھیسِس — Hunyuan3D-Paint جیومیٹری پر کنڈیشنڈ ملٹی ویو تصاویر بناتا ہے؛ آؤٹ پٹس کو ہائی ریزولوشن ٹیکسچر میپس میں بیک کر دیا جاتا ہے۔
آؤٹ پٹ فارمیٹس اور انضمام: عام 3D فارمیٹس (OBJ, GLB) ایکسپورٹ کرتا ہے اور Unity، Unreal، Blender اور معیاری پروڈکشن پائپ لائنز کے ساتھ انضمام کے لیے ڈیزائن کیا گیا ہے۔ انٹرپرائز API، PBR میٹیریل جنریشن اور ٹوپولوجی آپشنز (triangles/quads) کو سپورٹ کرتا ہے۔
پروڈکشن فیچرز: سمارٹ ٹوپولوجی (میش آپٹیمائزیشن)، لو-پولی اسٹائلیزیشن، ٹیکسچر بیکنگ، اور اسٹوڈیو کے اندر اینیمیشن سپورٹ (Hunyuan3D-Studio میں سادہ ری ٹارگٹنگ کے لیے GNN کے ذریعے اسکلِیٹل سکننگ)۔

بینچ مارک کارکردگی (شائع شدہ میٹرکس)

Hunyuan3D 2.0 کی تکنیکی رپورٹ/تجزیے سے (پیپر ٹیبل 4 کی نمائندہ میٹرکس؛ زیادہ CLIP-score بہتر ہے؛ کم CMMD / FID میٹرکس بہتر ہیں):

ماڈل	CMMD (↓)	FID_CLIP (↓)	FID_Inception (↓)	CLIP-score (↑)
Trellis (اوپن سورس بیس لائن)	3.591	54.639	289.287	0.787
کلوزڈ سورس ماڈل 1	3.600	55.866	305.922	0.779
کلوزڈ سورس ماڈل 2	3.368	49.744	294.628	0.806
کلوزڈ سورس ماڈل 3	3.218	51.574	295.691	0.799
Hunyuan3D 2.0 (ہمارا)	3.193	49.165	282.429	0.809

مصنفین خودکار میٹرکس اور 300 کیسز (50 شرکاء) پر مشتمل یوزر اسٹڈی میں بہتر جیومیٹری تفصیل، کنڈیشن الائنمنٹ کی درستگی اور ٹیکسچر میپ کے معیار کی رپورٹ کرتے ہیں، جہاں Hunyuan3D 2.0 نے بصری معیار اور کنڈیشنل امیج سے مطابقت کے لحاظ سے تقابلی طریقوں سے بہتر کارکردگی دکھائی۔

نمایندہ پروڈکشن استعمال کے کیسز

گیم اثاثہ جات کی تیاری: پروپس، سیٹ پیسز، لو اور ہائی پولی کردار یا پروپ میشز کے تیز پروٹو ٹائپنگ کے ساتھ بیکڈ ٹیکسچرز؛ Hunyuan3D کا لو-پولی اسٹائلیزیشن ماڈیول اور ٹیکسچر بیکنگ گیم پائپ لائنز میں ضم ہو جاتے ہیں۔
3D ای کامرس/پروڈکٹ ویژولائزیشن: پروڈکٹ فوٹوز یا اسکیچز کو کیٹلاگ کے لیے گھمایا جا سکنے والے 3D پروڈکٹ پری ویوز میں تبدیل کریں۔
تخلیقی ٹولز/اسٹوڈیوز: اسکیچ→3D ورک فلو، خودکار UV/ٹیکسچر بیکنگ، اور لُک ڈیولپمنٹ کے لیے تیز iteration۔
AR/VR مواد اور تیز پروٹو ٹائپنگ: ڈوبنے والے تجربات کے لیے ماحول کے اثاثے یا پروپس تیار کریں، پھر لو-پولی اسٹائলাইزر اور ری ٹارگٹنگ/اینیمیشن ماڈیولز کے ذریعے آپٹیمائز کریں۔

Hunyuan3D 2.0 کو کیسے استعمال کریں

مرحلہ 1: API کلید کے لیے سائن اپ کریں

cometapi.com میں لاگ اِن کریں۔ اگر آپ ابھی تک ہمارے صارف نہیں ہیں، تو براہِ کرم پہلے رجسٹر کریں۔ اپنے CometAPI کنسول میں سائن اِن کریں۔ انٹرفیس کی رسائی اسناد کی API کلید حاصل کریں۔ پرسنل سینٹر میں API ٹوکن پر “Add Token” پر کلک کریں، ٹوکن کی: sk-xxxxx حاصل کریں اور جمع کرائیں۔

مرحلہ 2: Hunyuan3D 2.0 API کو درخواستیں بھیجیں

“"Hunyuan3D-2"” اینڈ پوائنٹ منتخب کریں تاکہ API ریکویسٹ بھیجیں اور ریکویسٹ باڈی سیٹ کریں۔ ریکویسٹ میتھڈ اور ریکویسٹ باڈی ہماری ویب سائٹ کی API ڈاک سے حاصل کیے جاتے ہیں۔ ہماری ویب سائٹ آپ کی سہولت کے لیے Apifox ٹیسٹ بھی فراہم کرتی ہے۔ <YOUR_API_KEY> کو اپنے اکاؤنٹ کی اصل CometAPI کلید سے تبدیل کریں۔ base url is Hunyuan3D

اپنی درخواست اور تصویر کو content فیلڈ میں داخل کریں — ماڈل اسی پر جواب دے گا۔ API ریسپانس کو پراسیس کریں تاکہ تیار شدہ جواب حاصل ہو سکے۔

Hunyuan3D

مرحلہ 3: نتائج حاصل کریں اور تصدیق کریں

تیار شدہ جواب حاصل کرنے کے لیے API ریسپانس کو پراسیس کریں۔ پراسیسنگ کے بعد، API ٹاسک اسٹیٹس اور آؤٹ پٹ ڈیٹا کے ساتھ جواب دیتی ہے۔

Hunyuan3D کی قیمتیں

[ماڈل کا نام] کے لیے مسابقتی قیمتوں کو دریافت کریں، جو مختلف بجٹ اور استعمال کی ضروریات کے مطابق ڈیزائن کیا گیا ہے۔ ہمارے لچکدار منصوبے اس بات کو یقینی بناتے ہیں کہ آپ صرف اسی کے لیے ادائیگی کریں جو آپ استعمال کرتے ہیں، جس سے آپ کی ضروریات بڑھنے کے ساتھ ساتھ اسکیل کرنا آسان ہو جاتا ہے۔ دریافت کریں کہ [ماڈل کا نام] کیسے آپ کے پروجیکٹس کو بہتر بنا سکتا ہے جبکہ اخراجات کو قابو میں رکھتا ہے۔

Comet قیمت (USD / M Tokens)	سرکاری قیمت (USD / M Tokens)	رعایت
فی درخواست:$0.08	فی درخواست:$0.1	-20%

Hunyuan3D کے لیے نمونہ کوڈ اور API

Hunyuan3D کے لیے جامع نمونہ کوڈ اور API وسائل تک رسائی حاصل کریں تاکہ آپ کے انضمام کے عمل کو آسان بنایا جا سکے۔ ہماری تفصیلی دستاویزات قدم بہ قدم رہنمائی فراہم کرتی ہیں، جو آپ کو اپنے پروجیکٹس میں Hunyuan3D کی مکمل صلاحیت سے فائدہ اٹھانے میں مدد کرتی ہیں۔

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"
}'