# תפקידי ייחוס

> תנו לכל ייחוס תפקיד כגון פנים, בגדים, רקע או סגנון, נעלו את הזהות של נושא כשצריך, והזכירו ייחוסים בשם בתוך הפרומפט.

Source: https://nodaro.ai/he/docs/guides/reference-roles

**תפקיד ייחוס** אומר למודל מה לקחת מייחוס אחד: את הזהות שלו, את הלבוש שלו, את הרקע שלו, את הסגנון שלו ועוד. ייחוס יכול להיות תמונה רגילה או נכס דמות, מיקום, אובייקט או חיה, שמחובר לרכיב [יצירת תמונה](https://nodaro.ai/docs/nodes/image/generate-image) או [יצירת וידאו](https://nodaro.ai/docs/nodes/video/generate-video). Nodaro כותב את התפקיד של כל ייחוס לתוך הפרומפט כביטוי פשוט אחד, כך שהמודל יודע בדיוק באיזה חלק של איזו תמונה להשתמש.

## איך תפקיד מופיע בפרומפט
ייחוס עם תפקיד הופך לביטוי אחד בפרומפט הסופי:

| רכיב | הביטוי | איך ייחוסים מסומנים |
| --- | --- | --- |
| יצירת תמונה | `the {role} from reference image A` (ה-`{role}` מתמונת הייחוס A) | לפי אות: A, B, C |
| יצירת וידאו | `the {role} from @image_1` (ה-`{role}` מתוך `@image_1`) | לפי מספר: `@image_1`, `@image_2` |

התפקידים זהים בשני הרכיבים. תמונות רגילות ונכסים חולקים מספור אחד, ולכן שני ייחוסים לעולם לא מקבלים את אותו שם.

## תפקידי ברירת מחדל
ייחוס חדש מתחיל בתפקיד השימושי ביותר לסוג שלו, כך שהוא עובד בלי שום הגדרה:

| מקור מחובר | תפקיד ברירת המחדל |
| --- | --- |
| [נכס דמות](https://nodaro.ai/docs/nodes/assets/character) | אדם |
| [נכס מיקום](https://nodaro.ai/docs/nodes/assets/location) | מיקום |
| [נכס אובייקט/אביזר](https://nodaro.ai/docs/nodes/assets/object) | אובייקט |
| [נכס חיה/יצור](https://nodaro.ai/docs/nodes/assets/creature) | יצור |
| [יצירת פנים](https://nodaro.ai/docs/nodes/assets/create-face) | פנים |
| תמונה רגילה או העלאה | ייחוס בלבד |
| וידאו או אודיו | ייחוס בלבד |

## בחירת תפקיד
לחצו על התגית של ייחוס כדי לפתוח את תפריט התפקידים שלו. התפקידים השימושיים ביותר לסוג הזה מופיעים ראשונים, וברירת המחדל מודגשת. האפשרות **מותאם אישית…** נמצאת תמיד בסוף, לכל תפקיד שלא ברשימה.

| מקור | תפקידים שאפשר לבחור |
| --- | --- |
| **דמות** | ייחוס בלבד, **אדם**, פנים, בגדים, שיער, תנוחה, הבעה, סגנון |
| **מיקום** | ייחוס בלבד, **מיקום**, רקע, אווירה, כמו שהוא, רקע ריק, פריסה, תאורה, סגנון |
| **אובייקט** | **אובייקט**, צורה, חומר, צבע, מרקם, סגנון |
| **חיה או יצור** | **יצור**, אנטומיה, סימונים, תנוחה, צבע, סגנון |
| **תמונה רגילה** | **ייחוס בלבד**, אובייקט, אדם, פנים, בגדים, רקע, סגנון, תנוחה, מרקם |

שני תפקידים מופיעים כביטוי מלא יותר, כדי שהפרומפט יישאר טבעי:

| תפקיד | הניסוח בפרומפט |
| --- | --- |
| כמו שהוא | `reference image A, used as-is` (תמונת הייחוס A, כמו שהיא) |
| רקע ריק | `the background from reference image A (without its foreground objects)` (הרקע מתמונת הייחוס A, בלי האובייקטים שבחזית) |

### ייחוס בלבד
התפקיד **ייחוס בלבד** שולח את הייחוס בלי ביטוי שאומר מה לקחת ממנו. ברכיב תמונה הפרומפט כולל רק `reference image A`, וברכיב וידאו רק `@image_1`, `@video_1` או `@audio_1`. המודל רואה את הייחוס, אבל לא מקבל הוראה איך להשתמש בו. ייחוס בלבד הוא ברירת המחדל לתמונות, לסרטונים ולאודיו רגילים. לנכס דמות או מיקום אפשר לבחור אותו בכוונה; התגית שלו מציגה אז תג **ref** קטן.

### תפקידים מותאמים אישית
בחרו **מותאם אישית…** והקלידו כל מילה, כגון `dragon` (דרקון), `hoodie` (קפוצ׳ון) או `Danny`. תפקיד מותאם אישית יכול להכיל עד 32 תווים, ורווחים הופכים למקפים. הוא תופס את מקומו של התפקיד בביטוי: `the hoodie from reference image A` (הקפוצ׳ון מתמונת הייחוס A). שם פרטי נכנס כמו שנכתב: `Danny from reference image A` (Danny מתמונת הייחוס A).

## שילוב של כמה ייחוסים
חברו כמה ייחוסים, תנו לכל אחד תפקיד, ותארו איך הם משתלבים זה בזה:

```
פורטרט של האדם מתמונת הייחוס A, לובש את הבגדים מתמונת הייחוס B, עומד ברקע מתמונת הייחוס C ומואר בתאורה מתמונת הייחוס D.
```

הפרומפט המקורי באנגלית:

```
A portrait of the person from reference image A wearing the clothes from reference image B, standing in the background from reference image C, lit by the lighting from reference image D.
```

Workflow: דמות נותנת את האדם, תמונה אחת נותנת את הלבוש ואחרת נותנת את הרקע.

- העלאת תמונה → יצירת תמונה (ייחוסים)
- העלאת תמונה → יצירת תמונה (ייחוסים)
- נכס דמות → יצירת תמונה (נכסים)

**הסדר של הייחוסים.** הייחוסים ממוספרים ברצף אחד. התמונות שמחוברות לקלט **ייחוסים** באות קודם, ואחריהן הנכסים שמחוברים לקלט **נכסים**, כל קבוצה לפי סדר ההופעה. אותו מספור קובע את הפרומפט ואת התמונות שנשלחות למודל, ולכן תצוגת הפרומפט הסופי מציגה בדיוק מה שרץ.

## אזכור ייחוס בשם
אפשר למקם ייחוס בדיוק במקום שלו במשפט שלכם עם אזכור `@`.

### דמויות ומיקומים
הקלידו `@` בפרומפט ובחרו את הדמות או המיקום. אזכור יכול גם לבחור איזו תמונה לשלוח (ה**וריאציה**) ומה לקחת ממנה (ה**תפקיד**):

| אזכור | מה הוא עושה |
| --- | --- |
| `@abi:1:walking:clothes` | שולח את תמונת ההליכה של Abi ומוסיף `the clothes from reference image A` (הבגדים מתמונת הייחוס A) |
| `@abi:1:walking:ref-only` | שולח את תמונת ההליכה כ-`reference image A` בלבד |
| `@library:1:weather/rain:lighting` | שולח את וריאציית הגשם של המיקום ולוקח את התאורה שלה |

בפרומפט, אזכור הוא תגית עם שתי בקרות. לחצו על **התמונה הממוזערת** כדי להחליף את התמונה: מעבר לתמונה אחרת של אותה דמות שומר על התפקיד שלכם. לחצו על **התווית** כדי להחליף את התפקיד: התמונה נשארת, והאפשרות **ברירת מחדל** מחזירה את תפקיד ברירת המחדל.

### תמונות רגילות
תנו לרכיב [העלאת תמונה](https://nodaro.ai/docs/nodes/image/upload-image) **תווית**. התווית הופכת לשם האזכור של התמונה, ולכן לרכיב שהתווית שלו `Town` יש שם האזכור `@town:1`.

| אזכור | מה הוא עושה |
| --- | --- |
| `@town:1` | ממקם `reference image A` בדיוק במקום שהקלדתם אותו |
| `@town:1:background` | ממקם `the background from reference image A` (הרקע מתמונת הייחוס A) |
| `@town:1:signage` | כל מילה בודדת משלכם משמשת כתפקיד |
| `@town:1~lock` או `@town:1~nolock` | מפעיל או מכבה את נעילת הזהות לאזכור הזה |

אזכורים הם אופציונליים. תמונה בלי תווית עדיין נשלחת כמו קודם; פשוט אין לה שם שאפשר להזכיר. תווית שמתחילה בספרה, כגון `3D Render`, לא יכולה להפוך לשם אזכור, ולכן אם תרצו להזכיר את התמונה, שנו את התווית.

### יצורים ואובייקטים
נכסי חיה/יצור ואובייקט/אביזר משתמשים באותה צורה קצרה, עם השם והתפקידים שלהם. יצור בשם Nessie מוזכר כ-`@nessie:1`, ו-`@nessie:1:markings` לוקח את הסימונים שלו. העורך לא מציע את האזכורים האלה, ולכן הקלידו אותם ביד.

אזכור חשוב במיוחד ליצורים ולאובייקטים. יצור או אובייקט מחובר שלא מזכירים אותו עדיין מוסיף את הביטוי שלו, בסוף הפרומפט. כשמזכירים אותו, הביטוי מופיע פעם אחת, בתוך המשפט שלכם, והמודל מקשר אותו למה שכתבתם:

```
שוט רחב של ‎@nessie:1 עולה מהאגם
```

הפרומפט המקורי באנגלית:

```
A wide shot of @nessie:1 rising from the lake
```

הפרומפט הזה הופך ל-"A wide shot of the creature from reference image A rising from the lake" (שוט רחב של היצור מתמונת הייחוס A עולה מהאגם).

כששני סוגים חולקים אותו שם, הסוג שמופיע ראשון בסדר הזה גובר: דמות, מיקום, תמונה, יצור, אובייקט.

## נעילת הזהות של נושא
כברירת מחדל, Nodaro לא מוסיף הוראת זהות. הייחוסים מתנהגים כמו תמונות, והתפקיד לבדו מכתיב את התוצאה. כשאסור לנושא להשתנות, הפעילו את האפשרות **נעילת זהות** בייחוס הזה. הנעילה מוסיפה שורה אחת לפני שאר הפרומפט:

```
לנעול את הזהות המדויקת של האדם בתמונת הייחוס A — פנים, מבנה עצמות, גוון עור, כל המאפיינים הייחודיים.
```

הפרומפט המקורי באנגלית:

```
Lock the exact identity of the person in reference image A — face, bone structure, skin tone, all unique features.
```

- **לכל ייחוס.** הנעילה כבויה כברירת מחדל, ומפעילים אותה לכל ייחוס בנפרד. לכל סוג — אדם, פנים, יצור ומיקום — יש ניסוח מובנה משלו, ואפשר להחליף אותו בניסוח משלכם.
- **לכל אזכור.** בתפריט של אזכור דמות או מיקום, הפעילו את האפשרות **נעילת זהות**. לאזכור הזה מתווסף אז `~lock`, כגון `@kira:1:face~lock`, גם כשהנעילה של הייחוס עצמו כבויה.
- **כיבוי לאזכור אחד.** הקלידו `~nolock` אחרי אזכור, כגון `@kira:1:face~nolock`. הנעילה כבויה אז לאזכור הזה, גם כשהנעילה של הייחוס מופעלת. אזכור בלי אף אחד מהשניים פועל לפי ההגדרה של הייחוס.

במיקום, הנעילה שומרת על המקום עצמו ולא על פנים:

```
לנעול את המראה המדויק של תמונת הייחוס A — להתאים לארכיטקטורה, לפריסה ולתאורה של המיקום.
```

הפרומפט המקורי באנגלית:

```
Lock the exact look of reference image A — match the location's architecture, layout, and lighting.
```

## דרך ה-API
גם קוד וגם עוזרי AI יכולים לקבוע את התפקיד ואת נעילת הזהות של כל ייחוס. הם שולחים אותם כייחוסים בפורמט מובנה, יחד עם בקשות ליצירת תמונה ווידאו. ראו את דף ה-API [הרצת רכיב יחיד](https://nodaro.ai/docs/developers/api/nodes) ואת [מדריך כלי ה-MCP](https://nodaro.ai/docs/mcp/tools).

## טיפים
- **הזכירו יצורים ואובייקטים.** אזכור מכניס את הביטוי שלהם לתוך המשפט שלכם, במקום שבו המודל יכול לקשר אותו לפעולה שאתם מתארים.
- **נעלו רק מה שאסור לו להשתנות.** כשהנעילה כבויה, הפרומפט שלכם נשאר קצר ואתם שומרים על שליטה מלאה בניסוח. הפעילו אותה לנושאים שהזהות שלהם חייבת להישמר.
- **עגנו נושאים חוזרים.** לדמות שאתם משתמשים בה בהרבה שוטים, צרו [רשת עקביות](https://nodaro.ai/docs/guides/reference-boards) פעם אחת וחברו אותה כייחוס.
- **בדקו את הפרומפט הסופי.** פתחו את תצוגת הפרומפט הסופי של שדה הפרומפט כדי לראות כל ביטוי שהתפקידים שלכם מוסיפים.

## שאלות נפוצות

### מה זה תפקיד ייחוס?

תפקיד ייחוס הוא תווית קצרה שאומרת למודל באיזה חלק של הייחוס להשתמש, כגון הפנים, הבגדים, הרקע או הסגנון. Nodaro כותב אותו לתוך הפרומפט כביטוי כמו "the clothes from reference image B" (הבגדים מתמונת הייחוס B).

### למה לתמונת הייחוס הרגילה שלי אין תפקיד?

תמונות, סרטונים ואודיו רגילים מקבלים בהתחלה את התפקיד ייחוס בלבד. המודל מקבל את הייחוס בלי שאומרים לו מה לקחת ממנו. לחצו על התגית של הייחוס כדי לבחור תפקיד כגון רקע או סגנון.

### מה נעילת הזהות עושה?

נעילת הזהות מוסיפה לפרומפט שורה אחת שאומרת למודל לשמור על הזהות המדויקת של הנושא בייחוס הזה, כגון הפנים ומבנה העצמות של אדם. היא כבויה כברירת מחדל. הפעילו אותה לכל ייחוס שאסור לו להשתנות.

### איך מזכירים בפרומפט תמונה שהעליתי?

תנו לרכיב העלאת תמונה תווית, כגון Town. לתמונה יש אז שם אזכור, ‎@town:1, והאזכור ‎@town:1:background אומר למודל לקחת ממנה את הרקע.

### האם תפקידים עובדים גם ברכיבי תמונה וגם ברכיבי וידאו?

כן. התפקידים זהים ברכיבי יצירת תמונה ויצירת וידאו. רק אופן הסימון של ייחוס בפרומפט שונה: אות ברכיבי תמונה ומספר ברכיבי וידאו.