### گره Meshy: تصویر به مدل

گره Meshy: Image to Model از API Meshy برای تولید یک مدل سه‌بعدی از یک تصویر ورودی استفاده می‌کند. این گره تصویر شما را آپلود کرده، یک وظیفه پردازش ارسال می‌کند و فایل‌های مدل سه‌بعدی تولید شده (GLB و FBX) را به همراه شناسه وظیفه برای مرجع بازمی‌گرداند.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
| --- | --- | --- | --- | --- |
| `model` | نسخه مدل هوش مصنوعی مورد استفاده برای تولید را مشخص می‌کند. | COMBO | بله | `"latest"` |
| `image` | تصویر ورودی برای تبدیل به مدل سه‌بعدی. | IMAGE | بله | - |
| `should_remesh` | تعیین می‌کند که آیا مش تولید شده باید پردازش شود. وقتی روی `"false"` تنظیم شود، گره یک مش مثلثی پردازش‌نشده بازمی‌گرداند. | DYNAMIC COMBO | بله | `"true"`<br>`"false"` |
| `topology` | توپولوژی چندضلعی هدف برای مدل بازمش‌بندی‌شده. این ورودی فقط زمانی در دسترس است که `should_remesh` روی `"true"` تنظیم شده باشد. | COMBO | خیر* | `"triangle"`<br>`"quad"` |
| `target_polycount` | تعداد چندضلعی‌های هدف برای مدل بازمش‌بندی‌شده. این ورودی فقط زمانی در دسترس است که `should_remesh` روی `"true"` تنظیم شده باشد. مقدار پیش‌فرض 300000 است. | INT | خیر* | 100 - 300000 |
| `symmetry_mode` | تقارن اعمال‌شده به مدل سه‌بعدی تولید شده را کنترل می‌کند. | COMBO | بله | `"auto"`<br>`"on"`<br>`"off"` |
| `should_texture` | تعیین می‌کند که آیا بافت برای مدل تولید شود یا خیر. تنظیم آن روی `"false"` مرحله بافت‌دهی را نادیده گرفته و یک مش بدون بافت بازمی‌گرداند. | DYNAMIC COMBO | بله | `"true"`<br>`"false"` |
| `enable_pbr` | وقتی `should_texture` روی `"true"` است، این گزینه نقشه‌های PBR (فلزی، زبری، نرمال) را علاوه بر رنگ پایه تولید می‌کند. مقدار پیش‌فرض `False` است. | BOOLEAN | خیر* | - |
| `texture_prompt` | یک پرامپت متنی برای هدایت فرآیند بافت‌دهی (حداکثر 600 کاراکتر). این ورودی فقط زمانی در دسترس است که `should_texture` روی `"true"` تنظیم شده باشد. نمی‌توان همزمان با `texture_image` استفاده کرد. | STRING | خیر* | - |
| `texture_image` | یک تصویر برای هدایت فرآیند بافت‌دهی. این ورودی فقط زمانی در دسترس است که `should_texture` روی `"true"` تنظیم شده باشد. نمی‌توان همزمان با `texture_prompt` استفاده کرد. | IMAGE | خیر* | - |
| `pose_mode` | حالت ژست برای مدل تولید شده را مشخص می‌کند. این یک پارامتر پیشرفته است. | COMBO | بله | `""` (خالی)<br>`"A-pose"`<br>`"T-pose"` |
| `seed` | یک مقدار دانه (seed) برای فرآیند تولید. نتایج صرف‌نظر از مقدار دانه، غیرقطعی هستند. مقدار پیش‌فرض 0 است. | INT | بله | 0 - 2147483647 |

**توجه در مورد محدودیت‌های پارامتر:**

* ورودی‌های `topology` و `target_polycount` فقط زمانی در دسترس هستند که `should_remesh` روی `"true"` تنظیم شده باشد.
* ورودی‌های `enable_pbr`، `texture_prompt` و `texture_image` فقط زمانی در دسترس هستند که `should_texture` روی `"true"` تنظیم شده باشد.
* نمی‌توانید همزمان از `texture_prompt` و `texture_image` استفاده کنید. اگر هر دو هنگام `"true"` بودن `should_texture` ارائه شوند، گره یک خطا ایجاد می‌کند.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
| --- | --- | --- |
| `model_file` | نام فایل مدل GLB تولید شده. (برای سازگاری با نسخه‌های قبلی حفظ شده است). | STRING |
| `meshy_task_id` | شناسه یکتای وظیفه API Meshy که می‌تواند برای مرجع یا عیب‌یابی استفاده شود. | MESHY_TASK_ID |
| `GLB` | مدل سه‌بعدی تولید شده در قالب فایل GLB. | FILE3DGLB |
| `FBX` | مدل سه‌بعدی تولید شده در قالب فایل FBX. | FILE3DFBX |

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

---
**Source fingerprint (SHA-256):** `134d9250d8b447bbbd2905f827e81b67f491ba355ebb93d4d256324b644100a2`