הפקות Studio דרך MCP: בימוי סרט מצ׳אט והמשך עריכה ב-Studio

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

הפקת Studio היא סרט שעוזר AI יכול לביים מתוך שיחה, ושאתם ממשיכים לערוך בעורך ה-Studio ב-studio.nodaro.ai. ההפקה היא רשימה של סצנות לפי הסדר, ולכל סצנה יש פריים, תנועה אופציונלית, והתוכנית, המראות, הליהוק והקול שיצרו אותם. עוזר יכול לכתוב טיוטה של הסרט, להעביר אותה אליכם ולחזור לעבוד עליה אחרי שהזזתם שלוש סצנות ממקומן. הפקות Studio הן יכולת של Nodaro Cloud.

בחרו במסלול הזה לבקשות כמו ״צור לי סרט, סצנה או רצף, ותן לי להמשיך לערוך אותם״. לסרט שנכתב כמסמך JSON אחד, ראו את הדף Recast; לתהליך על הקנבס, ראו את הדף במאי הקולנוע.

שני אוצרות מילים

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

המשתמש אומר	המסמך אומר
סרט	ההפקה
סצנה, כמו ״סצנה 3״, כרטיס בציר הזמן	רשומה ב-`shots[]`, שמזוהה לפי `shot_id`
הפריים של סצנה, שהתוצאות שלו הן טייקים	`still`
התנועה של סצנה, שהתוצאות שלה הן טייקים	`clip`
השוטים שבתוך תנועה	`beats[]`, שנקבעים עם `set_beats`

סצנה N היא תמיד הרשומה מספר N ב-shots[]. הבקשה ״שנה את השם של סצנה 3״ היא rename_shot על הרשומה הזו, והבקשה ״מחק את סצנה 3״ היא remove_shot עליה.
המילה שוט פירושה שוט בתוך תנועה, כלומר רשומה ב-beats[] של הסצנה שהמשתמש מסתכל עליה, ואף פעם לא רשומה ב-shots[]. כשאין סצנה בתצוגה, או שבתנועה שלה יש פחות שוטים ממה שהמשתמש ציין, העוזר שואל במקום לנחש.
הפריים של סצנה הוא ה-still שלה. פריים מתוכנן הוא משהו אחר: תוכנית לפריים שהמשתמש בודק ומאשר, שנוצרת עם generate_studio_keyframe. פריים הפתיחה ופריים הסיום של סצנה הם נקודות הקצה של התנועה שלה.
אישורי הביצוע משתמשים במילים של המסמך. שמות הפעולות ואישורי הביצוע (receipts) של עריכה אומרים "shot" כשהכוונה לסצנה; העוזר לא צריך לחזור על הניסוח הזה מול המשתמש.

מחזור העבודה

קריאת המדריך

הכלי get_studio_production_skill מחזיר את המדריך בארבעה חלקים: operating (הכלים, מחזור העבודה והפעולות), authoring (פורמט התוכנית), catalog (כל בורר, מודל ואפשרות) ו-schema (ה-JSON Schema של התוכנית). המדריך נוצר מהפריסה הפעילה, ולכן הוא תואם לשרת שאתם משתמשים בו. הכלי חינמי.

בדיקת התוכנית

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

יצירת ההפקה

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

קריאה חוזרת

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

עריכה באמצעות פעולות

הכלי edit_studio_production מחיל אצווה של פעולות. ראו את הסעיף עריכה בפעולות.

יצירה

הכלי generate_studio_still יוצר את הפריים של סצנה, generate_studio_clip את התנועה שלה, new_studio_shot_from_frame שולף פריים מתוך תנועה, voice_studio_shot מקריא שורה, revoice_studio_clip מלהק מחדש את הקולות של תנועה, ו-score_studio_production יוצר את הפסקול.

הכלי plan_studio_export מפרט את השלבים שמרכיבים את הסרט, כל אחד עם המחיר שלו. הכלי share_studio_production פותח או סוגר קישור שיתוף, ו-clone_studio_production יוצר עותק.

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

עריכה בפעולות

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

