Hunyuan3D-2

קוד פתוח

tencentother2025-01-20

hunyuan3d-2
diffusers
safetensors
image-to-3d
text-to-3d

הופך תמונות דו־ממדיות למודלים תלת־ממדיים עם טקסטורה ברזולוציה גבוהה. מיועד למי שצריך נכסי תלת־ממד מפורטים ומחפש מודל פתוח שעוקף תוצאות קודמות במדדי איכות תמונה והתאמה למקור.

69.7 GBמשקל הקבצים
98,349הורדות בחודש
1,812לייקים

מה זה

המערכת מפרקת את יצירת התלת־ממד לשני שלבים נפרדים. תחילה, מודל דיפוזיה בשם Hunyuan3D-DiT מייצר את המבנה הגיאומטרי העירום (mesh) מתוך תמונת הקלט. לאחר מכן, מודל שני בשם Hunyuan3D-Paint מלביש עליו טקסטורות צבע מפורטות. ההפרדה הזו מאפשרת להשתמש במודל הטקסטורות גם על גבי מודלים גיאומטריים שיצרתם ידנית בתלת־ממד, ולא רק על כאלה שהמערכת יצרה בעצמה.

במבחני איכות מול מתחרים סגורים ופתוחים, המודל רשם תוצאה של 3.193 במדד CMMD ו־0.809 בציון CLIP, נתונים שמצביעים על שמירה קרובה יותר על מראה תמונת המקור. במדדי FID ו־FID_CLIP הוא קיבל 282.429 ו־49.165 בהתאמה, מספרים נמוכים יותר ממתחריו, מה שמעיד על פחות עיוותים ורמת חדות גבוהה יותר בטקסטורות הסופיות.

מתאים ל

יצירת מודלים ממשחקים מתמונה
מייצר בסיס גיאומטרי עם טקסטורה מפורטת מתמונת קונספט יחידה, לשימוש בתוכנות עריכה תלת־ממדיות.
צביעת מודלים קיימים
שימוש ברכיב ה־Paint בלבד כדי לייצר טקסטורות עשירות ישירות על גבי רשתות תלת־ממד שנוצרו ידנית.
אוטומציה לקטלוגי מוצרים
המרה של צילומי מוצר בודדים לקובצי glb או obj לבחינה במרחב תלת־ממדי.

איפה זה נופל

ההתקנה המקומית מורכבת וכוללת שלבי קומפילציה ידניים של רנדררים דיפרנציאליים, מה שעלול להישבר בקלות על מכונות Windows או סביבות קוד שאינן תואמות בדיוק את התלויות. בנוסף, חבילת המשקלים ענקית, והתהליך הדו־שלבי דורש מעבר של שני מודלים כבדים בזה אחר זה, מה שיוצר זמני יצירה ארוכים פר אובייקט ולא מתאים לשימושי זמן־אמת.

שאלות
נפוצות

איזה קובץ פלט מתקבל בסוף התהליך?

הקוד מחזיר אובייקט מסוג trimesh בתוך פייתון. משם אפשר לשמור אותו ישירות למבנים נפוצים כמו OBJ או GLB שכוללים את פריסת הטקסטורה.

האם אפשר לייצר מודל מטקסט בלבד?

כן, המאגר מאפשר שימוש של טקסט לתלת־ממד, אך צינור העבודה המרכזי שמוצג ומביא את התוצאות המדויקות ביותר מבוסס על תמונת קלט כמקור לגיאומטריה ולטקסטורה.

איך מריצים

כדי להריץ את הצינור המלא תצטרכו להוריד 69.7 גיגה־בייט של משקלים, שמחולקים בין מודל הגיאומטריה, מודל הטקסטורה ומודל delighting. ההרצה דורשת סביבת פייתון ייעודית, התקנה של PyTorch וקימפול של קובצי C וספריות רינדור מותאמות כמו rasterizer ישירות מהמאגר של Tencent.

אם אין לכם כרטיס מסך חזק מאוד עם מספיק זיכרון VRAM להחזיק מודלי דיפוזיה גדולים ברינדור תלת־ממד, לא כדאי להרים את זה מקומית. Tencent מחזיקה דמו חינמי באתר וב־Hugging Face Spaces, ומי שצריך תפוקה מהירה ללא תקורת תחזוקה והידור יחסוך זמן בשימוש בגרסה המאוחסנת.

pip install -U huggingface_hub
hf download tencent/Hunyuan3D-2

הקבצים

82 קבצים במאגר, 69.7 GB סך הכול. הקישורים מובילים ישירות ל־Hugging Face.

הרישיון

הרישיון מוגדר כ־other ואינו רישיון קוד פתוח סטנדרטי כמו MIT או Apache. תנאי השימוש המדויקים, מגבלות מסחריות וזכויות הפצה של התוצרים מוגדרים במאגר של Tencent. לפני שאתם משלבים את המודל או רכיביו במוצר מסחרי, חובה לפתוח את קובץ הרישיון במאגר ולבדוק את ההגבלות המשפטיות.

הרישיון המלא בעמוד המודל ↗