# 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` | Seed برای تولید. متن‌به‌تصویر تنها با Seed قابل بازتولید نیست، چون پرامپت در هر اجرا بازنویسی می‌شود؛ برای بازتولید یک تصویر، `final_prompt` آن را با `magic_prompt` روی `"off"` و همان Seed دوباره استفاده کنید. (پیش‌فرض: 42) | INT | بله | 0 تا 2147483647 |

### محدودیت‌های پارامترها

- **پرامپت الزامی:** پرامپت باید حداقل یک کاراکتر غیرفاصله و حداکثر 10000 کاراکتر داشته باشد. زمانی که کپشن JSON خودتان یا جمله‌بندی دقیق را ارائه می‌دهید، `magic_prompt` را روی `"off"` تنظیم کنید.
- **اندازه:** `"auto"` اجازه می‌دهد مدل انتخاب کند. پیش‌تنظیم‌های `(2K)` حدود 3 تا 4 مگاپیکسل و پیش‌تنظیم‌های `(1K)` حدود 1 مگاپیکسل هستند؛ برچسب سطح بودجهٔ پیکسل را توصیف می‌کند نه یک ضلع بلند ثابت، و نسبت تصویر پیش‌تنظیم رعایت می‌شود. فقط بخش اندازه پیکسلی پیش‌تنظیم به API فرستاده می‌شود.
- **قابلیت بازتولید:** با `magic_prompt` روی `"auto"` یا `"on"`، پرامپت در هر اجرا بازنویسی می‌شود، بنابراین همان Seed ممکن است همچنان تصویر متفاوتی تولید کند. برای بازتولید یک تصویر، `final_prompt` آن را با `magic_prompt` روی `"off"` و همان Seed دوباره وارد کنید.
- **ایمنی محتوا:** اگر فیلتر ایمنی محتوای Ideogram تولید را مسدود کند، گره به‌جای بازگرداندن تصویر خطا می‌دهد.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `IMAGE` | تصویر(های) تولیدشده به‌صورت یک دسته. | IMAGE |
| `final_prompt` | کپشن ساختاریافته‌ای که تصویر از آن تولید شده است. آن را با `magic_prompt` روی `"off"` و همان Seed دوباره وارد کنید تا تصویر بازتولید شود. | STRING |

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

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