פעולות מזהות דברים לפי מפתחות יציבים: סצנה לפי המזהה שלה, אלמנט בליהוק לפי ה-slug של התפקיד שלו, תוצאה לפי מזהה המשימה או הכתובת שלה. אף פעם לא לפי מיקום, כי ייתכן שהמשתמש עורך את אותו סרט בדפדפן.
אצווה שהורכבה מול גרסה קצת ישנה יותר עדיין מוחלת, והתשובה מציינת שהיא הוחלה מחדש על הגרסה העדכנית. עם strict: true ו-expected_version, האצווה נדחית במקום זאת.
פעולה שגויה אחת גורמת לדחיית האצווה כולה, ושום דבר לא נכתב. השגיאה מציינת את הפעולה לפי האינדקס שלה, שנספר מ-0; תקנו אותה ושלחו את האצווה שוב.
ב-receipts יש שורה אחת בזמן עבר לכל פעולה, ואותה מציגים למשתמש ששואל מה קרה עכשיו. אישור ביצוע יכול לכלול גם detail, והתשובה יכולה לכלול warningDetails. בשדות האלה נמצאות אותן שורות כנתונים, ללקוח שמנסח אותן בשפה של המשתמש. השתמשו ב-summary וב-warnings; אפשר להתעלם מ-detail ומ-warningDetails.
אפשר לבטל חלק מהמחיקות. סצנה, טייק או פריים מתוכנן שהוסרו עוברים לפח של ההפקה, ואפשר לשחזר אותם. אי אפשר לבטל ניקוי של אלמנט בליהוק, של קול או של הפסקול, מחיקה של גרסת עריכה, הסרה של רצף, מחיקה סופית של פריט בפח וריקון של הפח.
שיתוף הוא לא פעולה. יש לו כלי משלו, כך שאצוות עריכה אף פעם לא יכולה לשנות מי יכול לראות את העבודה.
אי אפשר למחוק הפקה. העברה לארכיון היא פעולה, ואפשר לבטל אותה.

רשימת הפעולות מגיעה מהשרת ולא מודפסת כאן: הכלי get_studio_production_skill עם part: "operating" מחזיר את מה שהפריסה מקבלת.

תצוגה מקדימה של אצווה

הכלי edit_studio_production עם dry_run: true עונה מה האצווה הייתה עושה, ולא כותב כלום. אישור הביצוע של כל פעולה כולל סיווג: הסיווג S משנה את המסמך, D מוחק, P משנה מי יכול לגשת לעבודה, ו-$ מוציא קרדיטים. מחיקה שהייתה עוברת לפח מסומנת ב-restorable: true. הציגו את התצוגה המקדימה למשתמש, ואז שלחו את אותה אצווה בלי dry_run.

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

הוצאת קרדיטים

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

קודם אומדן מחיר. הכלים generate_studio_still ו-generate_studio_clip מקבלים dry_run: true, שמחזיר את המודל ואת המחיר ולא כותב כלום. הערך credits: null אומר שהמחיר לא ידוע, לא שהוא חינם. הציגו את המחיר ותנו למשתמש לאשר. לשאר הכלים שמוציאים קרדיטים אין אומדן מחיר: העריכו את המחיר לפי המודל, או שאלו קודם.
ניסיון חוזר בטוח. כל כלי שמוציא קרדיטים מקבל client_request_id, בין 8 ל-128 תווים מתוך A-Za-z0-9_.:-. קריאה עם אותו אסימון מחזירה את המשימות של הקריאה הראשונה, בלי חיוב נוסף. צרו אסימון חדש לכל בקשה חדשה, ולעולם אל תנסו שוב קריאה שמוציאה קרדיטים בלי אסימון.

כל יצירה עוברת הרצה, תשאול ואז הכנסה להפקה:

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

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

סימוני אישור

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

סימון	למה לשאול קודם	כלים
`$`	הוא עולה קרדיטים.	`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`
`P`	הוא משנה מי יכול לראות את העבודה.	`share_studio_production`

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

הרשאות

שמונת הכלים שמוציאים קרדיטים צריכים גם workflows:write וגם workflows:execute. חיבור שאישר רק אחת מהשתיים לא רואה אף אחד מהם, בלי הסבר, ולכן לצורך יצירה אשרו את שתיהן. קריאה צריכה workflows:read, ויצירת הפקה, עריכה, שיתוף ושכפול צריכים workflows:write. הדף מדריך הכלים מפרט את ההרשאה ואת הפרמטרים של כל כלי.

זמינות

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

איפה מתועד פורמט התוכנית

לפורמט התוכנית, nodaro-studio-production, יש מקום פרסום אחד. אפליקציית ה-Studio מגישה את אותו מדריך לכתיבה, אותו קטלוג ואותו JSON Schema בכתובת studio.nodaro.ai/skills/studio-production/, כך שעוזר שקורא את get_studio_production_skill ואדם שקורא את הדף הזה קוראים את אותו מסמך.

אותו מסלול הפקה זמין גם ב-REST API, בדף ה-API הפקות Studio, וב-SDK בתור client.studio.productions.

שאלות נפוצות

מה זה הפקת Studio?

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

למה במקומות מסוימים העוזר קורא לסצנה שוט?

המפתחות של מסמך הפקת ה-Studio קוראים לסצנה "shot". בשיחה, העוזר צריך תמיד להשתמש במילים שלכם (סצנה, פריים, תנועה ושוט), ולשמור את השמות של המסמך רק לקריאות לכלים.

מתי יצירה שהסתיימה מופיעה בסרט?

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

האם אפשר לבטל עריכה?

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

במה הפקת Studio שונה מבמאי הקולנוע?

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

הפקות Studio