# הפקות Studio

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

Source: https://nodaro.ai/he/docs/mcp/tools/studio-productions

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

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

## כלים, הרשאות ומחירים
| כלי | הרשאה | קרדיטים |
| --- | --- | --- |
| `get_studio_production_skill` | אין | חינם |
| `validate_studio_plan` | `workflows:read` | חינם |
| `list_studio_productions` | `workflows:read` | חינם |
| `get_studio_production` | `workflows:read` | חינם |
| `plan_studio_export` | `workflows:read` | חינם, כי זה אומדן מחיר |
| `create_studio_production` | `workflows:write` | חינם |
| `import_studio_production` | `workflows:write` | חינם |
| `edit_studio_production` | `workflows:write` | חינם |
| `share_studio_production` | `workflows:write` | חינם |
| `clone_studio_production` | `workflows:write` | חינם |
| `describe_studio_production` | `workflows:write` ו-`workflows:execute` | הרצת LLM אחת |
| `generate_studio_still` | `workflows:write` ו-`workflows:execute` | לכל תמונה מועמדת |
| `generate_studio_keyframe` | `workflows:write` ו-`workflows:execute` | תמונה אחת |
| `generate_studio_clip` | `workflows:write` ו-`workflows:execute` | סרטון אחד |
| `new_studio_shot_from_frame` | `workflows:write` ו-`workflows:execute` | חילוץ פריים אחד |
| `voice_studio_shot` | `workflows:write` ו-`workflows:execute` | הרצה אחת של טקסט לדיבור |
| `revoice_studio_clip` | `workflows:write` ו-`workflows:execute` | הרצה של החלפת קול |
| `score_studio_production` | `workflows:write` ו-`workflows:execute` | הרצת מוזיקה אחת |

בהגדרה של הכלים שמוציאים קרדיטים, ושל `share_studio_production`, שמשנה מי יכול לראות את העבודה, יש סימן אישור. הכלים שמוציאים קרדיטים מקבלים את `client_request_id`, אסימון ניסיון חוזר של 8–128 תווים: שלחו את אותו ערך שוב אחרי פסק זמן, ו-Nodaro לא יתחיל שום דבר פעמיים ולא יגבה קרדיטים פעמיים.

## תכנון וקריאה
### `get_studio_production_skill`
מחזיר את המדריך שעוזר AI קורא לפני שהוא עובד על הפקה. המדריך נוצר מהפריסה הפעילה.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `part` | string | `operating` (ברירת המחדל): מפת הכלים, מחזור העבודה ופעולות העריכה. `authoring`: הפורמט של התוכנית. `catalog`: כל בורר, מודל ואפשרות. `schema`: ה-JSON Schema של תוכנית. |

### `validate_studio_plan`
בודק תוכנית שנכתבה, בחינם, ולא שומר כלום. הכלי גם מתאים כל שם ב-`cast` לדמויות, למיקומים, לאובייקטים וליצורים שלכם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `plan` | object | **נדרש.** התוכנית, בפורמט `nodaro-studio-production`. |

**מה חוזר:** `valid`, `errors` (כל שגיאה מציינת את השדה שלה), `warnings` ו-`summary`, שמציין כמה מהשמות שבליהוק נמצאו בספרייה שלכם. תקנו את השגיאות וקראו לכלי שוב, עד ש-`valid` יהיה `true`.

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `limit` | integer | מ-1 עד 100. ברירת המחדל: `25`. |
| `cursor` | string | הערך `nextCursor` מהעמוד הקודם. |

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** מזהה ההפקה. |
| `detail` | string | `summary` (ברירת המחדל): כמויות, והפריים הנוכחי של כל סצנה. `full`: כל תוצאה קודמת, עם ההקשר שיצר אותה. |
| `shot_id` | string | קורא סצנה אחת בלבד: הקריאה הזולה אחרי יצירה. |
| `reconcile` | boolean | הערך `false` קורא בלי להכניס להפקה משימות שהסתיימו. ברירת המחדל: `true`. |

**מה חוזר:** ההפקה, ושדה `pending` שמפרט מה עדיין רץ. ציינו תוצאה לפי ה-`key` שלה, מזהה המשימה או הכתובת שלה, ולעולם לא לפי המיקום שלה.

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** מזהה ההפקה. |
| `upscale` | boolean | מוסיף את שלב ההגדלה ל-4K, שעולה ביוקר. ברירת המחדל: `false`. |

