# Tencent HY Image: עריכה

צומת Tencent HY Image: Edit עורך או משלב תמונות עזר לפי הוראת טקסט באמצעות מודל Hunyuan Image של Tencent. חברו בין תמונה אחת לחמש תמונות, תארו את השינוי בפרומפט והתייחסו לתמונות כ-`@Image1`, `@Image2` וכן הלאה. הצומת מעלה את תמונות העזר, שולח את הבקשה ל-API ומחזיר את התוצאה הערוכה.

## קלטים

### קלטים משותפים

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `model` | המודל המשמש לעריכה. המודל הנבחר קובע אילו קלטים נוספים יוצגו. | 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 ומוגדל על ידי המודל. הגדירו ל-`"custom"` כדי להשתמש ב-`width` וב-`height` במקום בשטח קבוע מראש. | 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` | Seed המשמש ליצירה. התוצאות עדיין משתנות בין הרצות עם אותו seed. | INT | כן | 0-2147483647 (ברירת מחדל: 42) |
| `reference_detail` | כמה פירוט מתמונות העזר המודל רואה: `"standard"` מאפשר עד 1024x1024 פיקסלים לתמונה, `"high"` עד 2048x2048 ומשמר טקסט קטן ופרטים עדינים טוב יותר, אך אורך יותר זמן. זהו פרמטר מתקדם. | COMBO | לא | `"standard"`<br>`"high"` (ברירת מחדל: `"standard"`) |
| `watermark` | האם להוסיף סימן מים שנוצר על ידי AI לתוצאה. זהו פרמטר מתקדם. | BOOLEAN | לא | true<br>false (ברירת מחדל: false) |

### קלטי עזר

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `images` | תמונות העזר לעריכה או לשילוב. חריץ מתרחב: חברו 1 עד 5 תמונות (`image_1` עד `image_5`). התייחסו אליהן בפרומפט כ-`@Image1` ... `@Image5`, ממוספרות לפי סדר הקלט; קלט מקובץ נספר פעם אחת לכל תמונה. | IMAGE | כן | 1-5 תמונות |

`prompt` אסור שיהיה ריק, והפניה בפרומפט כגון `@Image3` מעלה שגיאה כאשר מחוברות רק 1 או 2 תמונות. ניתן להשתמש בסך הכל ב-5 תמונות עזר לכל היותר, כאשר כל תמונה באצווה נספרת בנפרד. עם רזולוציית `"custom"`, גם `width` וגם `height` חייבים להיות כפולות של 16 והמכפלה שלהם לא תעלה על מגבלת שטח של 4096 x 4096 פיקסלים (כ-16.7 מגה-פיקסלים); כל יחס גובה-רוחב עובד, אם כי מעבר ל-6:1 בערך המודל מתחיל לחזור על הנושא. יחס הגובה-רוחב `"auto"` עובד רק במגבלת שטח 2K, לכן ב-4K בחרו יחס גובה-רוחב מפורש או השתמשו ב-`"custom"`.

## פלטים

| שם פלט | תיאור | סוג נתונים |
|-------------|-------------|-----------|
| `IMAGE` | התמונה הערוכה שנוצרה מתמונות העזר ומהפרומפט. | IMAGE |

> מסמך זה נוצר על ידי בינה מלאכותית. אם מצאתם שגיאות או שיש לכם הצעות לשיפור, אתם מוזמנים לתרום! [עריכה ב-GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanImageEditApi/he.md)

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