# Tencent HY Image: Edit

تقوم عقدة Tencent HY Image: Edit بتحرير الصور المرجعية أو دمجها استنادًا إلى تعليمات نصية باستخدام نموذج Hunyuan Image من Tencent. اربط من صورة واحدة إلى خمس صور، وصِف التغيير في `prompt` وأشِر إلى الصور باسم `@Image1` و`@Image2` وهكذا. ترفع العقدة الصور المرجعية، وترسل الطلب إلى واجهة API، وتعيد النتيجة المحرّرة.

## المدخلات

### المدخلات العامة

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `نموذج` | النموذج المستخدم للتحرير. يحدد النموذج المختار المدخلات الإضافية التي ستظهر. | DYNAMIC_COMBO | نعم | `"hy-image-3.5-preview"` |

### مدخلات hy-image-3.5-preview

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `prompt` | تعليمات التحرير. تدعم مراجع بأسلوب `@Image1` إلى الصور المتصلة. يجب ألا تكون فارغة (الافتراضي: فارغة). | STRING | نعم | أي نص |
| `aspect_ratio` | نسبة أبعاد المخرجات. `"auto"` تتبع نسبة أبعاد الصورة المرجعية الأولى ولا تتوفر بدقة 4K. يتم تجاهلها عندما تكون `resolution` مساوية لـ `"custom"`. | COMBO | نعم | `"auto"`<br>`"1:1"`<br>`"3:2"`<br>`"2:3"`<br>`"4:3"`<br>`"3:4"`<br>`"16:9"`<br>`"9:16"`<br>`"21:9"`<br>`"9:21"` (الافتراضي: `"auto"`) |
| `resolution` | مساحة البكسل للمخرجات: 1K حوالي 1024x1024، و2K حوالي 2048x2048، و4K حوالي 4096x4096. أي شيء أعلى من 2K يُرسم عند 2K ثم يُرفع حجمه بواسطة النموذج. اضبطه على `"custom"` لاستخدام `width` و`height` بدلاً من مساحة محددة مسبقًا. | COMBO | نعم | `"1K"`<br>`"2K"`<br>`"4K"`<br>`"custom"` (الافتراضي: `"2K"`) |
| `width` | عرض المخرجات بالبكسل. يُستخدم فقط عندما تكون `resolution` مساوية لـ `"custom"`. | INT | نعم | 256-8192، بخطوات 16 (الافتراضي: 2048) |
| `height` | ارتفاع المخرجات بالبكسل. يُستخدم فقط عندما تكون `resolution` مساوية لـ `"custom"`. | INT | نعم | 256-8192، بخطوات 16 (الافتراضي: 2048) |
| `seed` | البذرة المستخدمة للتوليد. تظل النتائج متغيرة بين التشغيلات مع البذرة نفسها. | INT | نعم | 0-2147483647 (الافتراضي: 42) |
| `reference_detail` | مقدار التفاصيل في الصور المرجعية التي يراها النموذج: `"standard"` تسمح بما يصل إلى 1024x1024 بكسل لكل صورة، و`"high"` بما يصل إلى 2048x2048 وتحافظ على النصوص الصغيرة والتفاصيل الدقيقة بشكل أفضل، لكنها تستغرق وقتًا أطول. هذا معامل متقدم. | COMBO | لا | `"standard"`<br>`"high"` (الافتراضي: `"standard"`) |
| `watermark` | هل تضيف علامة مائية مولّدة بالذكاء الاصطناعي إلى النتيجة. هذا معامل متقدم. | BOOLEAN | لا | true<br>false (الافتراضي: false) |

### المدخلات المرجعية

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `images` | الصور المرجعية المراد تحريرها أو دمجها. خانة قابلة للتوسيع: اربط من صورة واحدة إلى 5 صور (`image_1` حتى `image_5`). أشِر إليها في `prompt` باسم `@Image1` ... `@Image5`، مرقّمة حسب ترتيب الإدخال؛ يُحتسب الإدخال المجمّع مرة واحدة لكل صورة. | IMAGE | نعم | 1-5 صور |

يجب ألا يكون `prompt` فارغًا، كما أن مرجعًا في `prompt` مثل `@Image3` يُطلق خطأً عند توصيل صورة واحدة أو صورتين فقط. يمكن استخدام 5 صور مرجعية كحد أقصى إجمالًا، مع احتساب كل صورة في الدفعة على نحو منفصل. عند استخدام دقة `"custom"`، يجب أن يكون كل من `width` و`height` من مضاعفات 16 وأن يكون حاصل ضربهما ضمن حد مساحة 4096 x 4096 بكسل (حوالي 16.7 ميجابكسل)؛ تعمل أي نسبة أبعاد، وإن كان النموذج يبدأ بتكرار الموضوع بعد حوالي 6:1. تعمل نسبة الأبعاد `"auto"` فقط ضمن حد مساحة 2K، لذلك عند 4K اختر نسبة أبعاد صريحة أو استخدم `"custom"`.

## المخرجات

| اسم المخرَج | الوصف | نوع البيانات |
|-------------|-------------|-----------|
| `IMAGE` | الصورة المحرّرة الناتجة من الصور المرجعية و`prompt`. | IMAGE |

> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanImageEditApi/ar.md)

---
**Source fingerprint (SHA-256):** `46c112347b51a2983521f87bbeb047289515f4073c48ba5d909fd3bae4597633`
