# פייפליינים

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

Source: https://nodaro.ai/he/docs/mcp/tools/pipelines

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

כלי הפייפליינים קיימים רק ב-Nodaro Cloud. הם מופיעים רק אם אישרתם את ההרשאות `pipelines:read`, `pipelines:execute` ו-`pipelines:approve`.

## השלבים
פייפליין מריץ את השלבים האלה לפי הסדר: `script`, `characters`, `objects`, `locations`, `shot_list`, `scene_images`, `animate_audio_edit` ו-`post_merge`. במצב `auto` הוא מריץ את כולם בעצמו, ועוצר רק כשמאץ׳ קאט מתוכנן בין שני שוטים נשבר. ההרצה ממתינה אז עד שכל שבירה מאושרת דרך ה-[REST API](https://nodaro.ai/docs/developers/api/pipelines#match-cut-breaks-in-the-scene-images-stage). אין כלי MCP שמאשר שבירה. במצבים `manual` ו-`guided` הפייפליין עוצר בנקודות אישור, והשלב ממתין עם הסטטוס `awaiting_approval`.

## `start_pipeline`
מתחיל פייפליין חדש של **סיפור ← וידאו** מפרומפט של סיפור.

**הרשאה:** `pipelines:execute`. **קרדיטים:** הקרדיטים של כל יצירה שהפייפליין מריץ. הכלי `get_pipeline_status` מציג את הקרדיטים תוך כדי ההרצה.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `story_prompt` | string | **נדרש.** על מה הסרט, עד 4,000 תווים. |
| `format` | string | `trailer`, `short_film`, `music_video`, `reel` או `commercial`. ברירת המחדל: `reel`. |
| `target_duration_seconds` | integer | אורך הסרט, מ-5 עד 600 שניות. ברירת המחדל: `15`. |
| `mode` | string | המצב `auto` (ברירת המחדל) רץ עד הסוף בלי השגחה, ועוצר רק בשבירת מאץ׳ קאט. המצבים `manual` ו-`guided` עוצרים בנקודות אישור. |
| `output_resolution` | string | `480p`, `720p`, `1080p` או `4K`. ברירת המחדל: `720p`. |
| `music_enabled` | boolean | מוסיף מוזיקה. ברירת המחדל: `true`. |
| `narration_enabled` | boolean | מוסיף קריינות. ברירת המחדל: `false`. |
| `lipsync_enabled` | boolean | מסנכרן את השפתיים של הדמויות לשורות שלהן. ברירת המחדל: `false`. |

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

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

## `get_pipeline_status`
מחזיר את הנתונים העדכניים של פייפליין: הסטטוס שלו (`queued`, `running`, `awaiting_approval`, `completed`, `failed`, `cancelled` או `forked`), השלב הנוכחי, מוני הקרדיטים, המצב שבו הוא רץ ו-`failure_reason` כשהוא נכשל.

**הרשאה:** `pipelines:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `pipeline_id` | string | **נדרש.** מזהה הפייפליין. |

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

**הרשאה:** `pipelines:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `pipeline_id` | string | **נדרש.** מזהה הפייפליין. |

## `chat_pipeline_stage`
שולח הודעה לבמאי החידוד על שלב שממתין לאישור, למשל ״הפוך את הסוף לאפל יותר״. הפייפליין חייב להיות במצב `guided`.

**הרשאה:** `pipelines:approve`.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `pipeline_id` | string | **נדרש.** מזהה הפייפליין. |
| `stage` | string | **נדרש.** השלב שממתין: הערך `script` או `post_merge`. |
| `message` | string | **נדרש.** ההודעה שלכם, עד 8,000 תווים. |

**מה חוזר:** התשובה של הבמאי, וכשהוא מציע שינוי, גם `proposed_change`. כדי להחיל את השינוי, קראו ל-`apply_chat_proposal`.

## `apply_chat_proposal`
מקבל את השינוי שהבמאי הציע באחת התשובות שלו, ומאשר את השלב עם השינוי הזה.

**הרשאה:** `pipelines:approve`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `pipeline_id` | string | **נדרש.** מזהה הפייפליין. |
| `stage` | string | **נדרש.** השלב של הצ׳אט. |
| `turn_id` | string | **נדרש.** המזהה של תשובת הבמאי שאת השינוי שלה אתם מקבלים. |

## `get_pipeline_stage_chat`
מחזיר את ההודעות בצ׳אט של שלב, מהישן לחדש. כשאף אחד עוד לא כתב, הרשימה ריקה.

**הרשאה:** `pipelines:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `pipeline_id` | string | **נדרש.** מזהה הפייפליין. |
| `stage` | string | **נדרש.** השלב של הצ׳אט. |

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

**הרשאה:** `pipelines:execute`. **קרדיטים:** הקרדיטים של השלבים שרצים שוב.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `pipeline_id` | string | **נדרש.** פייפליין עם הסטטוס `completed`. |
| `from_stage` | string | **נדרש.** `script`, `characters`, `objects`, `locations`, `shot_list`, `scene_images`, `animate_audio_edit` או `post_merge`. |

**מה חוזר:** המזהה של הפייפליין החדש.

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

### מה מפיק פייפליין של סיפור ← וידאו?

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

### מה ההבדל בין המצבים אוטומטי, ידני ומונחה?

במצב אוטומטי, הפייפליין רץ בעצמו מהפרומפט ועד הסרט המוגמר. הוא עוצר רק כשמאץ׳ קאט מתוכנן בין שני שוטים נשבר, עד שכל שבירה מאושרת דרך ה-REST API. אין כלי MCP שמאשר שבירה. המצבים ידני ומונחה עוצרים בנקודות אישור. במצב מונחה אפשר גם לחדד את התסריט ואת העריכה הסופית בצ׳אט לפני שמאשרים.

### האם אפשר להריץ פייפליין מחדש מהאמצע?

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

### למה כלי הפייפליינים לא מופיעים אצל העוזר שלי?

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