Hunyuan3D-2.1 — הדגמה
קוד פתוחtencentother2025-06-16
הופך תמונה דו ממדית למודל תלת ממדי עם טקסטורה מלאה ישירות בדפדפן. מתאים למפתחי משחקים, מעצבים ויוצרי תלת ממד שצריכים נכסים מהירים בלי למדל מאפס.
- 13.9 GBמשקל הקבצים
- —הורדות בחודש
- 2,223לייקים
מה זה
אתם מעלים תמונה בודדת ומקבלים מודל תלת ממדי גמור. התהליך מחולק לשניים. תחילה נוצרת הצורה הגיאומטרית באמצעות מודל מבוסס DiT בגודל 3.3 מיליארד פרמטרים, ולאחר מכן מודל צביעה נפרד בגודל 2 מיליארד פרמטרים מלביש עליה טקסטורת PBR שכוללת חישובי תאורה, השתקפויות וחומרים.
המערכת מריצה שרשרת שלמה של כלים מאחורי הקלעים, כולל מודלים כמו DINOv2 לחילוץ מאפיינים ורכיבי דיפוזיה נוספים. הדוגמה המובנית במסמכים מציגה המרה מתמונת קלט בודדת לרשת פוליגונים עם שש נקודות מבט ברזולוציה של 512, כשבסוף מתקבל קובץ רשת עם חומרים מלאים.
מתאים ל
- יצירת אובייקטים למשחקים
המרת ציורי קונספט או תמונות חפצים לנכסי תלת ממד ראשוניים עם חומרי תאורה.
- פרוטוטייפינג לעיצוב מוצר
בדיקת נפח ופרופורציות של רעיון חזותי במרחב תלת ממדי ישירות מאיור בודד.
- בסיס לעבודת פיסול
ייצוא רשת מצולעים גולמית כדי להמשיך עידון וליטוש ידני בתוכנות עריכה.
איפה זה נופל
זה לא תחליף לפיסול ידני מורכב. ההדגמה מוגבלת לחומרת ענן שיתופית, ולכן מודל הצביעה עלול לפעול במצב חסכוני או לייצר פגמים בזוויות נסתרות שלא נראו בתמונה המקורית. הטקסטורה מיוצרת ברזולוציה של 512 מתוך שש זוויות, כך שתקריבים חדים מאוד יחשפו מריחות, ומבנים עם גיאומטריה פנימית חלולה לא תמיד נסגרים נכון.
שאלות
נפוצות
האם השימוש בהדגמה בדפדפן עולה כסף?
לא, הגישה לממשק ב־Hugging Face פתוחה בחינם. עם זאת, בגלל שמדובר בחומרה שיתופית מסוג zero-a10g, ייתכנו זמני המתנה ועלייה איטית של השרת.
כמה זמן לוקח לייצר מודל שלם?
התהליך מורכב משני שלבים כבדים של גיאומטריה וטקסטורה. תחת חומרת A10G זה לוקח בדרך כלל בין דקה למספר דקות, תלוי בעומס על השרת.
האם אפשר להריץ את זה על המחשב בבית?
כן, הקוד ומשקלי המודל פתוחים להורדה. תצטרכו מחשב מבוסס לינוקס, ווינדוס או מק, אבל קחו בחשבון שצריך עד 29 גיגה בייט של זיכרון גרפי כדי להריץ את שני המודלים יחד ללא פשרות.
במה האפליקציה בדפדפן שונה מהקוד המלא?
הממשק מספק מעטפת גרפית מהירה שמתאימה לבדיקות בלי לכתוב שורת קוד אחת. בקוד המקומי יש לכם שליטה מלאה בפרמטרים כמו מספר הזוויות, איכות המרקם ומצבי זיכרון נמוך.
איך מריצים
ממשק Gradio פשוט מאוד. גוררים תמונה לחלון הקלט ולוחצים על כפתור ההפעלה. ההדגמה רצה על גבי חומרת zero-a10g, מה שאומר שהשרת מתעורר לפי דרישה. יצירת צורה וטקסטורה דורשת כוח עיבוד עצום של עד 29 גיגה בייט זיכרון גרפי, כך שעל כרטיס A10 יחיד תצטרכו להמתין בסבלנות בזמן שהמודל מעבד כל שלב, או להמתין בתור אם משתמשים נוספים מריצים שאילתות במקביל.
pip install -U huggingface_hub hf download tencent/Hunyuan3D-2.1
הקבצים
30 קבצים במאגר, 13.9 GB סך הכול. הקישורים מובילים ישירות ל־Hugging Face.
- hunyuan3d-dit-v2-1/model.fp16.ckpt7.4 GB
- hunyuan3d-paintpbr-v2-1/unet/diffusion_pytorch_model.bin3.9 GB
- hunyuan3d-paintpbr-v2-1/text_encoder/pytorch_model.bin1.4 GB
- hunyuan3d-paintpbr-v2-1/image_encoder/model.safetensors1.3 GB
- hunyuan3d-vae-v2-1/model.fp16.ckpt655.6 MB
- hunyuan3d-paintpbr-v2-1/vae/diffusion_pytorch_model.bin334.7 MB
- hunyuan3d-paintpbr-v2-1/tokenizer/vocab.json1.1 MB
- hunyuan3d-paintpbr-v2-1/tokenizer/merges.txt524.6 KB
- hunyuan3d-paintpbr-v2-1/unet/modules.py45.2 KB
- hunyuan3d-paintpbr-v2-1/unet/attn_processor.py35.1 KB
- hunyuan3d-paintpbr-v2-1/unet/model.py25.5 KB
- LICENSE17.9 KB
- Notice.txt16.6 KB
- hy3dpaint/textureGenPipeline.py8.1 KB
- hy3dpaint/utils/multiview_utils.py5.5 KB
- README.md4.0 KB
- hunyuan3d-dit-v2-1/config.yaml2.1 KB
- hunyuan3d-paintpbr-v2-1/README.md1.8 KB
- .gitattributes1.5 KB
- demo.py1.5 KB
- hunyuan3d-paintpbr-v2-1/unet/config.json911 B
- hunyuan3d-paintpbr-v2-1/tokenizer/tokenizer_config.json807 B
- hunyuan3d-paintpbr-v2-1/model_index.json617 B
- hunyuan3d-paintpbr-v2-1/text_encoder/config.json613 B
- hunyuan3d-paintpbr-v2-1/image_encoder/config.json554 B
- hunyuan3d-paintpbr-v2-1/vae/config.json553 B
- hunyuan3d-paintpbr-v2-1/tokenizer/special_tokens_map.json460 B
- hunyuan3d-vae-v2-1/config.yaml409 B
- hunyuan3d-paintpbr-v2-1/scheduler/scheduler_config.json387 B
- hunyuan3d-paintpbr-v2-1/feature_extractor/preprocessor_config.json342 B
הרישיון
הרישיון לא דווח בעמוד האפליקציה. המשמעות היא שאין הרשאה ברורה ומפורשת לשימוש מסחרי בתוצרים, ויש לבדוק את תנאי המאגר המקורי לפני שמשלבים נכסים שנוצרו כאן במוצרים מסחריים.