ما هو Hunyuan3D 2.0؟

تعريف قصير: Hunyuan3D 2.0(*Hunyuan3D-2*) هو نظام توليدي واسع النطاق من Tencent مكوّن من مرحلتين لإنتاج أصول ثلاثية الأبعاد عالية الدقة ومزوّدة بخامات انطلاقًا من مدخلات متعددة الأنماط (نص، 1–4 صور، رسومات تخطيطية). يفصل النظام بين توليد الشكل (Hunyuan3D-DiT / ShapeVAE) وتركيب الخامات (Hunyuan3D-Paint)، بالإضافة إلى واجهة/منصة إنتاج (Hunyuan3D-Studio).

الميزات الرئيسية

مدخلات متعددة الأنماط: تحويل النص إلى ثلاثي الأبعاد، وتحويل الصورة إلى ثلاثي الأبعاد (1–4 مشاهد)، وتحويل الرسم التخطيطي إلى ثلاثي الأبعاد. يدرج الموقع العالمي والوثائق هذه الأوضاع صراحة.
مسار عمل من مرحلتين:
1. توليد الشكل — يقوم Hunyuan3D-DiT (انتشار كامن/مطابقة تدفق على كامِنات ShapeVAE) بإنتاج شبكة هندسية أولية.
2. تركيب الخامات — يولّد Hunyuan3D-Paint صورًا متعددة المناظر مشروطة بالهندسة؛ تُخبز المخرجات في خرائط خامات عالية الدقة.
تنسيقات الإخراج والتكامل: يصدّر تنسيقات ثلاثية الأبعاد شائعة (OBJ, GLB) ومصمم للتكامل مع Unity وUnreal وBlender وخطوط الإنتاج القياسية. تدعم Enterprise API توليد مواد PBR وخيارات الطوبولوجيا (مثلثات/رباعيات).
ميزات الإنتاج: طوبولوجيا ذكية (تحسين الشبكات)، تنميط منخفض المضلعات، خبز الخامات، ودعم التحريك داخل الاستوديو (التغليف الهيكلي عبر GNN لإعادة الاستهداف البسيطة في Hunyuan3D-Studio).

أداء المقاييس المعيارية (مقاييس منشورة)

من تقرير/تقييم 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 على الطرق المقارنة في الجودة البصرية والالتزام بالصورة الشرطية.

أمثلة على حالات الاستخدام في الإنتاج

توليد أصول الألعاب: نماذج أولية سريعة للدعائم وقطع المشاهد، وشبكات شخصيات أو دعائم منخفضة/عالية المضلعات مع خامات مخبوزة؛ يتكامل تنميط الـlow-poly وخبز الخامات في Hunyuan3D ضمن خطوط إنتاج الألعاب.
التجارة الإلكترونية ثلاثية الأبعاد/تصوير المنتجات: تحويل صور المنتجات أو الرسومات التخطيطية إلى معاينات منتجات ثلاثية الأبعاد قابلة للدوران للفهارس.
الأدوات الإبداعية/الاستوديوهات: تدفقات عمل من رسم تخطيطي إلى ثلاثي الأبعاد للفنانين، خبز UV/الخامات تلقائي، وتكرار سريع لتطوير المظهر.
محتوى الواقعين المعزز/الافتراضي والنمذجة السريعة: توليد أصول البيئات أو الدعائم للتجارب الغامرة، ثم تحسينها عبر أداة التنميط منخفض المضلعات ووحدات إعادة الاستهداف/التحريك.

كيفية استخدام Hunyuan3D 2.0

الخطوة 1: التسجيل للحصول على مفتاح API

سجّل الدخول إلى cometapi.com. إذا لم تكن مستخدمًا لدينا بعد، فيُرجى التسجيل أولًا. سجّل الدخول إلى CometAPI console. احصل على بيانات اعتماد الوصول لمفتاح واجهة API. انقر “Add Token” عند رمز API في المركز الشخصي، واحصل على مفتاح الرمز: sk-xxxxx ثم أرسله.

الخطوة 2: إرسال طلبات إلى واجهة Hunyuan3D 2.0 API

حدّد واجهة “"Hunyuan3D-2"” لإرسال طلب API واضبط جسم الطلب. تُستقى طريقة الطلب وجسمه من وثائق واجهة API على موقعنا. يوفر موقعنا أيضًا اختبار Apifox لراحتك. استبدل <YOUR_API_KEY> بمفتاح CometAPI الفعلي من حسابك. base url is Hunyuan3D

أدرج طلبك وصورتك في حقل المحتوى — فهذا ما سيردّ عليه النموذج. عالج استجابة واجهة API لتحصل على النتيجة المولَّدة.

Hunyuan3D

الخطوة 3: جلب النتائج والتحقق منها

عالج استجابة واجهة API لتحصل على النتيجة المولَّدة. بعد المعالجة، تستجيب الواجهة بحالة المهمة وبيانات الإخراج.

التسعير لـ Hunyuan3D

استكشف الأسعار التنافسية لـ Hunyuan3D، المصمم ليناسب الميزانيات المختلفة واحتياجات الاستخدام المتنوعة. تضمن خططنا المرنة أن تدفع فقط مقابل ما تستخدمه، مما يجعل من السهل التوسع مع نمو متطلباتك. اكتشف كيف يمكن لـ Hunyuan3D تحسين مشاريعك مع الحفاظ على التكاليف قابلة للإدارة.

سعر كوميت (USD / M Tokens)	السعر الرسمي (USD / M Tokens)	خصم
لكل طلب:$0.08	لكل طلب:$0.1	-20%

نموذج الكود وواجهة برمجة التطبيقات لـ Hunyuan3D

احصل على أكواد نماذجية شاملة وموارد API لـ Hunyuan3D لتبسيط عملية التكامل الخاصة بك. توفر وثائقنا التفصيلية إرشادات خطوة بخطوة، مما يساعدك على الاستفادة من الإمكانات الكاملة لـ 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"
}'