# ویرایش تصویر Meta Muse

تا ۱۰ تصویر مرجع را با استفاده از یک درخواست متنی و مدل Muse Image شرکت Meta ویرایش یا ترکیب می‌کند. ویرایش مورد نظر را در درخواست متنی توصیف کنید و در صورت نیاز، تصاویر مرجع را با `@Image1`، `@Image2` و به همین ترتیب ارجاع دهید. این گره تصاویر مرجع را بارگذاری می‌کند، API مدل Muse Image شرکت Meta را فراخوانی می‌کند و نتیجه ویرایش‌شده را به‌صورت یک تصویر بازمی‌گرداند.

## ورودی‌ها

این گره توسط یک انتخابگر `model` کنترل می‌شود. ورودی‌های مخصوص مدل که در ادامه توضیح داده شده‌اند، هنگام انتخاب یک مدل ظاهر می‌شوند و تصاویر مرجعی که متصل می‌کنید می‌توانند در صورت نیاز افزایش یا کاهش یابند.

### ورودی‌های مشترک

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `model` | مدل مورد استفاده. | DYNAMIC_COMBO | بله | "muse-image-1.0" |

### ورودی‌های muse-image-1.0

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `prompt` | دستورالعمل‌های ویرایش. از ارجاع‌های به سبک `@Image1` به تصاویر ورودی پشتیبانی می‌کند. پیش‌فرض: رشته خالی. درخواست متنی باید حداقل یک نویسه داشته باشد. | STRING | بله | هر متنی with a minimum length of 1 character |
| `aspect_ratio` | نسبت ابعاد خروجی. تصاویر با حدود ۲.۵ مگاپیکسل رندر می‌شوند (۱:۱ برابر ۱۶۰۰x۱۶۰۰، ۱۶:۹ برابر ۲۰۴۸x۱۱۵۲)؛ "auto" نسبت ابعاد ورودی را حفظ می‌کند. | COMBO | بله | "auto"<br>"1:1"<br>"3:2"<br>"2:3"<br>"4:3"<br>"3:4"<br>"5:4"<br>"4:5"<br>"16:9"<br>"9:16"<br>"21:9"<br>"9:21"<br>"2:1"<br>"1:2" |
| `reasoning_strength` | میزان تفکر، برنامه‌ریزی و خوداصلاحی مدل پیش از رندر. | COMBO | بله | "high"<br>"low" |
| `enable_web_search` | به مدل اجازه می‌دهد هنگام برنامه‌ریزی تصویر، در وب به دنبال حقایق و اطلاعات زنده بگردد. پیش‌فرض: true. | BOOLEAN | بله | true یا false (پیش‌فرض: true) |
| `enable_image_search` | به مدل اجازه می‌دهد هنگام برنامه‌ریزی تصویر، به دنبال تصاویر مرجع بگردد. پیش‌فرض: true. | BOOLEAN | بله | true یا false (پیش‌فرض: true) |
| `enable_shell` | به مدل اجازه می‌دهد هنگام برنامه‌ریزی، کد اجرا کند؛ برای چیدمان‌های دقیق، نمودارها و دیاگرام‌ها. وقتی خاموش باشد، کمیت‌ها و ترازبندی تقریبی می‌شوند. پیش‌فرض: true. | BOOLEAN | بله | true یا false (پیش‌فرض: true) |
| `seed` | بذر (Seed) برای تعیین اینکه آیا گره باید دوباره اجرا شود؛ API بذر ندارد، بنابراین نتایج واقعی بدون توجه به این مقدار غیرقطعی هستند. پیش‌فرض: 42. | INT | بله | 0 تا 2147483647 (گام: 1) |

### ورودی‌های مرجع

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `images` | شیار قابل افزایش: ۱ تا ۱۰ تصویر مرجع (از `image_1` تا `image_10`) را برای ویرایش یا ترکیب متصل کنید. در درخواست متنی به آن‌ها با `@Image1`، `@Image2`، ... ارجاع دهید، که به ترتیب ورودی شماره‌گذاری می‌شوند؛ یک ورودی دسته‌ای (batched) یک بار برای هر تصویر شمرده می‌شود. | IMAGE | بله | 1 تا 10 reference images |

توجه: درخواست متنی نباید خالی باشد، و هر ارجاع `@ImageN` که در آن وجود دارد باید با یکی از تصاویر متصل شده به ترتیب ورودی مطابقت داشته باشد (برای مثال، `@Image1` اولین تصویر مرجع متصل شده است). اگر درخواست متنی به شماره تصویری ارجاع دهد که متصل نیست، یا اگر بیش از ۱۰ تصویر مرجع متصل شوند، گره خطا ایجاد می‌کند.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `image` | تصویر ویرایش‌شده یا ترکیب‌شده‌ای که توسط مدل Muse Image بازگردانده می‌شود. اگر API چندین تصویر را بازگرداند، آن‌ها به‌صورت یک دسته (batch) بازگردانده می‌شوند. | IMAGE |

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

---
**Source fingerprint (SHA-256):** `5c009ca45199f9c70465f12d48a46b685abebd0194c3d437121b9df0636dbea7`