## יצירה ושינוי
### `create_studio_production`
יוצר הפקה בפרויקט ה-Studio שלכם. ההפקה מופיעה מיד בלוח הבקרה שלכם ב-studio.nodaro.ai. עם תוכנית, ההפקה נוצרת עם כל הסצנות, שיוכי הליהוק ומראות הסרט שבתוכנית; בלי תוכנית, ההפקה ריקה. בדקו קודם את התוכנית.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `plan` | object | תוכנית שנבדקה. |
| `name` | string | השם, כשאין לתוכנית כותרת משלה. עד 200 תווים. |

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `plan` | object | תוכנית שנבדקה. העבירו אותה או את `plan_job_id`. |
| `plan_job_id` | string | משימת LLM שהסתיימה, שהפלט שלה הוא תוכנית של הפקת Studio. משימה שעדיין רצה נדחית עם `not_finished`. |

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

### `edit_studio_production`
משנה הפקה בעזרת אצווה של פעולות, כגון שינוי שם של סצנה, שינוי הסדר בציר הזמן, בחירת טייק, קביעת השוטים בתוך התנועה של סצנה, צירוף אלמנט לליהוק או ריקון הפח. את הפעולות ואת הארגומנטים שלהן מחזיר `get_studio_production_skill` עם `part: "operating"`.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `ops` | array | **נדרש.** 1–100 פעולות, שמוחלות לפי הסדר. |
| `dry_run` | boolean | תצוגה מקדימה של האצווה: מה כל פעולה הייתה עושה, באיזו גרסה, והאם אפשר היה לשחזר כל מחיקה. שום דבר לא נכתב. |
| `expected_version` | integer | הגרסה שמולה הרכבתם את האצווה. |
| `strict` | boolean | כשההפקה השתנתה, דוחה את האצווה עם שגיאת התנגשות, במקום להחיל אותה מחדש על הגרסה העדכנית. דורש את `expected_version`. |

**מה חוזר:** אישורי ביצוע (`receipts`), שורה אחת בזמן עבר לכל פעולה. האצווה מוחלת כצעד אחד: אם פעולה אחת נדחית, התשובה מציינת את האינדקס שלה ושום דבר לא נכתב. אצווה שהורכבה מול גרסה קצת ישנה יותר עדיין מוחלת, ו-`rebased: true` מציין שהיא הוחלה מחדש על הגרסה העדכנית.

### `share_studio_production`
מפרסם את ההפקה בקישור שיתוף, או הופך אותה שוב לפרטית. כל מי שהקישור בידיו יכול לקרוא הפקה משותפת, ולכן שאלו קודם את המשתמש. הכלי הזה הוא הדרך היחידה לשנות את השיתוף.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `shared` | boolean | **נדרש.** הערך `true` מפרסם את הקישור, והערך `false` מבטל אותו. |

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה להעתקה. |
| `name` | string | השם של העותק. ברירת המחדל: השם המקורי עם הסיומת `" copy"`. |

## יצירת מדיה
יצירה מחזירה מזהי משימה מיד. התוצאה המוגמרת נכנסת לסצנה שלה רק בקריאה הבאה ל-`get_studio_production`; הכלים `get_job` ו-`wait_for_job` מדווחים על הסטטוס ולא מכניסים כלום להפקה.

### `describe_studio_production`
מעביר בריף לבמאי, שכותב להפקה סצנות, ליהוק ומראות. השתמשו בו כשלמשתמש יש סיפור ולא תוכנית.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `brief` | string | **נדרש.** הסיפור, הטון והמגבלות. |
| `llm_model` | string | **נדרש.** מודל ה-LLM שכותב את הטיוטה של ההפקה, מתוך `list_models`. |
| `mode` | string | המצב `append` (ברירת המחדל) מוסיף סצנות. המצב `replace` כותב את ההפקה מחדש. |
| `label` | string | שם להרצה. |
| `client_request_id` | string | אסימון ניסיון חוזר. |

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `shot_id` | string | **נדרש.** המזהה של הסצנה. |
| `count` | integer | כמה מועמדים, מ-1 עד 10. ברירת המחדל: ההגדרה של הסצנה עצמה. |
| `overrides` | object | הגדרות לקריאה הזו בלבד. |
| `dry_run` | boolean | מחזיר את המודל ואת המחיר, ולא מתחיל כלום. הערך `credits: null` פירושו שהמחיר לא ידוע, לא שהיצירה בחינם. |
| `client_request_id` | string | אסימון ניסיון חוזר. |

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `keyframe_id` | string | **נדרש.** הפריים המתוכנן. |
| `expected_revision` | integer | **נדרש.** הגרסה של תוכנית הפריימים שבדקתם. |
| `overrides` | object | המודל, יחס הגובה־רוחב והרזולוציה. הפרומפט והייחוסים נקבעים בתוכנית. |
| `client_request_id` | string | אסימון ניסיון חוזר. |

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

