# ویرایش دقیق Ideogram 4.5

ویرایش یک تصویر با راهنمایی یک پرامپت متنی و با ویرایش دقیق Ideogram 4.5: تنها آنچه پرامپت درخواست می‌کند تغییر می‌کند، پیکسل‌های دست‌نخورده یکسان می‌مانند و خروجی اندازه تصویر 1 را حفظ می‌کند. تصویر 1 تصویری است که ویرایش می‌شود و حداکثر 4 تصویر دیگر می‌توانند به‌عنوان مرجع متصل شوند. یک ناحیه منفرد از تصویر 1 نیز می‌تواند به‌تنهایی ویرایش شود، که با یک ماسک یا با کادرهای محدودکننده انتخاب می‌شود و تصویر را در اندازه کامل برمی‌گرداند.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `مدل` | مدل مورد استفاده. (پیش‌فرض: `"ideogram-4.5"`) | DYNAMIC_COMBO | بله | `"ideogram-4.5"` |
| `images` | جایگاه قابل گسترش: تصویر 1 تصویری است که ویرایش می‌شود و تصاویر 2 تا 5 مراجع اختیاری هستند (`image_1` ... `image_5`). در پرامپت با @Image1، @Image2، ... به آن‌ها ارجاع دهید؛ یک ورودی دسته‌ای برای هر تصویر یک‌بار شمرده می‌شود. نسبت ابعاد هر تصویر باید بین 1:6 و 6:1 باشد، با این استثنا که وقتی پنجره زمینه در حال استفاده است، تصویر 1 از نظر نسبت ابعاد بررسی نمی‌شود. | IMAGE | بله | 1 تا 5 تصویر |
| `prompt` | دستورالعمل‌های ویرایش. از ارجاع‌های به سبک @Image1 به تصاویر متصل پشتیبانی می‌کند. (پیش‌فرض: رشته خالی) | STRING | بله | 1 تا 10000 کاراکتر |
| `quality` | سطح کیفیت. سطوح بالاتر هزینه بیشتر و زمان بیشتری می‌گیرند. (پیش‌فرض: `"medium"`) | COMBO | بله | `"very_low"`<br>`"low"`<br>`"medium"`<br>`"high"` |
| `seed` | بذر تولید. تصاویر، پرامپت، تنظیمات و بذر یکسان نتیجه یکسان می‌دهند. (پیش‌فرض: 42) | INT | بله | 0 تا 2147483647 |
| `context_window` | ناحیه‌ای از تصویر 1 که باید ویرایش شود. `"none"` کل تصویر را ویرایش می‌کند. `"auto"` ناحیه‌ای اطراف `context_window_mask` و `"custom"` ناحیه‌ای از `context_window_bboxes` را ویرایش می‌کند؛ هر دو تصویر 1 را در اندازه کامل نگه می‌دارند و بقیه تصویر را بدون تغییر می‌گذارند. (پیش‌فرض: `"none"`) | COMBO | خیر | `"none"`<br>`"auto"`<br>`"custom"` |
| `context_window_bboxes` | ناحیه‌ای از تصویر 1 برای ویرایش، مثلاً خروجی Create Bounding Boxes. هنگامی که `context_window` برابر `"custom"` است الزامی است؛ در غیر این صورت استفاده نمی‌شود. چند کادر در یک ناحیه ادغام می‌شوند، که تا حداقل 256 پیکسل در هر ضلع و نسبت ابعاد 6:1 گسترش می‌یابد. ناحیه می‌تواند تا 4608 پیکسل در هر ضلع و حدود 4 MP (مثلاً 2048x2048) باشد. | BOUNDING_BOX | خیر | - |
| `context_window_mask` | نواحی سفید مشخص می‌کنند چه چیزی ویرایش شود؛ ناحیه ویرایش پیرامون آن قرار می‌گیرد. هنگامی که `context_window` برابر `"auto"` است الزامی است؛ در غیر این صورت استفاده نمی‌شود. ماسک باید هم نواحی سفید (ویرایش) و هم سیاه (حفظ) داشته باشد. | MASK | خیر | - |

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

- **تعداد تصویر:** حداقل 1 و حداکثر 5 تصویر؛ یک ورودی دسته‌ای برای هر تصویر یک‌بار شمرده می‌شود. تصویر 1 تصویری است که ویرایش می‌شود و تصاویر 2 تا 5 مرجع هستند. با `context_window_mask` حداکثر 4 تصویر پذیرفته می‌شود، یعنی تصویر 1 و 3 مرجع.
- **اندازه خروجی:** نتیجه اندازه تصویر 1 را حفظ می‌کند، بنابراین این گره هیچ ورودی اندازه، عرض یا ارتفاع ندارد. این موضوع هنگامی که یک ناحیه ویرایش می‌شود نیز برقرار است؛ در این حالت تصویر کامل با تنها ناحیه تغییر‌یافته برمی‌گردد.
- **نسبت ابعاد تصویر:** عرض هر تصویر نباید بیش از 6 برابر ارتفاع آن و ارتفاع آن نباید بیش از 6 برابر عرض آن باشد (بین 1:6 و 6:1). تصویر 1 زمانی که `context_window` برابر `"auto"` یا `"custom"` است از این قاعده مستثنا است، زیرا فقط ناحیه انتخاب‌شده آن ارسال می‌شود.
- **اندازه منبع ناحیه:** هنگامی که پنجره زمینه در حال استفاده است، تصویر 1 می‌تواند تا 8192x8192 پیکسل (حدود 67 MP) باشد؛ منابع بزرگ‌تر خطا می‌دهند. بدون پنجره زمینه، تصاویر بزرگ‌تر از حدود 4 MP یا 4608 پیکسل در ضلع بلند قبل از ارسال کوچک می‌شوند.
- **محدودیت‌های ناحیه:** ناحیه‌ای از `context_window_bboxes` می‌تواند تا 4608 پیکسل در هر ضلع و حدود 4 MP باشد؛ کادرهایی که کاملاً بیرون از تصویر 1 قرار بگیرند خطا ایجاد می‌کنند.
- **برچسب‌های پرامپت:** `@ImageN` بدون حساسیت به حروف بزرگ و کوچک تطبیق داده می‌شود و نباید از تعداد تصاویر متصل بیشتر باشد؛ پرامپت نباید تهی یا فقط شامل فضای خالی باشد و حداکثر 10000 کاراکتر باشد.
- **محدودیت بارگذاری:** تصویر 1، ماسک و مراجع روی‌هم باید در محدوده بارگذاری 50 MB Ideogram جای بگیرند؛ در صورت نیاز تصویر 1 به‌صورت JPEG دوباره کدگذاری می‌شود و اگر همچنان جای نگیرد، گره خطا می‌دهد.
- **ایمنی محتوا:** اگر فیلتر ایمنی محتوای Ideogram نتیجه را مسدود کند، گره به‌جای برگرداندن تصویر خطا می‌دهد.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `IMAGE` | تصویر ویرایش‌شده به‌صورت دسته‌ای، در اندازه تصویر 1. | IMAGE |

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

---
**Source fingerprint (SHA-256):** `84f042739a8d7bc1a4b268f6175be6a598b67d32b9311fdf204a923472f5fcc9`
