# Hunyuan3D: تبدیل تصویر(ها) به مدل (پیشرفته)

این گره از API پروانه‌ی Hunyuan3D شرکت Tencent برای تولید مدل سه‌بعدی از یک یا چند تصویر ورودی استفاده می‌کند. تصاویر را پردازش کرده، به API ارسال می‌کند و فایل‌های مدل سه‌بعدی تولیدشده را در قالب‌های GLB و OBJ به همراه نقشه‌های بافت اختیاری بازمی‌گرداند.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | اجباری | محدوده |
| --- | --- | --- | --- | --- |
| `مدل` | نسخه مدل Hunyuan3D که باید استفاده شود. گزینه LowPoly برای مدل `3.1` در دسترس نیست. | COMBO | بله | `"3.0"`<br>`"3.1"` |
| `تصویر` | تصویر ورودی اصلی برای تولید مدل سه‌بعدی. حداقل باید 128×128 پیکسل باشد. | IMAGE | بله | - |
| `تصویر چپ` | تصویر اختیاری از سمت چپ شیء برای تولید چندنمایی. حداقل باید 128×128 پیکسل باشد. | IMAGE | خیر | - |
| `تصویر راست` | تصویر اختیاری از سمت راست شیء برای تولید چندنمایی. حداقل باید 128×128 پیکسل باشد. | IMAGE | خیر | - |
| `تصویر پشت` | تصویر اختیاری از پشت شیء برای تولید چندنمایی. حداقل باید 128×128 پیکسل باشد. | IMAGE | خیر | - |
| `تعداد وجه‌ها` | تعداد وجه‌های هدف برای مدل سه‌بعدی تولیدشده (پیش‌فرض: 500000). | INT | بله | 3000 - 1500000 |
| `نوع تولید` | نوع مدل سه‌بعدی که باید تولید شود. انتخاب یک گزینه، پارامترهای مرتبط اضافی را نمایش می‌دهد. | DYNAMICCOMBO | بله | `"Normal"`<br>`"LowPoly"`<br>`"Geometry"` |
| `generate_type.pbr` | تولید متریال مبتنی بر رندر فیزیکی (PBR) را فعال می‌کند. این پارامتر فقط زمانی قابل مشاهده است که `نوع تولید` روی "Normal" یا "LowPoly" تنظیم شده باشد (پیش‌فرض: False). | BOOLEAN | خیر | - |
| `generate_type.polygon_type` | نوع چندضلعی برای مش. این پارامتر فقط زمانی قابل مشاهده است که `نوع تولید` روی "LowPoly" تنظیم شده باشد. | COMBO | خیر | `"triangle"`<br>`"quadrilateral"` |
| `seed` | یک مقدار seed برای فرآیند تولید. Seed تعیین می‌کند که آیا گره باید دوباره اجرا شود یا خیر؛ نتایج صرف‌نظر از seed غیرقطعی هستند (پیش‌فرض: 0). | INT | بله | 0 - 2147483647 |

**توجه:** تمام تصاویر ورودی باید حداقل عرض و ارتفاع 128 پیکسل داشته باشند. اگر طولانی‌ترین ضلع تصاویر از 4900 پیکسل بیشتر شود، به‌طور خودکار کوچک‌سازی می‌شوند.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
| --- | --- | --- |
| `فایل مدل` | یک خروجی قدیمی برای سازگاری با نسخه‌های قبلی. | STRING |
| `GLB` | مدل سه‌بعدی تولیدشده در قالب فایل GLB (فرمت انتقال باینری GL). | FILE3DGLB |
| `OBJ` | مدل سه‌بعدی تولیدشده در قالب فایل OBJ (Wavefront). | FILE3DOBJ |
| `تصویر بافت` | تصویر بافت برای مدل سه‌بعدی تولیدشده. | IMAGE |
| `metallic اختیاری` | نقشه فلزینگی برای متریال‌های PBR. در صورت عدم وجود، یک تصویر سیاه بازمی‌گرداند. | IMAGE |
| `normal اختیاری` | نقشه نرمال برای متریال‌های PBR. در صورت عدم وجود، یک تصویر سیاه بازمی‌گرداند. | IMAGE |
| `roughness اختیاری` | نقشه زبری برای متریال‌های PBR. در صورت عدم وجود، یک تصویر سیاه بازمی‌گرداند. | IMAGE |

> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TencentImageToModelNode/fa.md)

---
**Source fingerprint (SHA-256):** `56ac9e55bd9bb3a5c7c46c2de1ea06921cf41c0971471f6d0b64166722705e4d`
