# יצירת תסריט

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

Source: https://nodaro.ai/he/docs/nodes/video/generate-script

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

- Found in: Video › Story & Script
- Output: text
- API type: `generate-script`

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

לסרט שלם שנוצר בשבילכם מפרומפט אחד, השתמשו ברכיב [סיפור ← וידאו](https://nodaro.ai/docs/nodes/video/story-to-video).

## התחלה מהירה
### הוספת הרכיב
הקישו Tab על הקנבס ובחרו **וידאו › סיפור ותסריט › יצירת תסריט**.

### תיאור הסרטון
הוסיפו רכיב [טקסט](https://nodaro.ai/docs/nodes/automate/text), הקלידו בו את הנושא, את הסיפור או את הקונספט, וחברו אותו לקלט **פרומפט** של רכיב יצירת תסריט. היו ספציפיים: "30-second product ad for a fitness app showing a morning routine" (פרסומת מוצר של 30 שניות לאפליקציית כושר, שמראה שגרת בוקר) עובד טוב יותר מאשר "make a video" (צור סרטון).

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

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

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

- טקסט → יצירת תסריט (פרומפט)
- יצירת תסריט → יצירת תמונה (תמונות)
- יצירת תסריט → טקסט לדיאלוג (דיאלוג)
- יצירת תסריט → יצירת מוזיקה (מוזיקה)

## קלטים ופלטים
לרכיב יצירת תסריט יש 5 קלטים בצד שמאל שלו:

| קלט | מקבל | מה הוא עושה |
| --- | --- | --- |
| **פרומפט** | רכיבי טקסט, כגון [טקסט](https://nodaro.ai/docs/nodes/automate/text) או [יצירת טקסט - כל LLM](https://nodaro.ai/docs/nodes/automate/prompt) | הנושא, הסיפור או הקונספט. נדרש: לרכיב אין תיבת פרומפט משלו. |
| **טון** | רכיב [טון](https://nodaro.ai/docs/nodes/settings/tone), או כל רכיב טקסט | קובע את ההגדרה **טון**. |
| **מדריך סגנון** | רכיב [מדריך סגנון](https://nodaro.ai/docs/nodes/settings/style-guide), או כל רכיב טקסט | קובע את ההגדרה **מדריך סגנון**. |
| **מספר סצנות** | רכיב [מספר סצנות](https://nodaro.ai/docs/nodes/settings/scene-count) | קובע את ההגדרה **מספר סצנות**, מ-1 עד 20. |
| **משך** | רכיב [משך](https://nodaro.ai/docs/nodes/settings/duration) | קובע את ההגדרה **אורך יעד (שניות)**, מ-5 עד 600. |

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

כל אחד מ-7 הפלטים מעביר חלק אחד של התסריט הפעיל:

| פלט | מה הוא מעביר | לאן לחבר אותו |
| --- | --- | --- |
| **סצנות** | התסריט כטקסט: פרומפט התמונה של הסצנה הראשונה. | קלט טקסט. |
| **תמונות** | פרומפט התמונה של כל סצנה. | הקלט **פרומפט** של רכיב [יצירת תמונה](https://nodaro.ai/docs/nodes/image/generate-image). כשיש 2 סצנות או יותר, רכיב יצירת תמונה רץ פעם אחת לכל סצנה. |
| **דיאלוג** | כל שורות הדיאלוג של התסריט, עם הדובר והרגש. | רכיב [טקסט לדיאלוג](https://nodaro.ai/docs/nodes/audio/text-to-dialogue). לחצו על **מילוי N שורות מהתסריט** בהגדרות שלו כדי להעתיק את השורות. כשלרכיב טקסט לדיאלוג אין שורות משלו, הוא משתמש בשורות של התסריט כשהוא רץ. |
| **מוזיקה** | תיאורי אווירת המוזיקה של כל הסצנות, כל תיאור פעם אחת, מאוחדים לטקסט אחד. | הפרומפט של רכיב [יצירת מוזיקה](https://nodaro.ai/docs/nodes/audio/generate-music). |
| **אפקטים קוליים** | אפקטי הקול של כל הסצנות, מאוחדים לטקסט אחד. | הפרומפט של רכיב [טקסט לאודיו](https://nodaro.ai/docs/nodes/audio/text-to-audio). |
| **דמויות** | הדמויות של התסריט, כל דמות פעם אחת, עם שם, תיאור, מצב־רוח, פעולה ומיקום בפריים. | רכיבים שקוראים דמויות מהתסריט. |
| **מיקומים** | המיקומים של התסריט, כל מיקום פעם אחת, עם שם, תיאור, שעה ביום, מזג אוויר ותאורה. | רכיבים שקוראים מיקומים מהתסריט. |

## הגדרות
| הגדרה | מה היא עושה |
| --- | --- |
| **מודל AI** | מודל הטקסט שכותב את התסריט. ברירת המחדל היא Gemini 3.6 Flash. אפשר לחפש לפי שם, יצרן או רמה. |
| **מאמץ חשיבה** | כמה המודל חושב לפני שהוא כותב, במודלים שתומכים בכך. |
| **מצב מתקדם** | זמין במודלי Gemini ו-Claude. מריץ את המודל עם הבקרות של היצרן עצמו, כך שההגדרות **טמפרטורה** ו**מקסימום טוקנים** וטווח החשיבה המלא נכנסים לתוקף. הבקרות האלה מופיעות כשהמצב מופעל. הקריאה מחויבת אז בתעריף של השירות של היצרן עצמו. במודל Claude, בחירה בכל רמה של **מאמץ חשיבה** מריצה את המודל באותו אופן ובאותו תעריף. במודלים אחרים, המתג מושבת ולצידו מוצגת הסיבה. |
| **מספר סצנות** | כמה סצנות לכתוב, מ-1 עד 20. ברירת המחדל היא 5. אפשר לקבוע אותו גם דרך הקלט **מספר סצנות**. |
| **מדריך סגנון** | הוראות חזותיות ונרטיביות לכל סצנה, כגון פלטת צבעים, תקופה או ייחוס חזותי. מדריך הסגנון נשלח למודל יחד עם הנושא, ואפשר לציין בו רכיבים אחרים בצורה `{Node Label}`. אפשר לקבוע אותו גם דרך הקלט **מדריך סגנון**. |
| **טון** | הטון הרגשי של התסריט כולו, למשל שובב, דרמטי או לימודי, עד 200 תווים. אפשר לקבוע אותו גם דרך הקלט **טון**, מרכיב טון או מכל רכיב טקסט. |
| **אורך יעד (שניות)** | האורך הכולל שלפיו התסריט מתוכנן, מ-5 עד 600 שניות. ברירת המחדל היא 60. ה-AI מחלק אותו בין הסצנות, ולכן האורך של כל סצנה יכול להשתנות. אפשר לקבוע אותו גם דרך הקלט **משך**. |
| **טקסט לפני ואחרי** | טקסט שמתווסף לפני הפרומפט ואחריו כשהרכיב רץ, אבל לא למדריך הסגנון. הטקסט מוסתר מאנשים שמשתמשים בתהליך שלכם כאפליקציה. ראו את הדף [טקסט לפני ואחרי הפרומפט](https://nodaro.ai/docs/concepts/prompt-pre-post-text). |

כדי לשמור את הערכים האלה במקום אחד לכמה תסריטים, חברו רכיבי [הגדרות יצירה](https://nodaro.ai/docs/nodes/settings) לקלטים המתאימים במקום להקליד אותם.

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

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

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

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

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

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

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

- **לפני ההרצה**, הכפתור **הרצה** מציג אומדן (`≈` ומספר) של תסריט טיפוסי במודל שנבחר. ברירת המחדל, Gemini 3.6 Flash, עולה פחות מ-Claude Sonnet 5.5.
- **תסריט ארוך יותר עולה יותר.** עם יותר סצנות או אורך יעד ארוך יותר, המודל כותב יותר טקסט.
- **השריון בא קודם.** כשההרצה מתחילה, Nodaro משריין מספיק קרדיטים לתשובה הארוכה ביותר שהמודל עשוי לכתוב. אחרי הקריאה, ההרצה מחויבת לפי השימוש בפועל.
- ל**מאמץ חשיבה** אין מחיר משלו. **מצב מתקדם**, וכל מאמץ חשיבה במודל Claude, מריצים את הקריאה בשירות של היצרן עצמו, בתעריף של אותו שירות. תג העלות ברכיב מתעדכן כשמפעילים את המתג **מצב מתקדם**.
- **כשלים.** על תסריט שיצרן המודל חייב עליו, אבל שאי אפשר היה לקרוא ממנו את הסצנות, משלמים לפי השימוש הזה. על כשל שלא חויב, הקרדיטים מוחזרים.

הכללים המלאים מפורטים בסעיף [איך מחויבות קריאות LLM](https://nodaro.ai/docs/concepts/credits#llm-calls) בדף קרדיטים. כדי להשוות בין מודלים, ראו את המדריך [בחירת מודל](https://nodaro.ai/docs/guides/choosing-models).

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

## פתרון בעיות
**ההרצה נעצרת עם "needs a topic" (צריך נושא) או ״לא נמצא פרומפט״.** לרכיב אין על מה לכתוב. חברו רכיב [טקסט](https://nodaro.ai/docs/nodes/automate/text) עם הנושא, הסיפור או הקונספט לקלט **פרומפט**. הקלטים **טון**, **מדריך סגנון**, **מספר סצנות** ו**משך** קובעים רק הגדרות; הם לא נושא. ההרצה נעצרת עוד לפני שהיא מתחילה, ולכן אין חיוב.

## דרך ה-API
הנתיב `POST /v1/generate-script` כותב תסריט מתוך קוד. הנתיב מחזיר מיד `jobId`. התסריט המוכן נמצא ב-`output_data.script` של המשימה, עם `title`, `totalDuration` ו-`scenes`. ראו את דף ה-API [משימות](https://nodaro.ai/docs/developers/api/jobs).

| שדה | מה הוא עושה |
| --- | --- |
| `prompt` | נדרש. הנושא, הסיפור או הקונספט, עד 100,000 תווים. |
| `sceneCount` | **מספר סצנות**, מ-1 עד 20. ברירת המחדל היא 5. |
| `targetDuration` | **אורך יעד (שניות)**, מ-5 עד 600. ברירת המחדל היא 60. |
| `tone` | **טון**, עד 200 תווים. |
| `styleGuide` | **מדריך סגנון**, עד 100,000 תווים. |
| `llmModel` | מודל הטקסט. ברירת המחדל היא `gemini-3.6-flash`. |
| `reasoningEffort` | `none`, `low`, `medium`, `high`, `xhigh` או `max`. |
| `advancedMode`, `temperature`, `maxTokens` | **מצב מתקדם** והבקרות שלו, במודלי Gemini ו-Claude. |

כלי ה-MCP הוא [`generate_script`](https://nodaro.ai/docs/mcp/tools/prompts-and-text#generate_script), שמקבל את מדריך הסגנון בתור `style_guide`. ראו גם את דף ה-API [הרצת רכיב יחיד](https://nodaro.ai/docs/developers/api/nodes).

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

### מה מפיק רכיב יצירת תסריט?

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

### איך יוצרים תמונה אחת לכל סצנה?

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

### כמה קרדיטים עולה רכיב יצירת תסריט?

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

### כמה סצנות כדאי לבקש?

ברכיב יצירת תסריט, סצנה אחת בערך לכל 5–10 שניות של וידאו מתאימה לרוב הפורמטים. ההגדרה מספר סצנות מקבלת ערך מ-1 עד 20, וההגדרה אורך יעד קובעת את האורך הכולל שה-AI מתכנן.