گره Ideogram V3 با استفاده از مدل Ideogram V3 تصاویر تولید می‌کند. این گره هم از تولید تصویر معمولی بر اساس توضیحات متنی و هم از ویرایش تصویر در صورت ارائه همزمان تصویر و ماسک پشتیبانی می‌کند. کنترل‌های مختلفی برای نسبت ابعاد، وضوح، سرعت تولید و تصاویر مرجع شخصیت اختیاری ارائه می‌دهد.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
| --- | --- | --- | --- | --- |
| `پرامپت` | توضیحات برای تولید یا ویرایش تصویر (پیش‌فرض: خالی) | STRING | بله | - |
| `تصویر` | تصویر مرجع اختیاری برای ویرایش تصویر | IMAGE | خیر | - |
| `ماسک` | ماسک اختیاری برای نقاشی درون‌تصویری (نواحی سفید جایگزین می‌شوند) | MASK | خیر | - |
| `نسبت ابعاد` | نسبت ابعاد برای تولید تصویر. اگر وضوح روی Auto تنظیم نشده باشد نادیده گرفته می‌شود (پیش‌فرض: "1:1") | COMBO | خیر | "1:1"<br>"16:9"<br>"9:16"<br>"4:3"<br>"3:4"<br>"3:2"<br>"2:3" |
| `وضوح` | وضوح برای تولید تصویر. اگر روی Auto تنظیم نشده باشد، تنظیم aspect_ratio را نادیده می‌گیرد (پیش‌فرض: "Auto") | COMBO | خیر | "Auto"<br>"1024x1024"<br>"1152x896"<br>"896x1152"<br>"1216x832"<br>"832x1216"<br>"1344x768"<br>"768x1344"<br>"1536x640"<br>"640x1536" |
| `گزینه MagicPrompt` | تعیین می‌کند که آیا از MagicPrompt در تولید استفاده شود (پیش‌فرض: "AUTO") | COMBO | خیر | "AUTO"<br>"ON"<br>"OFF" |
| `بذر` | دانه تصادفی برای تولید (پیش‌فرض: 0) | INT | خیر | 0-2147483647 |
| `تعداد تصاویر` | تعداد تصاویر برای تولید (پیش‌فرض: 1) | INT | خیر | 1-8 |
| `سرعت رندر` | تعادل بین سرعت تولید و کیفیت را کنترل می‌کند (پیش‌فرض: "DEFAULT") | COMBO | خیر | "DEFAULT"<br>"TURBO"<br>"QUALITY" |
| `تصویر کاراکتر` | تصویری که به عنوان مرجع شخصیت استفاده می‌شود | IMAGE | خیر | - |
| `ماسک کاراکتر` | ماسک اختیاری برای تصویر مرجع شخصیت | MASK | خیر | - |

**محدودیت‌های پارامتر:**

- هنگامی که هر دو `image` و `mask` ارائه شوند، گره به حالت ویرایش تغییر می‌کند
- اگر تنها یکی از `image` یا `mask` ارائه شود، خطا رخ می‌دهد
- `character_mask` نیازمند وجود `character_image` است
- پارامتر `aspect_ratio` زمانی که `resolution` روی "Auto" تنظیم نشده باشد نادیده گرفته می‌شود
- نواحی سفید در ماسک در طول نقاشی درون‌تصویری جایگزین می‌شوند
- ماسک شخصیت و تصویر شخصیت باید اندازه یکسانی داشته باشند

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
| --- | --- | --- |
| `output` | تصویر(های) تولید یا ویرایش شده | IMAGE |

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

---
**Source fingerprint (SHA-256):** `0d0058cc8483c453100d8d9dfcb9a31ae5e686f38ced77ed7e472cd083c3464b`
