# Ideogram 4.5 Text to Image

أنشئ صورًا من وصف نصي باستخدام Ideogram 4.5. يقبل الوصف أيضًا تسمية JSON منظّمة من Ideogram، مثل `final_prompt` التي أعادتها تشغيلة سابقة، ما يتيح تحكمًا دقيقًا في السلاسل النصية والألوان والتخطيط. تُعيد العقدة الصورة/الصور المُنشأة مع التسمية التي وُلّدت الصورة منها فعليًا.

## المدخلات

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `النموذج` | النموذج المطلوب استخدامه. (الافتراضي: `"ideogram-4.5"`) | DYNAMIC_COMBO | نعم | `"ideogram-4.5"` |
| `prompt` | وصف نصي، أو تسمية JSON منظّمة من Ideogram مثل `final_prompt` سابقة. (الافتراضي: سلسلة فارغة) | STRING | نعم | من 1 إلى 10000 حرف |
| `size` | حجم الإخراج. يتيح `"auto"` للنموذج اختيار لوحة تناسب الوصف. يثبّت الإعداد المسبق `(2K)` أو `(1K)` كلاً من حجم البكسل ونسبة الأبعاد. (الافتراضي: `"auto"`) | COMBO | نعم | `"auto"`<br>`"(2K) 2048x2048 (1:1)"`<br>`"(2K) 1440x2880 (1:2)"`<br>`"(2K) 2880x1440 (2:1)"`<br>`"(2K) 1664x2496 (2:3)"`<br>`"(2K) 2496x1664 (3:2)"`<br>`"(2K) 1792x2240 (4:5)"`<br>`"(2K) 2240x1792 (5:4)"`<br>`"(2K) 1440x2560 (9:16)"`<br>`"(2K) 2560x1440 (16:9)"`<br>`"(2K) 1600x2560 (5:8)"`<br>`"(2K) 2560x1600 (8:5)"`<br>`"(2K) 1728x2304 (3:4)"`<br>`"(2K) 2304x1728 (4:3)"`<br>`"(2K) 1296x3168 (9:22)"`<br>`"(2K) 3168x1296 (22:9)"`<br>`"(2K) 1152x2944 (9:23)"`<br>`"(2K) 2944x1152 (23:9)"`<br>`"(2K) 1248x3328 (3:8)"`<br>`"(2K) 3328x1248 (8:3)"`<br>`"(2K) 1280x3072 (5:12)"`<br>`"(2K) 3072x1280 (12:5)"`<br>`"(2K) 1024x3072 (1:3)"`<br>`"(2K) 3072x1024 (3:1)"`<br>`"(1K) 1024x1024 (1:1)"`<br>`"(1K) 896x1120 (4:5)"`<br>`"(1K) 1120x896 (5:4)"`<br>`"(1K) 864x1152 (3:4)"`<br>`"(1K) 1152x864 (4:3)"`<br>`"(1K) 832x1248 (2:3)"`<br>`"(1K) 1248x832 (3:2)"`<br>`"(1K) 800x1280 (5:8)"`<br>`"(1K) 1280x800 (8:5)"`<br>`"(1K) 720x1280 (9:16)"`<br>`"(1K) 1280x720 (16:9)"`<br>`"(1K) 720x1440 (1:2)"`<br>`"(1K) 1440x720 (2:1)"` |
| `quality` | فئة الجودة. الفئات الأعلى تكلّف أكثر وتستغرق وقتًا أطول. (الافتراضي: `"medium"`) | COMBO | نعم | `"low"`<br>`"medium"`<br>`"high"` |
| `magic_prompt` | يعيد كتابة الوصف إلى تسمية منظّمة مفصّلة قبل التوليد؛ يُبقي `"off"` صياغتك حرفية قدر الإمكان. تُعاد التسمية باسم `final_prompt`. (الافتراضي: `"auto"`) هذا إعداد متقدم. | COMBO | نعم | `"auto"`<br>`"on"`<br>`"off"` |
| `seed` | بذرة التوليد. لا يمكن إعادة إنتاج التوليد من النص إلى صورة اعتمادًا على البذرة وحدها لأن الوصف يُعاد كتابته في كل تشغيل؛ لإعادة إنتاج صورة، أعد استخدام `final_prompt` الخاصة بها مع ضبط `magic_prompt` على `"off"` واستخدام البذرة نفسها. (الافتراضي: 42) | INT | نعم | من 0 إلى 2147483647 |

### قيود المعاملات

- **الوصف مطلوب:** يجب أن يحتوي الوصف على محرف واحد غير مسافة بيضاء على الأقل و10000 حرف كحد أقصى. اضبط `magic_prompt` على `"off"` عند تقديم تسمية JSON خاصة بك أو صياغة حرفية.
- **الحجم:** يتيح `"auto"` للنموذج الاختيار. تكون إعدادات `(2K)` المسبقة بنحو 3 إلى 4 ميغابكسل، وإعدادات `(1K)` بنحو ميغابكسل واحد، لذا تصف تسمية الفئة ميزانية البكسلات لا ضلعًا طويلًا ثابتًا؛ وتُحترم نسبة الأبعاد الخاصة بالإعداد المسبق. لا يُرسَل إلى واجهة API سوى جزء حجم البكسل من الإعداد المسبق.
- **قابلية إعادة الإنتاج:** عند ضبط `magic_prompt` على `"auto"` أو `"on"`، يُعاد كتابة الوصف في كل تشغيل، لذا قد تُنتج البذرة نفسها صورة مختلفة. لإعادة إنتاج صورة، أعد تمرير `final_prompt` الخاصة بها مع ضبط `magic_prompt` على `"off"` واستخدام البذرة نفسها.
- **سلامة المحتوى:** إذا حجب مرشّح سلامة المحتوى الخاص بـ Ideogram التوليد، فإن العقدة تُطلق خطأً بدلاً من إرجاع صورة.

## المخرجات

| اسم المخرج | الوصف | نوع البيانات |
|-------------|-------------|-----------|
| `IMAGE` | الصورة/الصور المُنشأة كدفعة. | IMAGE |
| `final_prompt` | التسمية المنظّمة التي وُلّدت الصورة منها. أعد تمريرها مع ضبط `magic_prompt` على `"off"` واستخدام البذرة نفسها لإعادة إنتاج الصورة. | STRING |

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

---
**Source fingerprint (SHA-256):** `a21f1faed9ca7a7bc63dae74003cc7599f11013075f718af9e5860d2cd666828`
