תיעוד Nodaroהפקות Studio
הפרמטרים של כל כלי הפקות ה-Studio ב-MCP של Nodaro, מבדיקה של תוכנית בחינם ועד יצירת פריימים, תנועה, קול ופסקול, עם ההרשאות ואומדני המחיר.
זמין ב-Nodaro Cloud
כלי הפקות ה-Studio יוצרים ומשנים סרטים שנפתחים בעורך Nodaro Studio, בכתובת studio.nodaro.ai. הדף הזה מפרט את הפרמטרים של כל כלי. הדף הפקות Studio מסביר את מחזור העבודה, את המילים שכדאי להשתמש בהן מול המשתמש, את פעולות העריכה ואת הכללים להוצאת קרדיטים; קראו אותו קודם.
הפקות 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. השמיטו אותם כדי לשמור על הגדרות הקול של הסצנה. |
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 נותן אומדן מחיר לייצוא.
דפים קשורים
הפקות Studio
הפקות Studio
כלי ה-Recast
מדריך כלי ה-MCP
עודכן לאחרונה
רצף שוטים ובמאי וידאו
הפרמטרים של כלי במאי הווידאו ב-MCP של Nodaro, שיוצרים סרטון גרפיקת תנועה עם קריינות בקריאה אחת, ושל כלי רצף השוטים, שמתזמנים חשיפות לקריינות.
כלי ה-Recast
הפרמטרים של ששת כלי ה-Recast ב-MCP של Nodaro, שהופכים תסריט סרט שנכתב כ-JSON לפרויקט Recast מרונדר, עם אימות בחינם, אומדן מחיר וליהוק.