# Meshy: من صورة إلى نموذج

عقدة **Meshy: Image to Model** تستخدم واجهة برمجة تطبيقات Meshy لإنشاء نموذج ثلاثي الأبعاد من صورة إدخال واحدة. تقوم برفع صورتك، وإرسال مهمة معالجة، وإرجاع ملفات النموذج ثلاثي الأبعاد المُنشأة (GLB وFBX) بالإضافة إلى معرف المهمة للرجوع إليه.

## المدخلات

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
| --- | --- | --- | --- | --- |
| `model` | يحدد إصدار نموذج الذكاء الاصطناعي المستخدم في التوليد. | COMBO | نعم | `"meshy-7.1"`<br>`"meshy-7"`<br>`"meshy-6"`<br>`"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` | توليد خرائط PBR (المعدنية، الخشونة، الطبيعية) بالإضافة إلى اللون الأساسي. يتوفر هذا المدخل فقط عندما يكون `should_texture` مضبوطًا على `"true"`. الافتراضي: `False`. | BOOLEAN | لا* | - |
| `texture_prompt` | يوفّر موجهًا نصيًا لتوجيه عملية التنسيج. الحد الأقصى 600 حرف. لا يمكن استخدامه في نفس الوقت مع `texture_image`. يتوفر هذا المدخل فقط عندما يكون `should_texture` مضبوطًا على `"true"`. الافتراضي: سلسلة فارغة. | STRING | لا* | - |
| `texture_image` | يُسمح باستخدام واحد فقط من `texture_image` أو `texture_prompt` في نفس الوقت. يتوفر هذا المدخل فقط عندما يكون `should_texture` مضبوطًا على `"true"`. | IMAGE | لا* | - |
| `texture_resolution` | دقة نسيج اللون الأساسي. الدقة الأعلى تلتقط تفاصيل سطحية أكثر. يتوفر هذا المدخل فقط عندما يكون `should_texture` مضبوطًا على `"true"`. | COMBO | لا* | `"2k"`<br>`"4k"`<br>`"8k"` |
| `pose_mode` | يحدد وضع الوضعية (pose) للنموذج المُنشأ. هذه معلمة متقدمة. | COMBO | نعم | `""` (فارغ)<br>`"A-pose"`<br>`"T-pose"` |
| `seed` | تتحكم البذرة (Seed) في ما إذا كانت العقدة ستعيد التشغيل؛ تكون النتائج غير حتمية بغض النظر عن البذرة. الافتراضي: 0. | INT | نعم | 0 - 2147483647 |
| `ultra_mode` | تشغيل مرحلة تحسين إضافية للحصول على هندسة عالية الدقة مع تفاصيل سطحية أدق. الافتراضي: `False`. | BOOLEAN | نعم | - |
| `ultra_resolution` | دقة تمريرة ultra: يشغّلها `"2k"` عند 2048³ و`"4k"` عند 4096³ للحصول على أدق تفاصيل السطح. يتطلب `"4k"` طراز `"meshy-7.1"` أو `"latest"`. يُستخدم فقط عند تمكين `ultra_mode` (الافتراضي: `"2k"`). | COMBO | لا | `"2k"`<br>`"4k"` |

**ملاحظة حول قيود المعاملات:**

* المدخلان `topology` و`target_polycount` متاحان فقط عندما يكون `should_remesh` مضبوطًا على `"true"`.
* المدخلات `enable_pbr` و`texture_prompt` و`texture_image` و`texture_resolution` متاحة فقط عندما يكون `should_texture` مضبوطًا على `"true"`.
* عندما يكون `should_texture` مضبوطًا على `"true"`، لا يمكن استخدام `texture_prompt` و`texture_image` في نفس الوقت. إذا تم توفير كلاهما، ترفع العقدة خطأً.
* الحد الأقصى لطول `texture_prompt` هو 600 حرف.
* عند تمكين `ultra_mode`، يجب ضبط المعامل `model` على `"meshy-7.1"` أو `"meshy-7"` أو `"latest"`؛ أي طراز آخر يؤدي إلى خطأ. مع `"meshy-7"` تُنفَّذ تمريرة ultra دائمًا عند 2048³، وتتطلب دقة ultra `"4k"` طراز `"meshy-7.1"` أو `"latest"`.

## المخرجات

| اسم المخرج | الوصف | نوع البيانات |
| --- | --- | --- |
| `model_file` | اسم ملف نموذج GLB المُنشأ. يُحافظ عليه للتوافق مع الإصدارات السابقة فقط. | STRING |
| `meshy_task_id` | المعرّف الفريد لمهمة واجهة برمجة تطبيقات 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/ar.md)

---
**Source fingerprint (SHA-256):** `38528b48c3f792a459008a52f65fae248ef1dadafb37fe4dc6b697d25bc89f4f`
