# Tencent HY Image: Text to Image

عُقدة Tencent HY Image: Text to Image تنشئ صورة من وصف نصي باستخدام نموذج Hunyuan Image من Tencent. يُرسَل التوجيه إلى API، التي تعيد كتابته وتوسيعه قبل التوليد، ثم تُعاد الصورة النهائية كدفعة صور.

## المدخلات

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

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

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

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `prompt` | يصف الصورة المراد توليدها. يعيد النموذج كتابته ويوسعه قبل التوليد. يجب ألا يكون فارغًا (الافتراضي: فارغ). | 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 حوالي 1024×1024، و2K حوالي 2048×2048، و4K حوالي 4096×4096. أي شيء أعلى من 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) |
| `watermark` | ما إذا كان سيتم إضافة علامة مائية مولّدة بالذكاء الاصطناعي إلى النتيجة. هذا معامل متقدم. | BOOLEAN | لا | true<br>false (الافتراضي: false) |

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

## المخرجات

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

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

---
**Source fingerprint (SHA-256):** `1d4e70d688c5aa4e79b81447da559e201078454077da34769f2a4f544fbba63f`
