תיעוד Nodaroכלי עזר, מתכונים וסקילים
בדקו את החיבור עם ping, טענו מתכונים בדוקים עם get_recipe, התחילו לעבוד עם הסקיל של במאי הקולנוע והכינו סרטוני UGC לאתרים עם כלי הבנייה.
כלי העזר, המתכונים והסקילים נותנים לעוזר AI התחלה טובה. הכלי ping בודק את החיבור, get_recipe טוען מתכונים בדוקים של כמה שלבים, start_film_director טוען את הסקיל של במאי הקולנוע ושלושת כלי הבנייה של UGC מכינים סרטון שבו יוצר/ת מדבר על אתר אינטרנט. אף אחד מהם לא יוצר מדיה ולא מוציא קרדיטים. שלושה כלים נוספים בדף הזה כן מוציאים קרדיטים: הכלי capture_site מצלם עמוד אינטרנט כצילומי מסך, ו-ugc_split_speech ו-ugc_finish_clips חותכים את הדיבור ומבצעים את הגימור של הקליפים בסרטון UGC.
כלים אחרים שמחזירים הוראות מתוארים יחד עם המשפחה שלהם: start_workflow_editor ו-get_node_skill, start_video_director, get_studio_production_skill ו-get_recast_authoring_skill.
ping
מחזיר pong, את מזהה המשתמש שלכם ב-Nodaro ואת השם של הלקוח שקרא לכלי. השתמשו בו כדי לבדוק שהמחבר עובד.
הרשאה: אין, הכלי תמיד גלוי. קרדיטים: חינם.
לכלי הזה אין פרמטרים.
get_recipe
מציג וטוען מתכוני תוכן: תוכניות עבודה בדוקות שמובילות עוזר AI לאורך רצף עבודה מלא עם כמה כלים, כגון סרטון הסבר מונפש עם קריינות. הכלי מחזיר טקסט בלבד. את הפעולות שמתכון מבקש מבצעים בעזרת הכלים האחרים, ולכל אחד מהם הרשאה ומחיר משלו. הקטלוג נמצא בדף מתכוני תוכן.
הרשאה: אין, הכלי תמיד גלוי. קרדיטים: חינם.
| פרמטר | סוג | הערות |
|---|---|---|
recipe | string | שם של מתכון, כגון video-explainer. השמיטו אותו כדי לקבל את כל המתכונים ברשימה. |
file | string | קובץ עזר בתוך המתכון, כגון references/prompts.md. דורש את recipe. |
מה חוזר: בלי ארגומנטים, השם, התיאור וביטויי ההפעלה של כל מתכון. עם recipe, ההוראות המלאות של המתכון. עם file, הקובץ הזה. שם לא מוכר מחזיר שגיאה עם השמות התקפים.
ב-Nodaro Cloud, הרשימה כוללת גם סרטון UGC לאתר: יוצר/ת שמדבר למצלמה על אתר, וצילומי המסך של האתר מוצגים ככרטיסים.
start_film_director
מחזיר את הסקיל של במאי הקולנוע: ההוראות שגורמות לעוזר לביים סרט ב-10 שלבים, מהתסריט ועד העריכה הסופית, ותוך כדי כך לבנות על הקנבס שלכם תהליך שאפשר לערוך. עוזרים קוראים לכלי הזה ראשון בכל בקשה לסרטון עם כמה שוטים, כגון טריילר, סרט קצר, קליפ מוזיקלי, רילס או פרסומת. ראו את הדף במאי קולנוע.
הרשאה: אין, הכלי תמיד גלוי. קרדיטים: חינם. ב-Nodaro Cloud בלבד.
לכלי הזה אין פרמטרים. הוא לא משנה כלום.
capture_site
מצלם עמוד אינטרנט כצילומי מסך אמיתיים ברוחב של טלפון: תמונה אחת של העמוד כולו, ועד 8 תמונות סטילס של אזורים בעמוד, חתוכות בצורה של כרטיס טלפון. הכלי מחזיר גם מפה של האזורים בעמוד, עם הכותרת, המיקום וטקסט קצר של כל אזור, ואת המספרים המדויקים מהטקסט של העמוד. חלונות הסכמה קופצים מוסתרים, ואף פעם לא מאושרים.
הרשאה: workflows:execute. קרדיטים: מחיר קבוע לכל צילום. הכלי מופיע ברשימת הכלים רק בהתקנות שבהן צילום עמודים מופעל.
| פרמטר | סוג | הערות |
|---|---|---|
url | string | נדרש. העמוד לצילום. אפשר להשמיט את https://. עד 2,048 תווים. |
max_stills | integer | המספר המרבי של תמונות סטילס של אזורים שיוחזרו, מ-3 עד 8. ברירת המחדל: 8. |
client_request_id | string | אסימון ניסיון חוזר: בין 8 ל-128 תווים של אותיות, ספרות ו-_ - . :. אם אתם מנסים שוב אחרי פסק זמן, שלחו את אותו ערך, כדי ש-Nodaro לא יתחיל את הצילום ולא יחייב אותו פעמיים. |
מה חוזר: מזהה משימה. קבלו את תמונות הסטילס מ-outputData.stills בתשובה של wait_for_job, כל אחת עם assetId ועם url. תמונות הסטילס נשמרות במדיה שלכם, מוסתרות מחלון בחירת המדיה עד שתשמרו אותן, ונספרות במכסת האחסון שלכם.
צילום של עמוד שחוסם מבקרים אוטומטיים או שחוזר ריק נכשל, והקרדיטים מוחזרים. עמוד שה-robots.txt שלו לא מתיר את הצילום נדחה לפני שמשהו רץ.
כלי הבנייה של סרטוני UGC
שלושה כלי עזר חינמיים שהמתכון לסרטון UGC לאתר משתמש בהם. הם לא יוצרים כלום: כל אחד מהם בודק או מכין את החלק שלו, ומחזיר את הארגומנטים המדויקים של קריאות היצירה הבאות. שני כלים נוספים, ugc_split_speech ו-ugc_finish_clips, עושים את עבודת האודיו והווידאו של אותו מתכון, במחיר קבוע לכל קריאה. כל חמשת הכלים זמינים ב-Nodaro Cloud בלבד ולא צריכים הרשאה, חוץ מ-build_ugc_creator עם דמות שמורה, שצריך את assets:read.
build_ugc_creator
מכין את היוצר/ת שמדבר למצלמה: אדם חדש שנדגם באקראי, אחת מהדמויות השמורות שלכם או תמונה שלכם.
| פרמטר | סוג | הערות |
|---|---|---|
source | string | נדרש. sampled, character או photo. |
character_id | string | עם character: הדמות השמורה. |
photo_url | string | עם photo: התמונה שלכם. |
gender | string | woman או man. |
product_category, overrides, previous, seed | פרטים אופציונליים, כדי לכוון את היוצר/ת שנדגם או ליצור אותו שוב. |
מה חוזר: תמונות הזהות של היוצר/ת, או הארגומנטים המדויקים של יצירות התמונה שצריך להריץ אחר כך. ליוצר/ת שנדגם באקראי, מדובר בתמונה אחת לכל מועמד, כדי שתוכלו לבחור אחד מהם.
build_ugc_clips
(ב-Nodaro Cloud בלבד) בודק תסריט של סרטון UGC — את כל הבעיות בבת אחת, כל אחת עם תיקון — ומחזיר קריאה אחת ל-generate_video לכל קליפ, את הקריאה שמאחדת את הקליפים ואומדן קרדיטים לשאר הסרטון. אפשר לכתוב תסריטים באנגלית או בעברית. על תסריט בעברית הכלי עונה בשני שלבים: הקריאה הראשונה מחזירה את הדיבור שצריך להקליט ואיך לפצל אותו, עם האומדן; קראו לכלי שוב עם segments מ-ugc_split_speech כדי לקבל קריאה אחת ל-generate_video לכל מקטע. הכלי לא דורש הרשאה ולא עולה קרדיטים. המתכון ugc-website, שנטען עם get_recipe, משתמש בו.
| פרמטר | סוג | הערות |
|---|---|---|
plan | object | נדרש. התסריט. |
gender | string | נדרש. woman או man. |
identity_images | array | נדרש. תמונה אחת או שתיים של היוצר/ת. |
traits, seed | אופציונליים. | |
spent_job_ids | array | המשימות שכבר רצו בשביל הסרטון הזה, שהאומדן מציג ככאלה שכבר שולמו. עד 64. |
segments | array | המקטעים מהפלט של ugc_split_speech, כשהתשובה לקריאה הראשונה ביקשה אותם. השמיטו את הפרמטר בקריאה הראשונה. עד 8. |
speech_lane | string | רק לתסריט באנגלית. reference-audio (ברירת המחדל): קול מקריא את התסריט, ומודל הווידאו מגלם אותו. prompt-quoted: מודל הווידאו אומר את השורה בקול שלו. |
voice_id | string | רק לתסריט באנגלית. הקול בשיטה reference-audio, שם של קול מוכן מראש או מזהה מ-list_voices, במקום הקול שהכלי בוחר ליוצר/ת. |
מה חוזר: קריאה אחת ל-generate_video לכל קליפ, מוכנה להרצה, הקריאה שמאחדת את הקליפים ואומדן קרדיטים לשאר הסרטון. שורת אומדן עם estimate: true היא אומדן של קריאת LLM שמחויבת לפי השימוש: קריאה מסוג תמונה לטקסט, שמפענחת את צילומי המסך. הקריאה הזו מחויבת לפי הטוקנים שהיא השתמשה בהם בפועל. האומדן כולל אז totalIsEstimate: true, ולכן הציגו את הסכום כ-≈N. מודל בלי מחיר נדחה עם llm_model_unpriced.
build_ugc_cards
מתזמן את כרטיסי צילומי המסך ואת הכתוביות של סרטון UGC לפי התזמון של המילים בו.
| פרמטר | סוג | הערות |
|---|---|---|
plan | object | נדרש. התסריט. |
alignment או words | array | תזמוני המילים, מ-forced_alignment או מ-transcribe. |
video_duration_ms | number | אורך הסרטון. |
caption_style | string | איך נראות הכתוביות אחרי שורת הפתיחה: body-captions (מילה אחר מילה, ברירת המחדל), karaoke, clean-subtitles או none. שורת הפתיחה תמיד שומרת על הלוחית שלה. |
מה חוזר: השכבות ל-overlay_images ומקטעי הכתוביות ל-add_captions.
ugc_split_speech
חותך את הדיבור המוקלט של סרטון UGC למקטעים, בהפסקות של הדיבור עצמו. כל מקטע נשמר כקובץ אודיו, עם שקט קצר בכל צד.
קרדיטים: מחיר קבוע לכל קריאה.
| פרמטר | סוג | הערות |
|---|---|---|
plan | object | נדרש. התסריט. |
audio_url או audio_asset_id | string | הדיבור, ככתובת URL או כמזהה של משימה או של העלאה ב-Nodaro. |
alignment | array | נדרש. תזמוני המילים של הדיבור, 1–2,000 פריטים מהצורה { word, start, end }. |
מה חוזר: משימה שהפלט שלה מפרט את המקטעים, בשביל הפרמטר segments של build_ugc_clips.
ugc_finish_clips
בודק כל קליפ מרונדר מול האודיו שהוא קיבל, מצמיד לקליפ את האודיו המקורי הזה, מקצץ את השתיקות המיותרות שבין המילים ומחזיר את הקליפים המוגמרים לפי הסדר. אם קליפ לא תואם לאודיו שלו, הכלי מציין את הקליפים שצריך לרנדר מחדש ולא משנה כלום.
קרדיטים: מחיר קבוע לכל קריאה.
| פרמטר | סוג | הערות |
|---|---|---|
segments | array | נדרש. המקטעים מ-ugc_split_speech, 1–8. |
clips | array | נדרש. 1–8 פריטים. לכל פריט יש clip (המספר שלו, מ-1 עד 8) והסרטון המרונדר, כ-video_url או כ-video_asset_id. השדה reroll_video_url או reroll_video_asset_id הוא קליפ שרונדר מחדש. |
בסרטון בעברית, שבנוי ממקטעים, הכלי גם נותן לכל קליפ את הסאונד של הסביבה שלו: ריוורב שמותאם לסביבה, עוצמה של -16 LUFS וצליל רקע של חדר מתחת לדיבור. סביבות בחוץ, ברכב ובאולם מקבלות את הריוורב ואת העוצמה, אבל בלי צליל רקע של חדר. אם השלב הזה נכשל, הקליפים חוזרים בלעדיו, עם אזהרה.
מה חוזר: משימה שהפלט שלה מפרט את הקליפים המוגמרים לפי הסדר.
שאלות נפוצות
איך בודקים שהעוזר שלי מחובר ל-Nodaro?
בקשו מהעוזר לקרוא לכלי ping. הכלי מחזיר pong, את מזהה המשתמש שלכם ב-Nodaro ואת שם הלקוח שלכם, והוא לא צריך הרשאה.
מה הכלי get_recipe מחזיר?
הכלי get_recipe מחזיר הוראות, לא מדיה. בלי ארגומנט, הוא מציג את המתכונים עם התיאורים וביטויי ההפעלה שלהם. עם שם של מתכון, הוא מחזיר את תוכנית העבודה המלאה של אותו מתכון, והעוזר פועל לפיה בעזרת הכלים האחרים.
האם כלי הבנייה של UGC יוצרים את הסרטון?
לא. שלושת כלי הבנייה של UGC הם כלי עזר חינמיים של המתכון לסרטון UGC לאתר. הם מכינים את היוצר/ת, בודקים את התסריט ומתזמנים את הכרטיסים ואת הכתוביות, ומחזירים את הקריאות המדויקות שצריך לבצע אחר כך, עם אומדן קרדיטים. שני כלים אחרים, ugc_split_speech ו-ugc_finish_clips, חותכים את הדיבור ומבצעים את הגימור של הקליפים, במחיר קבוע לכל קריאה.
דפים קשורים
מתכוני תוכן
במאי קולנוע
מדריך כלי ה-MCP
פתרון בעיות
עודכן לאחרונה