### `generate_studio_clip`
יוצר את התנועה של סצנה מהפריים שלה, מפריים הפתיחה ומפריים הסיום שלה ומהוראות הבימוי שלה.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `shot_id` | string | **נדרש.** המזהה של הסצנה. |
| `mode` | string | כופה שיטה: הערך `start` שולח רק את פריים הפתיחה, `start-end` שולח את פריים הפתיחה ואת פריים הסיום, ו-`references` שולח את מדיית הייחוס. השמיטו את הפרמטר כדי לפעול לפי הקלטים השמורים של הסצנה. |
| `overrides` | object | הגדרות לקריאה הזו בלבד. |
| `dry_run` | boolean | מחזיר את המודל ואת המחיר, ולא מתחיל כלום. |
| `retake_result_key` | string | מבצע צילום חוזר של טייק מקושר קיים, עם ההגדרות המקוריות שלו. השמיטו את `mode` ואת `overrides`. |
| `expected_input_hash` | string | נדרש כדי לשלוח צילום חוזר: הגיבוב מאומדן המחיר של הצילום החוזר. |
| `client_request_id` | string | אסימון ניסיון חוזר. |

כדי לבצע צילום חוזר מדויק של טייק מקושר, קראו קודם לכלי עם `retake_result_key` ועם `dry_run: true`, ובדקו את המחיר ואת ה-`inputHash`. אחר כך שלחו את אותה קריאה עם `expected_input_hash` ועם `client_request_id` חדש, בלי `dry_run`. הצילום החוזר משתמש בהגדרות המקוריות של הטייק ובתמונות של פריים הפתיחה ופריים הסיום שלו, גם אם התוכנית השתנתה מאז. פריסות שתומכות בזה מצהירות על כך ביכולת `operations.retakeLinkedClips`.

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `shot_id` | string | **נדרש.** הסצנה שמהתנועה שלה לוקחים את הפריים. |
| `target` | string | הערך `new-shot` (ברירת המחדל) פותח את הסצנה הבאה על בסיס הפריים. הערכים `start-frame` או `end-frame` מצמידים אותו לסצנה הזו כפריים הפתיחה או כפריים הסיום שלה. הערך `still` מוסיף אותו כטייק של הפריים של הסצנה הזו. |
| `mode` | string | `first` (ברירת המחדל), `last` או `timestamp`. |
| `timestamp` | number | בשניות, עבור `timestamp`. |
| `client_request_id` | string | אסימון ניסיון חוזר. |

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

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `shot_id` | string | **נדרש.** הסצנה. |
| `text` | string | **נדרש.** השורה להקראה. |
| `voice_id`, `voice_type` | string | קול מתוך [`list_voices`](https://nodaro.ai/docs/mcp/tools/audio#list_voices). השמיטו אותם כדי לשמור על הגדרות הקול של הסצנה. |
| `delivery` | object | הגדרות ההגשה, כגון מהירות ויציבות. |
| `tts_provider` | string | מודל הדיבור, כשזה משנה. |
| `client_request_id` | string | אסימון ניסיון חוזר. |

### `revoice_studio_clip`
מחליף את הקולות בתוך התנועה הנוכחית של סצנה: הדיאלוג מבוצע מחדש ומעורבב בחזרה מעל אותה תמונה.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `shot_id` | string | **נדרש.** הסצנה. |
| `plan` | object | **נדרש.** איזה דובר מקבל איזה קול. החלק `operating` של המדריך מתאר את המבנה של האובייקט הזה. |
| `client_request_id` | string | אסימון ניסיון חוזר. |

### `score_studio_production`
יוצר פסקול אחד לכל ההפקה, לפי תיאור של המוזיקה.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `production_id` | string | **נדרש.** ההפקה. |
| `prompt` | string | **נדרש.** המוזיקה: מצב־רוח, כלי נגינה, ז׳אנר. עד 2,000 תווים. |
| `duration` | number | בשניות, מ-1 עד 600. |
| `instrumental` | boolean | בלי שירה. |
| `vocal_gender` | string | קול הזמר או הזמרת. |
| `model` | string | מודל המוזיקה, מתוך `list_models`. |
| `client_request_id` | string | אסימון ניסיון חוזר. |

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

### אילו כלי Studio עולים קרדיטים?

כלי ה-Studio שעולים קרדיטים הם describe_studio_production, generate_studio_still, generate_studio_keyframe, generate_studio_clip, new_studio_shot_from_frame, voice_studio_shot, revoice_studio_clip ו-score_studio_production. קריאה, בדיקה, יצירה, עריכה, שיתוף ושכפול של הפקה לא עולים כלום.

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

כלי היצירה של Studio צריכים גם את workflows:write וגם את workflows:execute. חיבור שאישר רק אחת מהשתיים לא רואה אף אחד מהם. חברו את הלקוח מחדש ואשרו את שתי ההרשאות.

### למה פריים שכבר נוצר עדיין לא מופיע בהפקה שלי?

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

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

העבירו את הפרמטר dry_run עם הערך true לכלי generate_studio_still או generate_studio_clip. הכלי מחזיר את המודל ואת הקרדיטים, ולא מתחיל כלום. הכלי plan_studio_export נותן אומדן מחיר לייצוא.