# Tencent HY Image: Edit

گره Tencent HY Image: Edit تصاویر مرجع را بر اساس یک دستور متنی و با مدل Hunyuan Image شرکت Tencent ویرایش یا ترکیب می‌کند. یک تا پنج تصویر را متصل کنید، تغییر موردنظر را در `prompt` توضیح دهید و به تصاویر با `@Image1`، `@Image2` و به همین ترتیب ارجاع دهید. این گره تصاویر مرجع را بارگذاری می‌کند، درخواست را به API می‌فرستد و نتیجه ویرایش‌شده را برمی‌گرداند.

## ورودی‌ها

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

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `مدل` | مدلی که برای ویرایش استفاده می‌شود. مدل انتخاب‌شده تعیین می‌کند که کدام ورودی‌های اضافی نمایش داده شوند. | DYNAMIC_COMBO | بله | `"hy-image-3.5-preview"` |

### ورودی‌های hy-image-3.5-preview

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `prompt` | دستورهای ویرایش. از ارجاع‌های سبک `@Image1` به تصاویر متصل‌شده پشتیبانی می‌کند. نباید خالی باشد (پیش‌فرض: خالی). | STRING | بله | هر متنی |
| `aspect_ratio` | نسبت ابعاد خروجی. `"auto"` از نسبت ابعاد نخستین تصویر مرجع پیروی می‌کند و در 4K در دسترس نیست. زمانی که `resolution` روی `"custom"` باشد نادیده گرفته می‌شود. | COMBO | بله | `"auto"`<br>`"1:1"`<br>`"3:2"`<br>`"2:3"`<br>`"4:3"`<br>`"3:4"`<br>`"16:9"`<br>`"9:16"`<br>`"21:9"`<br>`"9:21"` (پیش‌فرض: `"auto"`) |
| `resolution` | مساحت پیکسلی خروجی: 1K حدود 1024x1024 است، 2K حدود 2048x2048 و 4K حدود 4096x4096. هر مقداری بالاتر از 2K در 2K رندر می‌شود و توسط مدل بزرگ‌نمایی می‌شود. برای استفاده از `width` و `height` به‌جای یک مساحت از پیش تعیین‌شده، آن را روی `"custom"` قرار دهید. | COMBO | بله | `"1K"`<br>`"2K"`<br>`"4K"`<br>`"custom"` (پیش‌فرض: `"2K"`) |
| `width` | عرض خروجی بر حسب پیکسل. تنها زمانی استفاده می‌شود که `resolution` روی `"custom"` باشد. | INT | بله | 256-8192، گام‌های 16 (پیش‌فرض: 2048) |
| `height` | ارتفاع خروجی بر حسب پیکسل. تنها زمانی استفاده می‌شود که `resolution` روی `"custom"` باشد. | INT | بله | 256-8192، گام‌های 16 (پیش‌فرض: 2048) |
| `seed` | بذر استفاده‌شده برای تولید. نتایج همچنان بین اجراها با بذر یکسان متفاوت است. | INT | بله | 0-2147483647 (پیش‌فرض: 42) |
| `reference_detail` | میزان جزئیاتی که مدل از تصاویر مرجع می‌بیند: `"standard"` تا 1024x1024 پیکسل برای هر تصویر را مجاز می‌کند، `"high"` تا 2048x2048 و متن‌های کوچک و جزئیات ریز را بهتر حفظ می‌کند، اما زمان بیشتری می‌گیرد. این یک پارامتر پیشرفته است. | COMBO | خیر | `"standard"`<br>`"high"` (پیش‌فرض: `"standard"`) |
| `watermark` | آیا واترمارک تولیدشده توسط هوش مصنوعی به نتیجه اضافه شود یا نه. این یک پارامتر پیشرفته است. | BOOLEAN | خیر | true<br>false (پیش‌فرض: false) |

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

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `images` | تصاویر مرجعی که باید ویرایش یا ترکیب شوند. جای‌گاه قابل‌گسترش: 1 تا 5 تصویر را متصل کنید (`image_1` تا `image_5`). در `prompt` با `@Image1` ... `@Image5` به آن‌ها ارجاع دهید، که به ترتیب ورودی شماره‌گذاری می‌شوند؛ ورودی دسته‌ای برای هر تصویر یک بار شمرده می‌شود. | IMAGE | بله | 1-5 تصویر |

`prompt` نباید خالی باشد، و ارجاعی مانند `@Image3` در `prompt` زمانی که تنها 1 یا 2 تصویر متصل است خطا ایجاد می‌کند. در مجموع حداکثر 5 تصویر مرجع می‌تواند استفاده شود، و هر تصویر از یک دسته جداگانه شمرده می‌شود. با `resolution` روی `"custom"`، `width` و `height` باید هر دو مضربی از 16 باشند و حاصل‌ضرب آن‌ها نباید از محدودیت مساحت 4096 x 4096 پیکسل (حدود 16.7 مگاپیکسل) فراتر رود؛ هر نسبت ابعادی کار می‌کند، هرچند فراتر از حدود 6:1 مدل شروع به تکرار سوژه می‌کند. نسبت ابعاد `"auto"` فقط در محدودیت مساحت 2K کار می‌کند، بنابراین در 4K یک نسبت ابعاد صریح انتخاب کنید یا از `"custom"` استفاده کنید.

## خروجی‌ها

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

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

---
**Source fingerprint (SHA-256):** `46c112347b51a2983521f87bbeb047289515f4073c48ba5d909fd3bae4597633`
