תיעוד Nodaroניתוח ורשימות עריכה
נתחו סרטון סצנה אחר סצנה, בדקו את הניתוח, זהו שקט, סנכרנו כמה הקלטות ותכננו ורנדרו רשימות עריכה, עם כלי ה-MCP של Nodaro.
כלי הניתוח ורשימות העריכה קוראים הקלטות קיימות והופכים אותן לנתונים מובנים או לחיתוכים מוגמרים. הכלים video_analysis ו-video_audit מפרקים סרטון סצנה אחר סצנה כדי שאפשר יהיה ליצור אותו מחדש, silence_detect ו-audio_sync מודדים הקלטות, ו-plan_edit ו-apply_edl מתכננים ומרנדרים חיתוכים לפי תמלול. הכלי switch_cameras בוחר את המצלמה לכל חיתוך לפי מי שמדבר, והכלי tighten_episode מריץ את כל העריכה של פודקאסט בקריאה אחת. כל כלי צריך את ההרשאה workflows:execute ומחזיר מזהה משימה.
video_analysis
מנתח סרטון ומפרק אותו סצנה אחר סצנה, בפירוק שמיועד ליצירה מחדש עם AI. הכלי עובד כמו רכיב ניתוח וידאו.
- סצנות נחתכות בגבולות טבעיים ונמשכות עד 8 שניות, יצירת תמונה או וידאו אחת לכל סצנה.
visualResolvedהוא תיאור עצמאי ומוכן לפרומפט של כל סצנה. זה השדה שהשלבים הבאים קוראים.- לכל סצנה יש גם סוג שוט, תנועת מצלמה ורשימה של שכבות אודיו. דיבור מצוטט מילה במילה, מוזיקה ואפקטי קול מתוארים כך שאפשר ליצור אותם, ורשימה ריקה פירושה שקט.
- משבצות הן האנשים, האובייקטים והמקומות שחוזרים בסרטון, כדי שתוכלו ללהק אותם מחדש עם הדמויות שלכם.
הרשאה: workflows:execute. קרדיטים: לפי אורך הסרטון, בטבלה שלמטה.
| פרמטר | סוג | הערות |
|---|---|---|
video_asset_id, video_url או youtube_url | string | נדרש אחד בדיוק. מזהה של משימת וידאו או של העלאה ב-Nodaro, כתובת URL ישירה של סרטון או קישור יוטיוב. עד 10 דקות; בלי שידורים חיים. אפס מקורות או שני מקורות מחזירים שגיאה. |
variations | boolean | מזהה גם את המראות השונים של כל אדם או דבר, כגון החלפת בגדים, חלום או תחפושת, ומשייך כל מראה לסצנות שלו. ברירת המחדל: false. |
music_video | boolean | מתייחס לקליפ כקליפ מוזיקלי: כל מילות השיר מתומללות כדיבור. ברירת המחדל היא false, ובה שירה שאף אחד על המסך לא מבצע היא חלק משכבת המוזיקה. |
translate_speech_to_english | boolean | מחזיר באנגלית את המילים שנאמרות ומושרות. ברירת המחדל: false, בשפת המקור. |
translate_on_screen_text_to_english | boolean | מחזיר באנגלית שלטים, כתוביות וכותרות. הטקסט הזה הוא חלק מהפרומפט החזותי, ולכן סצנה שנוצרת מחדש מציגה את הנוסח באנגלית. שמות נשארים בצורתם המקורית. ברירת המחדל: false. |
analysis_focus | string | הכוונה לניתוח, עד 2,000 תווים, למשל "focus on the product shots and on-screen text" (התמקד בשוטים של המוצר ובטקסט שעל המסך). |
מה חוזר: מזהה משימה. הניתוח, כלומר meta, slots ו-scenes, נמצא ב-output_data של המשימה.
הכלי תמיד מריץ את הניתוח ברמה חכם, הרמה המדויקת ביותר, ולא מקבל פרמטר של רמה או של בחירת התוצאה. לקוח שעדיין שולח llm_model או selection_mode מקבל את הרמה חכם, והפרמטרים האלה לא נלקחים בחשבון. שאר הרמות זמינות ברכיב ניתוח וידאו, גם בתהליכים שאתם מריצים דרך MCP, ובנתיב ה-REST.
המחיר נקבע לפי מדרגת האורך: הקטנה מבין 60, 180, 360 או 600 שניות שהסרטון נכנס בה. למדרגות של 60, 180 ו-360 שניות יש מרווח של 3 שניות, כך שסרטון של עד 1:03 מתומחר לפי המדרגה של 60 שניות:
| ניתוח | עד 60 שנ׳ | עד 180 שנ׳ | עד 360 שנ׳ | עד 600 שנ׳ |
|---|---|---|---|---|
| חכם | 455 | 554 | 1,394 | 2,284 |
הכלי list_models מחזיר את המחירים העדכניים.
video_audit
צופה שוב בסרטון מול הניתוח שלו ומתקן את מה ששגוי. כל תיקון מוחל בכפוף לבדיקות ומופיע בדוח, ומה שאי אפשר היה לתקן מסומן ולא משתנה. הכלי עובד כמו רכיב ביקורת AI.
הרשאה: workflows:execute. קרדיטים: המחיר נקבע לפי האורך, והוא נמוך יותר כשמעבירים ניתוח.
| פרמטר | סוג | הערות |
|---|---|---|
video_url | string | נדרש. הסרטון לביקורת. |
analysis | object | הניתוח מקריאה קודמת ל-video_analysis או ל-video_audit, כפי שהוא. בלעדיו, הכלי מריץ קודם ניתוח מהיר, וזה עולה יותר. |
מה חוזר: מזהה משימה. ב-output_data של המשימה נמצא הדוח: מה נבדק, מה השתנה ומה נשאר פתוח.
| הרצה | עד 60 שנ׳ | עד 180 שנ׳ | עד 360 שנ׳ | עד 600 שנ׳ |
|---|---|---|---|---|
עם analysis | 237 | 319 | 730 | 1,181 |
בלי analysis | 436 | 523 | 1,296 | 2,114 |
silence_detect
מוצא את קטעי השקט בהקלטה, לפי האודיו שלה בלבד: בלי תמלול ובלי תמונה. הכלי עובד כמו רכיב זיהוי שקט.
הרשאה: workflows:execute. קרדיטים: 11.
| פרמטר | סוג | הערות |
|---|---|---|
audio_url | string | נדרש. כתובת URL של אודיו או של וידאו. בשני המקרים הכלי קורא את רצועת האודיו. |
threshold_db | number | רמת השקט ב-dBFS, מ--90 עד 0. ברירת המחדל: -35, סף שמתאים לדיבור. |
min_silence_ms | integer | השקט הקצר ביותר שהכלי מדווח עליו, מ-1 עד 600,000 מ״ש. ברירת המחדל: 700. |
pad_ms | integer | הדיבור שנשמר סביב כל קטע, מ-0 עד 60,000 מ״ש. ברירת המחדל: 120. |
מה חוזר: מזהה משימה. התוצאה היא output_data.json, בצורה { ranges, durationMs }. העבירו את האובייקט הזה, ולא את כל ה-output_data, בפרמטר silence של plan_edit, או השתמשו ב-ranges כדי לכתוב רשימת עריכה בעצמכם.
audio_sync
מודד, לפי השוואת האודיו, כמה רחוקים זה מזה השעונים של 2–6 הקלטות של אותה שיחה, כגון קובצי מצלמה ומיקרופון ראשי. הכלי עובד כמו רכיב סנכרון אודיו.
הרשאה: workflows:execute. קרדיטים: החל מ-11 ל-2 מקורות ועד 55 ל-6, לפי מספר ההקלטות שמיושרות מול הייחוס.
| פרמטר | סוג | הערות |
|---|---|---|
sources | array | נדרש. 2–6 הקלטות, כל אחת בצורה { id, url }, עם מזהה ייחודי. כתובות URL של אודיו או של וידאו. |
reference | string | המזהה של ההקלטה שכל היסט נמדד מולה. ברירת המחדל: ההקלטה הראשונה. |
מה חוזר: מזהה משימה. התוצאה היא output_data.json: { reference, offsets, notes }, ולכל היסט יש sourceId, offsetMs, confidence ו-driftMsPerHour. זמן על השעון של הייחוס הוא הזמן במקור ועוד offsetMs. רמת ביטחון נמוכה וסחיפת שעון מדווחות ב-notes, ולעולם לא מתוקנות.
plan_edit
הופך תמלול מתוזמן לרשימת עריכה להקלטה. הכלי קורא את התמלול, ולעולם לא את התמונה, והוא עובד כמו רכיב תוכנית עריכה.
הרשאה: workflows:execute. קרדיטים: 3–1,664, לפי אורך ההקלטה, המצב והרמה. ב-Nodaro Cloud בלבד.
| פרמטר | סוג | הערות |
|---|---|---|
mode | string | נדרש. המצב tighten מסיר שתיקות, מילות מילוי והתחלות שגויות, בחיתוך אחד. המצב clips מוצא קליפים קצרים לשיתוף, עם רשימת עריכה לכל אחד. המצב chapters מסמן פרקים עם כותרות. המצב trailer בונה טיזר אחד של 20–40 שניות מהרגעים החזקים ביותר. |
transcript | object | נדרש. התמלול ברמת המילה, מ-transcribe. |
sources | array | נדרש. 1–6 הקלטות, לכל אחת url, ובאופן אופציונלי גם id, kind (video או audio), role (master-audio, camera, wide או screen), speakers ו-offset_ms על שעון המאסטר. השדה id הוא המזהה שנתתם להקלטה ב-audio_sync, עד 200 תווים. הוא נדרש כשמעבירים offsets. |
offsets | object או string | ה-output_data.json של משימת audio_sync. הכלי כותב כל היסט שנמדד על המקור עם אותו id, על השעון של המאסטר. השדה offset_ms שהוגדר במקור עצמו גובר. |
transcript_source_id | string | ה-id של המקור שממנו נוצר התמלול, כשאתם יודעים אותו. הכלי בודק אז שהמקור הזה נמצא על השעון של המאסטר. |
silence | object | התוצאה של silence_detect. |
plan_tier | string | economy, standard (ברירת המחדל) או premium. |
count | integer | במצב clips: כמה קליפים, מ-1 עד 50. |
target_duration_sec | integer | במצב clips: האורך של כל קליפ, מ-5 עד 180 שניות. |
target_aspect | string | 16:9, 9:16, 1:1 או 4:5. |
platform, instructions, style_guide | string | איפה הקליפים יפורסמו, והכוונה בטקסט חופשי. |
המאסטר הוא המקור עם התפקיד master-audio, ואם אין כזה, המקור הראשון. הכלי דוחה את הקריאה לפני כל חיוב כשבגלל ההיסטים החיתוך לא יהיה מסונכרן:
- למקור אין
offset_ms, ו-audio_syncלא מדד אותו, או מצא לו התאמה חלשה, ברמת ביטחון מתחת ל-0.5. הגדירו לוoffset_ms. - למאסטר יש
offset_msשונה מ-0. - מקורות אחרים משתמשים בהיסטים שנמדדו, אבל
audio_syncלא מדד את המאסטר, או מצא לו התאמה חלשה. - הפרמטר
offsetsהוא לא תוצאה שלaudio_sync, או שלמקור איןidשאפשר להתאים לפיו. - התמלול נוצר ממקור שלא נמצא על השעון של המאסטר. תמללו את המאסטר, או תנו למקור הזה את התפקיד
master-audio.
מה חוזר: מזהה משימה. התוכנית נמצאת ב-output_data של המשימה, מוכנה ל-apply_edl.
switch_cameras
בוחר איזו מצלמה מציגה כל חיתוך בעריכה מכמה מצלמות, לפי מי שמדבר. הכלי עובד כמו רכיב מחליף מצלמות. הסאונד אף פעם לא משתנה.
הרשאה: workflows:execute. קרדיטים: מחיר קבוע אחד לכל הרצה, בלי קשר לאורך ההקלטה או למספר המצלמות. ב-Nodaro Cloud בלבד.
| פרמטר | סוג | הערות |
|---|---|---|
edl | object או string | נדרש. רשימת עריכה אחת מ-plan_edit. בסט של קליפים, העבירו בכל קריאה את רשימת העריכה של קליפ אחד. |
transcript | object או string | נדרש. תמלול המילים עם תוויות הדוברים, מ-transcribe עם זיהוי דוברים. |
speaker_map | object | מיפוי של כל תווית דובר למזהה המקור ב-EDL של המצלמה של אותו דובר. הערך "" פירושו שלדובר אין מצלמה משלו. |
speaker_names | object | מיפוי של כל תווית דובר לשם תצוגה. |
min_shot_ms, lead_ms, max_shot_ms, wide_every, layout_hints | הגדרות השוטים של רכיב מחליף מצלמות. |
דובר שלא מופיע ב-speaker_map עובר למקור שרשימת ה-speakers שלו כוללת אותו; אם אין כזה, למקור wide; ואם גם הוא לא קיים, לכל מצלמה שיש בה תמונה. דובר שהערך שלו הוא "" מדלג על רשימות ה-speakers. גם דובר חדש באותה מצלמה מקבל מקטע משלו, עם השם שלו.
הקריאה נדחית לפני כל חיוב בשני מקרים. הראשון הוא תמלול בלי תוויות דוברים. השני הוא edl שהוא לא עריכה אחת על שעון המאסטר, כגון סט של קליפים, תוכנית פרקים או רשימת העריכה של פלט מרונדר.
מה חוזר: מזהה משימה. ב-output_data.json נמצאת רשימת העריכה עם החלפת המצלמות, מוכנה ל-apply_edl, וב-output_data.transcript נמצא התמלול עם שמות הדוברים.
apply_edl
מרנדר רשימת עריכה לחיתוך מוגמר. הכלי עובד כמו רכיב החלת רשימת עריכה, שבדף שלו מופיע גם המחיר לדקה.
הרשאה: workflows:execute. קרדיטים: לפי דקה של פלט מרונדר, בתעריף של הערך ב-quality. לתצוגה מקדימה ב-proxy, וידאו או אודיו, יש תעריף נמוך יותר משלה.
| פרמטר | סוג | הערות |
|---|---|---|
edl | object או string | נדרש. התוכנית מ-plan_edit, או רשימה שכתבתם. ה-segments שלה הם באלפיות שנייה שלמות על שעון master, וכל מקטע מציין לפי מזהה אחד מה-sources של ה-EDL. רינדור וידאו צריך מקור וידאו בכל מקטע. |
sources | array | כתובות URL שמחליפות את כתובות המקורות של ה-EDL, באותו סדר. |
output | string | video (ברירת המחדל) או audio. |
quality | string | final (ברירת המחדל), או proxy לתצוגה מקדימה מהירה ב-720p. תצוגה מקדימה תמיד פרטית, והיא מסומנת בתג תצוגה מקדימה. |
clip_key | string | לקליפ מתוכנית במצב clips: הערך "<first inMs>-<last outMs>" של אותו קליפ. הערך חוזר בתוצאה כ-output_data.clipKey, כך שתוכלו להתאים כל רינדור בחבילת קליפים לקליפ שלו. |
crossfade_ms | number | מעבר צולב בנקודות מפגש שאין להן מעבר משלהן, עד 5,000 מ״ש. ברירת המחדל: 0, חיתוכים חדים. |
transcript | object | תמלול למיפוי מחדש לפי החיתוך, כך שיתאים לתוצאה. |
רינדור אחד מפיק עד 180 דקות. רשימה פגומה, או רשימה ארוכה מדי, נדחית לפני שמשהו רץ, עם המקטע והכלל שהוא מפר.
מה חוזר: מזהה משימה. הקובץ המרונדר הוא התוצאה של המשימה, וה-output_data.quality שלה מציין אם זו תצוגה מקדימה או הגרסה הסופית.
tighten_episode
מהדק הקלטה של פודקאסט או של ראיון בקריאה אחת. הכלי מתמלל את ההקלטה עם תוויות דוברים, מוצא את קטעי השקט, מתכנן את החיתוך המהודק ומרנדר אותו. הוא יכול גם להוסיף כתוביות ומוזיקת רקע שיורדת בעוצמה מתחת לקול. הכלי עובד כמו רכיב הידוק פרק.
הרשאה: workflows:execute. קרדיטים: כל שלב לפי המחיר שלו, ועוד עמלה קבועה לכל הרצה.
| פרמטר | סוג | הערות |
|---|---|---|
media_url | string | נדרש. ההקלטה, כתובת URL של וידאו או של אודיו, עד 3 שעות. |
output | string | video (ברירת המחדל) או audio. הקלטת אודיו תמיד יוצרת פרק אודיו. |
framing_aspect | string | ממסגר פרק וידאו לצורה הזו עם רכיב תצוגת דוברים, שמציב מסגרות אוטומטיות על הדוברים שעל המסך: 16:9, 9:16, 1:1 או 4:5. השמיטו אותו כדי לוותר על מסגור. |
framing_layout | string | הפריסה כש-framing_aspect מוגדר: auto (ברירת המחדל), single, side-by-side, stacked, grid או pip. פריסה שהצורה לא תומכת בה מוחלפת בפריסה הקרובה ביותר. |
framing_source | string | איך פרק ממוסגר עוקב אחרי הדוברים שלו. הערך static (ברירת המחדל) מחלק את הפריים באופן שווה בין הדוברים. הערך tracking עוקב אחרי פנים עם רכיב מסגרות דוברים, שמשלמים עליו לכל 1,000 פריימים דגומים, או חלק מהם. כשרכיב מסגרות דוברים לא זמין לכם, הערך tracking נדחה עם 403. הערך auto עוקב אחרי פנים כשרכיב מסגרות דוברים זמין לכם, ואחרת מחלק באופן שווה. בלי מסגור, הפרמטר לא נלקח בחשבון. |
captions | boolean | צורב כתוביות בפרק וידאו. ברירת המחדל: true. |
caption_style | string | subtitle, word-highlight (ברירת המחדל), karaoke, tiktok-words, word-pop או bouncy. |
review_before_render | boolean | עוצר בתצוגה מקדימה מהירה לבדיקה. ברירת המחדל: false. |
plan_tier | string | איכות העריכה: economy, standard (ברירת המחדל) או premium. |
instructions | string | הוראות עריכה לתוכנית, עד 4,000 תווים. |
style_guide | string | מדריך סגנון לתוכנית, עד 4,000 תווים. |
music_url | string | מוזיקת רקע. המוזיקה יורדת בעוצמה מתחת לקול ומסתיימת יחד עם הפרק. |
music_duck_amount | number | בכמה המוזיקה יורדת בעוצמה מתחת לדיבור, מ-0 עד 100. ברירת המחדל: 75. |
client_request_id | string | אסימון ניסיון חוזר: בין 8 ל-128 תווים של אותיות, ספרות ו-_ - . :. אם אתם מנסים שוב אחרי פסק זמן, שלחו את אותו ערך, כדי ש-Nodaro לא יתחיל את ההרצה ולא יחייב אותה פעמיים. |
מה חוזר: מזהה משימה. הפרק נמצא ב-output_data.videoUrl או ב-output_data.audioUrl, והעריכה נמצאת ב-output_data.json. בהתקנה באירוח עצמי, הכלי צריך חיבור ל-Nodaro Cloud, ובלי חיבור כזה הוא נדחה מיד.
continue_use_case
ממשיך הרצה של tighten_episode כמשימה חדשה.
הרשאה: workflows:execute. קרדיטים: המחיר נקבע לפי המצב, כמפורט בהמשך.
| פרמטר | סוג | הערות |
|---|---|---|
job_id | string | נדרש. מזהה המשימה של ההרצה הקודמת. |
mode | string | נדרש. from-failed או render-final. |
edited_edl | object | רק במצב render-final: רשימת העריכה כפי שהיא אחרי הבדיקה שלכם. |
client_request_id | string | אסימון ניסיון חוזר, כמו ב-tighten_episode. |
from-failedמריץ שוב רק את השלבים שלא הסתיימו בהרצה שנכשלה. השלבים שהסתיימו נשמרים, ולא משלמים עליהם שוב. העמלה נגבית שוב, כי על העמלה של ההרצה שנכשלה קיבלתם החזר, כך שבסך הכול היא נגבית פעם אחת.render-finalמרנדר את הפרק באיכות מלאה אחרי תצוגה מקדימה שנוצרה עםreview_before_render. המצב הזה משתמש בהגדרות של התצוגה המקדימה, וב-edited_edlאם העברתם אותו. במצב הזה לא נגבית עמלה.
ההרצה ממשיכה בנתיב של סוג הרכיב שלה, וסוג הרכיב נלקח מהמשימה עצמה. משימה שהיא לא הרצה של רכיב תרחיש שימוש לפודקאסט נדחית לפני שנשלח משהו.
מה חוזר: מזהה משימה חדש. דחייה חוזרת כשגיאת כלי עם קוד ההמשך שלה. הקודים already_running ו-continuation_superseded מציינים את המשימה שאת המצב שלה צריך לבדוק, או את המשימה שצריך להמשיך במקומה. הקוד continuation_settling פירושו: נסו שוב בעוד רגע.
עריכת הקלטה לפי התמלול שלה
תמלול ההקלטה
קראו ל-transcribe עם ההקלטה. תזמוני המילים נמצאים ב-output_data.json.words של המשימה.
מציאת קטעי השקט
קראו ל-silence_detect. השלב הזה אופציונלי, אבל הוא עוזר למצב tighten.
תכנון החיתוך
קראו ל-plan_edit עם התמלול, קטעי השקט וההקלטה, במצב tighten, clips, chapters או trailer. בדקו את התוכנית ושנו אותה אם צריך.
רינדור החיתוך
קראו ל-apply_edl עם התוכנית. כדי לקבל קודם תצוגה מקדימה מהירה, השתמשו ב-quality: "proxy".
בפודקאסט או בראיון, הכלי tighten_episode מריץ את השלבים האלה בקריאה אחת. המתכון podcast-editing מוביל עוזר AI באותם שלבים; ראו את הדף מתכוני תוכן. כשיש כמה מצלמות ומיקרופון נפרד, הריצו קודם את audio_sync, והעבירו ל-plan_edit את ה-offset_ms של כל מקור.
שאלות נפוצות
מה הכלי video_analysis מחזיר?
הכלי video_analysis מחזיר פירוק של הסרטון סצנה אחר סצנה, כל סצנה עד 8 שניות, עם תיאור חזותי מוכן לפרומפט, סוג השוט, תנועת המצלמה ושכבות האודיו. האנשים, האובייקטים והמקומות שחוזרים בסרטון מופיעים כמשבצות שאפשר ללהק מחדש.
מה האורך המרבי של סרטון בכלי video_analysis?
הכלי video_analysis מקבל סרטון של עד 10 דקות, ממזהה של Nodaro, מכתובת URL ישירה או מקישור יוטיוב. שידורים חיים ביוטיוב נדחים. המחיר נקבע לפי מדרגת האורך שהסרטון נכנס בה, אחת מארבע מדרגות.
איך מהדקים הקלטת פודקאסט דרך MCP?
קראו לכלי tighten_episode עם ההקלטה. הכלי מתמלל אותה, מוצא את קטעי השקט, מתכנן את החיתוך ומרנדר אותו, במשימה אחת. כדי לשלוט בכל שלב, הריצו בעצמכם את transcribe, את silence_detect, את plan_edit במצב tighten ואת apply_edl.
מה זה EDL?
רשימת עריכה, או EDL, היא רשימה של מקטעים לפי סדר הניגון, וכל מקטע מציין חלון זמן מתוך הקלטת מקור. הכלי apply_edl מרנדר אותה לחיתוך מוגמר.
דפים קשורים
ניתוח וידאו
החלת רשימת עריכה
הידוק פרק
אודיו
מתכוני תוכן
עודכן לאחרונה