# רצף שוטים ובמאי וידאו

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

Source: https://nodaro.ai/he/docs/mcp/tools/shot-sequence-and-video-director

**כלי במאי הווידאו ורצף השוטים** יוצרים סרטוני גרפיקת תנועה עם קריינות: טיפוגרפיה קינטית, צורות ותמונות שמופיעות ברגע שהקריינות אומרת את הביטוי שלהן. כלי במאי הווידאו עושים זאת בקריאה אחת; כלי רצף השוטים מאפשרים להריץ כל שלב בנפרד. הדף הזה מפרט את הפרמטרים. הדפים [במאי וידאו](https://nodaro.ai/docs/mcp/video-director) ו[רצף שוטים](https://nodaro.ai/docs/mcp/shot-sequence) מסבירים איך להשתמש בהם.

| כלי | הרשאה | קרדיטים |
| --- | --- | --- |
| `start_video_director` | אין | חינם |
| `create_explainer` | `workflows:execute` | הרצת הכתיבה, הקריינות והרינדור, ובנוסף יישור מאולץ כשלקריינות אין זמני מילים. ב-Nodaro Cloud בלבד. |
| `create_launch_video` | `workflows:execute` | כמו ב-`create_explainer`. ב-Nodaro Cloud בלבד. |
| `list_shot_shapes` | אין | חינם |
| `get_shot_shape` | אין | חינם |
| `list_brand_presets` | אין | חינם |
| `forced_alignment` | `workflows:execute` | 33 |
| `resolve_shot_sequence` | `workflows:execute` | חינם, בלי משימה |
| `render_shot_sequence` | `workflows:execute` | 55 |

## `start_video_director`
מחזיר את המדריך של הבמאי, שעוזר AI פועל לפיו כדי לכתוב בעצמו סרטון עם קריינות: איך לבחור ז׳אנר וקשת סיפורית, לכתוב את הקריינות כביטויים שמשמשים סימני זמן, לבנות בריף של רצף שוטים ולהריץ את הפייפליין. הכלי לא משנה כלום, ואפשר לקרוא לו מספר בלתי מוגבל של פעמים.

לכלי הזה אין פרמטרים.

## `create_explainer`
כותב ומרנדר סרטון הסבר עם קריינות ותזמון מדויק על נושא מסוים, בקריאה אחת. הבמאי כותב את תסריט הקריינות ואת הבריף של רצף השוטים, יוצר את הקריינות, מיישר אותה מילה אחר מילה ומרנדר את ה-MP4.

**הרשאה:** `workflows:execute`. **קרדיטים:** הרצת הכתיבה, ובנוסף הקריינות והרינדור, ויישור מאולץ כשלקריינות אין זמני מילים; הכלי `list_models` מציג את המחיר תחת `video-director`. **ב-Nodaro Cloud בלבד.**

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `topic` | string | **נדרש.** מה סרטון ההסבר צריך ללמד, בין 1 ל-8,000 תווים. |
| `brand` | string או object | מזהה של ערכת מותג, כגון `cobalt-corporate`, או הגדרות מותג משלכם. הפרטים בהמשך. |

**מה חוזר:** מזהה משימה. הכרטיס מציג את ההתקדמות ומנגן את הסרטון. בלי כרטיסים, בדקו את הסטטוס מדי כמה שניות עם `get_job`; קובץ ה-MP4 נמצא ב-`output_data.videoUrl`.

## `create_launch_video`
כותב ומרנדר סרטון השקת מוצר עם קריינות מתוך תיאור של המוצר, בקריאה אחת.

**הרשאה:** `workflows:execute`. **קרדיטים:** כמו ב-`create_explainer`. **ב-Nodaro Cloud בלבד.**

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `brief` | string | המוצר: מה הוא, למי הוא מיועד, התכונות העיקריות שלו והטון. בין 1 ל-8,000 תווים. |
| `brand` | string או object | כמו ב-`create_explainer`. |
| `url` | string | כתובת URL של מוצר לצילום. לא נתמך: בלי `brief`, הכלי עונה שהוא צריך בריף; עם בריף, הכלי מתעלם מהכתובת. |

**מה חוזר:** מזהה משימה.

### האובייקט `brand`
| שדה | הערות |
| --- | --- |
| `palette` | **נדרש.** צבעי hex: השדות `bg`, `text` ו-`accent` נדרשים; השדות `accent2`, `bgAlt`, `line` ו-`textMuted` הם אופציונליים. |
| `fonts` | **נדרש.** השדות `heading` ו-`body`, כל אחד מהם הוא אחת מ-24 משפחות הגופנים הנתמכות, כגון Inter, Montserrat, Playfair Display או Bebas Neue. הגופנים Rubik, Heebo, Cairo ו-Tajawal תומכים בעברית ובערבית. השדות האופציונליים `headingType` ו-`bodyType` קובעים `weight` (מ-100 עד 900), `casing` (`uppercase`, `lowercase` או `none`) ו-`tracking` (מ-`-0.2` עד `0.5` em). |
| `logo` | אופציונלי. השדה `name` נדרש: הטקסט של שם המותג. השדה `tagline`: שורה מתחת ללוגו. השדה `image`: כתובת `https` של קובץ PNG, WebP או JPEG שהועלה ל-Nodaro. השדה `imageBackdrop`: צבע hex למשטח שמאחורי התמונה. |

## `list_shot_shapes`
מחזיר את הקטלוג של 15 השרטוטים של רצף השוטים: ביטים מונפשים מוכנים, כגון `kinetic-type-beats` או `titlecard-reveal`, עם התפקידים, התיאור ואורך ברירת המחדל שלהם בפריימים. קראו לכלי לפני שאתם כותבים בריף, כדי לבחור שרטוט לכל ביט.

לכלי הזה אין פרמטרים.

## `get_shot_shape`
מחזיר שרטוט אחד בפירוט: התפקידים, התיאור ואורך ברירת המחדל שלו, סכמת ה-JSON של ה-`params` שלו ודוגמה ממולאת שאפשר להדביק בבריף.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `id` | string | **נדרש.** מזהה של שרטוט, כגון `titlecard-reveal`. מזהה לא מוכר מחזיר שגיאה עם רשימת המזהים המוכרים. |

## `list_brand_presets`
מחזיר את 8 ערכות המותג, כגון `midnight-violet` ו-`editorial-cream`. כל ערכה היא שילוב של פלטה וגופנים שיש לו שם, ולכל אחת יש תווית, אווירה, תיאור, פלטה וגופנים. העבירו מזהה של ערכה בפרמטר `brand` כדי לשמור על עקביות בכל הסצנות.

לכלי הזה אין פרמטרים.

## `forced_alignment`
מיישר תמליל ידוע לקליפ אודיו או וידאו, ומחזיר את זמן ההתחלה וזמן הסיום של כל מילה. רצועת הדיבור של סרטון מחולצת קודם, כך שאפשר ליישר ישירות קליפ של ראש מדבר. הכלי עובד כמו רכיב [יישור מאולץ](https://nodaro.ai/docs/nodes/audio/forced-alignment).

**הרשאה:** `workflows:execute`. **קרדיטים:** 33.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `transcript` | string | **נדרש.** המילים המדויקות שנאמרות, עד 50,000 תווים. ברצף שוטים: תסריט הקריינות המדויק. |
| `audio_url` או `audio_asset_id` | string | האודיו או הווידאו, ככתובת URL או כמזהה משימה של Nodaro. |

**מה חוזר:** מזהה משימה. היישור נמצא ב-`output_data.alignment`: רשימה של `{ word, start, end }`, בשניות.

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

**הרשאה:** `workflows:execute`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `brief` | object | **נדרש.** הבריף של רצף השוטים: קריינות, סצנות, שוטים וחשיפות. |
| `audio_url` | string | **נדרש.** האודיו של הקריינות. |
| `alignment` | array | **נדרש.** ה-`output_data.alignment` של `forced_alignment`. |

**מה חוזר:** `plan` ו-`warnings`, למשל על סימן זמן שלא נמצא ועבר לתזמון יחסי כחלופה. כשהסצנות חופפות בזמן, הכלי מחזיר `422 scene_overlap`. כאן תמונת הלוגו של המותג לא נוספת אוטומטית: כדי להציג אותה, הוסיפו בעצמכם חשיפה מסוג `logo-assemble-lockup`.

## `render_shot_sequence`
מרנדר תוכנית מוכנה לקובץ MP4. הסרטון נשמר גם בספרייה שלכם.

**הרשאה:** `workflows:execute`. **קרדיטים:** כמו ברכיב [רינדור וידאו](https://nodaro.ai/docs/nodes/video/render-video): 55, בכל גודל פריים.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `plan` | object | **נדרש.** התוכנית מ-`resolve_shot_sequence`. |

**מה חוזר:** מזהה משימה. הכרטיס מציג את ההתקדמות ומנגן את הסרטון.

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

### מה ההבדל בין create_explainer לבין כלי רצף השוטים?

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

### האם במאי הווידאו יכול להשתמש בצבעים ובלוגו של המותג שלי?

כן. העבירו בפרמטר brand מזהה של ערכה מהכלי list_brand_presets, או פלטה, גופנים ולוגו משלכם. תמונת לוגו חייבת להיות תמונה שהועלתה ל-Nodaro, בפורמט PNG, WebP או JPEG.

### אילו כלים בקבוצה הזו לא עולים כלום?

הכלים start_video_director, list_shot_shapes, get_shot_shape, list_brand_presets ו-resolve_shot_sequence לא עולים כלום. הכלים forced_alignment ו-render_shot_sequence מוציאים קרדיטים, וכך גם שני הכלים שעובדים בקריאה אחת.