# Tencent HY Image: טקסט לתמונה

הצומת Tencent HY Image: Text to Image מייצר תמונה מתיאור טקסט באמצעות מודל Hunyuan Image של Tencent. ההנחיה נשלחת ל-API, שמשכתב ומרחיב אותה לפני הרינדור, והתמונה המוגמרת מוחזרת כמקבץ תמונות.

## קלטים

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

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `model` | המודל המשמש ליצירה. המודל הנבחר קובע אילו קלטים נוספים יוצגו. | DYNAMIC_COMBO | כן | `"hy-image-3.5-preview"` |

### קלטים של hy-image-3.5-preview

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `prompt` | מתאר את התמונה ליצירה. המודל משכתב ומרחיב אותו לפני הרינדור. אסור שיהיה ריק (ברירת מחדל: ריק). | 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) |
| `watermark` | האם להוסיף לתוצאה סימן מים שנוצר ב-AI. זהו פרמטר מתקדם. | BOOLEAN | לא | true<br>false (ברירת מחדל: false) |

`prompt` לא יכול להיות ריק. עם רזולוציית `"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/HunyuanImageTextToImageApi/he.md)

---
**Source fingerprint (SHA-256):** `1d4e70d688c5aa4e79b81447da559e201078454077da34769f2a4f544fbba63f`
