תיעוד Nodaroוידאו
צרו וידאו מטקסט או מתמונה, הרחיבו, עצבו מחדש, האירו מחדש והגדילו קליפים, וגרמו לפנים לדבר או לזוז, עם כלי הווידאו של Nodaro לעוזרי AI.
כלי הווידאו מאפשרים לעוזר AI ליצור ולשנות וידאו ב-Nodaro: ליצור קליפ מטקסט או מתמונה, להרחיב אותו או לעצב אותו מחדש, להאיר אותו מחדש, להגדיל אותו ולגרום לפנים לדבר או להעתיק תנועה. כל כלי מתחיל משימה ומחזיר את המזהה שלה, והתוצאה נשמרת בספרייה שלכם. כל כלי וידאו צריך את ההרשאה workflows:execute. משימות וידאו נמשכות בדרך כלל בין 2 ל-10 דקות.
| כלי | מה הוא עושה |
|---|---|
generate_video | טקסט לווידאו, עם ייחוסים אופציונליים |
animate_image | תמונה לווידאו, עם פריים סיום אופציונלי |
extend_video | ממשיך קליפ קדימה בזמן |
modify_video | מעצב מחדש או עורך קליפ לפי פרומפט |
relight_video | מאיר מחדש קליפ, או מחליף את הרקע שלו, על סמך הפיקסלים של הקליפ עצמו |
video_upscale | מגדיל קליפ, או משלים טיוטה של Seedance 2.5 ב-1080p |
video_depth | הופך קליפ לסרטון עומק |
video_mask | עוקב אחרי נושא שמתואר בטקסט ומחזיר סרטון מסכה |
lip_sync | גורם לפנים לדבר או לשיר לפי רצועת אודיו |
speech_to_video | מנפיש פורטרט לפי קטע דיבור |
motion_transfer | מעתיק את התנועה של סרטון לתמונה של דמות |
face_swap | מחליף פנים בסרטון |
cast_swap | Nodaro Motion: מחליף את האנשים, חיות המחמד, המוצרים או המקום בסרטון קצר לפי התמונות שלכם |
list_trends, get_trend, estimate_trend, run_trend | מריצים מתכון מוכן של Nodaro Motion עם התמונות שלכם |
stop_video_pro, continue_video_pro | עוצרים או ממשיכים הרצה ארוכה של יצירת וידאו Pro |
generate_video
יוצר סרטון מפרומפט טקסט. הכלי עובד כמו רכיב יצירת וידאו.
הרשאה: workflows:execute. קרדיטים: המחיר של המודל, שברוב המודלים נקבע לפי משך ורזולוציה. בדקו את pricing של המודל ב-list_models לפני שאתם נותנים אומדן מחיר.
| פרמטר | סוג | הערות |
|---|---|---|
prompt | string | תיאור הסרטון, עד 8,000 תווים. נדרש, אלא אם ערכה מספקת אותו. |
model | string | מזהה המודל. ברירת המחדל: seedance-2-fast. מזהה לא מוכר מוחלף בברירת המחדל. |
duration | number | בשניות. הכלי משתמש בערך הנתמך הקרוב ביותר. הערך -1 נותן ל-Seedance 2 לבחור את האורך. |
aspect_ratio | string | למשל 16:9, 9:16 או 1:1. ברירת המחדל: 16:9. ערך שלא נתמך מוחלף בערך חלופי. |
resolution | string | למשל 480p, 720p, 1080p או 4k, לפי המודל. השמיטו אותו כדי לקבל את הרזולוציה הנמוכה ביותר של המודל, שהיא גם הזולה ביותר. |
sound | boolean | יוצר סאונד, במודלים שתומכים בזה. |
negative_prompt | string | ממה להימנע, עד 8,000 תווים. |
seed | integer | זרע קבוע, במודלים שתומכים בזה. יש מודלים, כגון Seedance 2.5 ו-HappyHorse 1.1, שלא מקבלים זרע. הם מתעלמים ממנו, והרצות חוזרות נותנות תוצאות שונות. |
draft | boolean | ב-seedance-2-5, טיוטה ב-480p במחיר של הרצה ב-480p. השלימו את הטייק שמוצא חן בעיניכם עם video_upscale ועם model: "seedance-2-5-hd". ראו את הסעיף מצב טיוטה ב-Seedance 2.5 בדף יצירת וידאו. |
reference_image_urls | array | תמונות ייחוס לזהות או לסגנון, ככתובות URL או כמזהים של Nodaro. לכל מודל יש מגבלה משלו, למשל 30 ב-Seedance 2.5, 9 ב-Seedance 2 וב-MiniMax H3, 7 ב-Gemini Omni ו-3 ב-VEO 3.1. מודלים שלא תומכים בייחוסים מתעלמים מהן. |
reference_video_urls | array | סרטוני ייחוס לסגנון או לתנועה, במודלים שמקבלים אותם. |
reference_video_captions | array | למה משמש כל סרטון ייחוס, באותו סדר, עד 500 תווים לכל אחד. כל כיתוב הופך בפרומפט לשורה כגון @video_1: …. |
reference_audio_urls | array | אודיו ייחוס שמניע את התנועה, במודלים שמקבלים אותו. |
presetId | string | ערכה מ-list_node_presets. שדות שאתם שולחים גוברים עליה. |
structured | object | פרטים בפורמט מובנה שמתווספים לפרומפט, כמו ב-generate_image. |
described_references | array | עד 10 רשומות { name, description } לנושא שאפשר לקרוא לו בשם אבל אין לכם תמונה שלו. |
connected_references, reference_order | array | מתקדם. ייחוסים מתויגים ומסודרים בפורמט של העורך עצמו, עד 14. |
character_references | array | ב-Gemini Omni, ב-Gemini Omni Flash וב-Kling 4.0 בלבד. שומר על הפנים של אדם אמיתי, עד 3 רשומות ב-Gemini Omni ועד 7 ב-Kling 4.0. ראו את הסעיף שמירה על הפנים של אדם. |
keep_original_sound | boolean | ב-Kling 4.0 בלבד. שומר על הסאונד המקורי של סרטוני הייחוס. בלי סרטון ייחוס אין לו השפעה. |
audio_soundtrack | boolean | ב-Kling 4.0 בלבד. כברירת מחדל, הקליפ הראשון ב-reference_audio_urls מתנגן כפסקול. הערך false שולח כל קליפ כדגימת קול, בלי פסקול. |
user_request | string | ההודעה האחרונה שנשלחה לעוזר, מילה במילה, עד 4,000 תווים. ההודעה נשמרת ברכיב שבתהליך של השיחה, ואף פעם לא משנה את מה שנוצר. ראו איך שיחות MCP הופכות לתהליכים. |
flow_id | string | הערך "new" מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף התחלה או בחירה של תהליך בעצמכם בדף שיחות MCP. |
מה חוזר: מזהה משימה. בלקוחות עם MCP Apps, הכרטיס מציג את הסרטון כשהוא מוכן.
ב-Seedance, כתבו את הפרומפט של סרטון עם כמה רגעים בצורה Shot 1: … Shot 2: … (שוט 1: … שוט 2: …), השתמשו בתנועת מצלמה אחת לכל שוט ותארו את הסאונד בפרומפט. הכלי get_node_skill עם generate-video מחזיר את כללי כתיבת הפרומפט של כל משפחת מודלים.
סרטון ייחוס אומר למודל להעתיק משהו מהקליפ. כתבו ב-reference_video_captions למה הוא משמש. למשל, רינדור חימר אפור של סצנת תלת־ממד הוא קו מנחה לפריסה, לא למראה; בלי כיתוב, המודל עלול להעתיק גם את מראה החימר האפור.
הערות על מודלים
| מודל | מה כדאי לדעת |
|---|---|
Seedance 2 (seedance-2) | מקבל resolution: "4k" ו-aspect_ratio: "adaptive" או "21:9". |
Seedance 2 Fast ו-Mini (seedance-2-fast, seedance-2-mini) | 480p ו-720p בלבד. |
Seedance 2.5 (seedance-2-5) | 480p, 720p או 1080p, ועד 30 שניות בקריאה אחת. עד 30 תמונות ייחוס, 10 סרטונים ו-10 קטעי אודיו. |
MiniMax H3 (minimax-h3) | עד 9 תמונות ייחוס, 3 סרטונים ו-3 קטעי אודיו. הערך של resolution הוא 2K (ברירת המחדל) או 768P, שזול יותר, והאודיו תמיד מופעל. סרטון מטקסט בלבד דורש יחס גובה־רוחב מפורש. כל סרטון ייחוס באורך 2–15 שניות, ועד 15 שניות בסך הכול, ואודיו ייחוס חייב להגיע יחד עם ייחוס של תמונה או של וידאו. |
Wan 3.0 (wan-3, wan-3-prime) | עד 10 תמונות ייחוס, 5 סרטונים ו-5 קטעי אודיו, כל קליפ באורך 1–15 שניות, ועד 15 שניות בסך הכול לכל סוג. הערך של duration הוא בין 2 ל-30 שניות, וברירת המחדל היא 5. הערך של resolution הוא 480p, 720p או 1080p. המודל wan-3-prime מהיר יותר ועולה יותר. |
Kling 4.0 (kling-4) | טקסט לווידאו מפרומפט בלבד, או עד 10 reference_image_urls, 5 reference_video_urls (כל אחד באורך 2–30 שניות, ועד 30 שניות בסך הכול, אחרת הקריאה נדחית עוד לפני שמשוריינים קרדיטים; קליפ שגדול מ-2048 פיקסלים בצד הארוך שלו, או שיש בו יותר פיקסלים מ-1920×1080, מוקטן כך שיתאים, בלי לשנות את הצורה שלו, לפני שהוא נשלח), 7 character_references (כל אחד הוא נושא עם שם) ו-3 reference_audio_urls, ולכל היותר 15 חומרים בסך הכול. פריים פתיחה או פריים סיום נחשב לתמונה. יותר מזה נדחה עוד לפני שמשהו משוריין. כברירת מחדל, קליפ האודיו הראשון מתנגן כפסקול של התוצאה. הוא נשלח כסרטון ייחוס נוסף שכולל את האודיו, ולכן הוא תופס אחד מ-5 המקומות של סרטוני הייחוס, וההרצה מתומחרת כהרצה עם סרטון ייחוס. שאר קליפי האודיו נשארים קולות עם שם. עם audio_soundtrack: false, כל קליפ נשאר קול. בפרומפט, קראו לחומרים @image_1, @video_1, לדמות @<name> ולקליפ קול @audio_1. הרצה עם סרטון ייחוס מחויבת לפי הפלט ועוד הארוך מבין הפלט והקליפים, בתעריף הייחוס. |
Kling 4.0 Keyframes (kling-4-keyframes) | פריים פתיחה, עד 8 פריימי ביניים ב-reference_image_urls, לפי הסדר, ופריים סיום. אורך הקליפ מגביל את מספר הפריימים בסך הכול, מ-4 פריימים בקליפ של 3 שניות ועד 10 בקליפ של 9 שניות ומעלה. בפרומפט, הפריימים הם @first_frame, @keyframe_1 והלאה, ו-@last_frame. בלי סרטוני ייחוס, אודיו או דמויות. |
| Kling 4.0, שני המודלים | הערך של duration הוא בין 3 ל-30 שניות, וברירת המחדל היא 5. הערך של resolution הוא 720p (ברירת המחדל) או 1080p. הערך של aspect_ratio הוא auto (ברירת המחדל), 16:9, 9:16, 1:1 או 21:9. האודיו תמיד מופעל, ואין זרע. |
Gemini Omni Flash (gemini-omni-flash) | הגרסה הזולה והמהירה יותר של Gemini Omni. הערך של duration הוא 4, 6, 8 או 10 שניות, וברירת המחדל היא 8. הערך של aspect_ratio הוא 16:9 או 9:16. הערך של resolution הוא 720p, 1080p או 4k. |
VEO 3.1 Quality (veo3) | אין לו מצב ייחוס; לייחוסים, השתמשו ב-VEO 3.1 Fast או ב-VEO 3.1 Lite. |
ב-Seedance 2, ב-MiniMax H3 וב-Wan 3.0, פריים פתיחה או פריים סיום שמועבר יחד עם ייחוסים הופך לתמונת ייחוס נוספת, והפרומפט מציין אותו כפריים הפותח או הסוגר. ב-Seedance, התשלום על סרטוני ייחוס נקבע לפי אורך הקלט ועוד אורך הפלט, ולכן עם קליפי ייחוס ארוכים יותר משוריינים יותר קרדיטים.
שמירה על הפנים של אדם
כדי לשמור על הפנים של אדם אמיתי ב-Gemini Omni או ב-Gemini Omni Flash, העבירו את character_references: עד 3 רשומות { image_url, description }, וכל אחת יכולה לכלול גם body_image_url, name ו-voice_preset. השדה image_url הוא פורטרט, והשדה description מתאר את האדם. זה קלט הזהות של המודל עצמו, ולכן הוא שומר על הפנים, בעוד ש-reference_image_urls רק מכוון את הקליפ.
- מודלים אחרים מחזירים שגיאה, במקום לרוץ בלי הפרמטר.
- אי אפשר לשלב אותו עם פריים פתיחה.
- הוא חולק את תקציב הקלט של המודל, 7 יחידות, עם תמונות ייחוס (יחידה אחת לכל תמונה) ועם סרטון מקור (2 יחידות). דמות נחשבת ליחידה אחת, או ל-2 עם
body_image_url. - השדה
voice_presetהוא מזהה קול של Gemini, כגוןkore. הוא שומר על אותו קול לדמות הזו בכל הקליפים.
ב-Kling 4.0 (kling-4), כל אחת מהרשומות, עד 7, הופכת במקום זאת לנושא עם שם. השדות image_url ו-body_image_url, ועד 3 extra_image_urls, הם התמונות של הנושא, בין 2 ל-4, ורשומה עם תמונה אחת נשלחת כתמונת ייחוס רגילה. בפרומפט קוראים לנושא @<name>, אפשר להשתמש בפריים פתיחה, ו-voice_preset נדחה.
ייחוסי דמויות לא מוסיפים קרדיטים למחיר הקליפ.
animate_image
מנפיש תמונת סטילס לסרטון. כשמעבירים גם פריים סיום, הסרטון עובר מהתמונה הראשונה לשנייה. הכלי עובד כמו רכיב יצירת וידאו במצב תמונה לווידאו.
הרשאה: workflows:execute. קרדיטים: המחיר של המודל.
| פרמטר | סוג | הערות |
|---|---|---|
image_url או image_asset_id | string | הפריים הראשון. |
end_frame_url או end_frame_asset_id | string | הפריים האחרון. בחרו מודל שה-features שלו ב-list_models כוללים את end-frame. |
prompt | string | מה קורה בסרטון, עד 8,000 תווים. |
model | string | ברירת המחדל: seedance-2-fast. מזהה לא מוכר מוחלף בברירת המחדל. |
duration, aspect_ratio, resolution, sound, draft | כמו ב-generate_video. | |
reference_image_urls, reference_video_urls, reference_audio_urls | array | ייחוסים לפי המגבלות של כל מודל, למשל 30 תמונות ב-Seedance 2.5, 9 ב-Seedance 2 וב-MiniMax H3, ו-7 ב-Gemini Omni, ב-Kling 3 Omni וב-Grok. |
loop_trim | object | חותך את התוצאה בנקודת הלולאה הנקייה ביותר שלה: enabled, frames_to_test (1–64) ו-quality עם הערך lossless או precise. הפרמטר הישן auto_loop_trim עדיין עובד, והוא ממופה לפרמטר הזה. |
described_references, connected_references, reference_order | array | כמו ב-generate_video. |
user_request | string | ההודעה האחרונה שנשלחה לעוזר, מילה במילה, עד 4,000 תווים. ההודעה נשמרת ברכיב שבתהליך של השיחה, ואף פעם לא משנה את מה שנוצר. ראו איך שיחות MCP הופכות לתהליכים. |
flow_id | string | הערך "new" מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף התחלה או בחירה של תהליך בעצמכם בדף שיחות MCP. |
הכלי בוחר את המצב לפי מה שאתם מעבירים: פריימים (פריים ראשון ופריים אחרון אופציונלי) או ייחוסים. אי אפשר לשלב סרטוני ייחוס ואודיו ייחוס עם פריים סיום. ללולאה חלקה, השתמשו באותה תמונה כפריים הראשון וכפריים האחרון, כבו את הסאונד, ואז אחדו את העותקים עם combine_videos והוסיפו סאונד עם merge_video_audio.
מה חוזר: מזהה משימה.
extend_video
ממשיך קליפ קדימה בזמן. בחרו קודם את המודל: שני מודלים ממשיכים סרטון שהם יצרו, ואחד מרחיב כל סרטון.
הרשאה: workflows:execute. קרדיטים: המחיר של מודל ההרחבה.
| מודל | יצרן | מצבים | קרדיטים | פרטים |
|---|---|---|---|---|
| Seedance 2 Extend | Bytedance | הרחבת וידאו | החל מ-286 | הרחבה של כל סרטון: המודל מייצר מקטע המשך (כולל אודיו), חותך אותו ומאחד אותו עם הסרטון לקליפ אחד רציף. |
| VEO Extend | הרחבת וידאו | החל מ-209 | הרחבת קליפ קיים של VEO 3.1 במקטע נוסף. | |
| Runway Extend | Runway | הרחבת וידאו | 352 | הרחבת סרטון של Runway בקליפ נוסף. |
| פרמטר | סוג | הערות |
|---|---|---|
model | string | נדרש. seedance-2-extend, veo-extend או runway-extend. |
prompt | string | נדרש. מה קורה אחר כך, עד 8,000 תווים. עם seedance-2-extend, תארו רק את מה שקורה בהמשך. |
video_url או video_asset_id | string | ב-seedance-2-extend בלבד: הסרטון להרחבה, מכל מקור. |
task_id | string | ב-veo-extend וב-runway-extend בלבד: המזהה שהספק נתן ליצירה הקודמת ב-VEO או ב-Runway, הערך providerTaskId בפלט של המשימה שלה. |
duration | integer | ב-seedance-2-extend: מספר השניות להוספה, מ-4 עד 15. ברירת המחדל: 8. |
generate_audio | boolean | ב-seedance-2-extend: ממשיך את הפסקול. ברירת המחדל: true. |
resolution | string | ב-seedance-2-extend: 480p, 720p (ברירת המחדל), 1080p או 4k. התאימו את הרזולוציה למקור כדי שנקודת החיבור תהיה נקייה ככל האפשר. |
reference_image_urls | array | ב-seedance-2-extend: עד 8 תמונות ייחוס, שהפרומפט קורא להן @image_1 עד @image_8, לפי סדר הרשימה. |
veo_quality | string | ב-veo-extend: הערך fast או quality. |
runway_resolution | string | ב-runway-extend: הערך 720p או 1080p. |
seed | integer | מ-10,000 עד 99,999. |
מה חוזר: מזהה משימה. המודל seedance-2-extend יוצר את מה שקורה אחר כך, עם אודיו, ומאחד אותו עם המקור לקליפ אחד.
modify_video
מעצב מחדש או עורך קליפ קיים לפי פרומפט. הכלי עובד כמו רכיב וידאו לווידאו.
הרשאה: workflows:execute. קרדיטים: המחיר של המודל.
| פרמטר | סוג | הערות |
|---|---|---|
prompt | string | נדרש. השינוי, עד 8,000 תווים. |
video_url או video_asset_id | string | נדרש אחד מהשניים. קליפ המקור. |
model | string | wan (ברירת המחדל, Wan 2.6, הבחירה הכללית), wan-flash, wan-videoedit, luma-modify, runway-aleph, happyhorse-edit או seedance-2-5. מזהה לא מוכר מוחלף ב-wan. |
duration | string | ב-Wan וב-Wan Flash: הערך 5 או 10, בשניות. |
resolution | string | ב-Wan וב-Wan Flash: הערך 720p או 1080p. ב-Seedance 2.5: מ-480p עד 1080p. |
aspect_ratio | string | ב-Runway Aleph בלבד: 16:9, 9:16, 4:3, 3:4, 1:1 או 21:9. |
audio | boolean | ב-Wan Flash בלבד: שומר את האודיו או יוצר אותו מחדש. |
multi_shots | boolean | ב-Wan Flash בלבד: מאפשר חילופי סצנות בתוך הקליפ. |
reference_image_url | string | ב-Runway Aleph בלבד: תמונת ייחוס לסגנון. |
reference_image_urls | array | ב-Seedance 2.5 בלבד: עד 30 תמונות, שהפרומפט מזכיר כ-{image:1}, {image:2} וכן הלאה. |
seed | integer | זרע קבוע. המודלים seedance-2-5 ו-happyhorse-edit לא מקבלים זרע ומתעלמים ממנו. |
draft | boolean | ב-Seedance 2.5 בלבד: מרנדר את העריכה כטיוטה ב-480p. השלימו אותה ב-1080p עם video_upscale ועם model: "seedance-2-5-hd". |
עם seedance-2-5, הפרומפט הוא הוראה שעורכת את הקליפ כולו. התוצאה שומרת על האורך ועל יחס הגובה־רוחב של המקור, והקליפ חייב להיות באורך 4–30 שניות. החיוב הוא כמו בהרצה של Seedance 2.5 עם סרטון ייחוס: שניות הקלט ועוד שניות הפלט. השריון נקבע לפי אורך קליפ המקור, מעוגל כלפי מעלה לשנייה שלמה, ועוד שנייה אחת, והחיוב הסופי נקבע לפי האורך שנמסר. כל עוד אי אפשר למדוד את הקליפ, השריון נקבע לפי הקליפ הארוך ביותר של המודל.
מה חוזר: מזהה משימה.
relight_video
מאיר מחדש קליפ, מחליף את הרקע שלו או מעצב את הרקע מחדש, או משלב בו אלמנטים חדשים, על סמך הפיקסלים של סרטון המקור עצמו. הכלי מריץ את Beeble SwitchX ועובד כמו רכיב תאורה מחדש והחלפה.
הרשאה: workflows:execute. קרדיטים: המחיר נקבע לפי מספר הפריימים ורזולוציית הפלט.
| פרמטר | סוג | הערות |
|---|---|---|
video_url או video_asset_id | string | קליפ המקור: עד 240 פריימים ועד 2,770,000 פיקסלים בכל פריים. |
prompt | string | התאורה או המראה החדשים, עד 2,000 תווים. העבירו פרומפט, תמונת ייחוס או את שניהם. |
reference_image_url | string | תמונת ייחוס למראה החדש. מומלץ מאוד. |
alpha_mode | string | המצב auto (ברירת המחדל) ממסך את הנושא הראשי. המצב fill מעצב מחדש את הפריים כולו. המצב select משתמש ב-mask_url כמסכת פריים מפתח אחת. המצב custom משתמש ב-mask_url כסרטון מסכה לכל הפריימים. |
mask_url | string | נדרש עבור select ועבור custom. |
alpha_keyframe_index | integer | עבור select: הפריים שהמסכה מתארת, בספירה מ-0. |
max_resolution | string | 720 או 1080 (ברירת המחדל). |
seed | integer | זרע קבוע. |
מה חוזר: מזהה משימה. כל תוצאה כוללת ציון מקור של SwitchX.
video_upscale
מגדיל קליפ לרזולוציה גבוהה יותר. הכלי עובד כמו רכיב הגדלת וידאו.
הרשאה: workflows:execute. קרדיטים: המחיר של מודל ההגדלה. ב-Topaz החיוב הוא לפי שימוש: משוריינים קרדיטים לפי גודל הפלט, ומשלמים על מה שההגדלה השתמשה בו בפועל. ראו את הסעיף קרדיטים בדף הגדלת וידאו.
| מודל | יצרן | מצבים | קרדיטים | פרטים |
|---|---|---|---|---|
| Topaz Video Upscale | Topaz | הגדלת וידאו | 209 | הגדלה ושיפור של וידאו באיכות גבוהה. |
| VEO 1080p Upscale | הגדלת וידאו | 22 | הגדלת פלט של VEO ל-1080p. | |
| VEO 4K Upscale | הגדלת וידאו | 418 | הגדלת פלט של VEO ל-4K. |
| פרמטר | סוג | הערות |
|---|---|---|
model | string | topaz (ברירת המחדל), veo-1080p, veo-4k או seedance-2-5-hd. |
video_url או video_asset_id | string | נדרש עבור topaz. |
target_resolution | string | עבור topaz: הצד הקצר של הפלט, 720p, 1080p (ברירת המחדל) או 4k. |
target_fps | integer | עבור topaz: קצב הפריימים של הפלט, מ-15 עד 60. ברירת המחדל: הקצב של המקור. Topaz יוצר את הפריימים החסרים באינטרפולציה. |
upscale_factor | string | מיושן. השתמשו ב-target_resolution. 1, 2 או 4, שמוחל על הצד הקצר של המקור. |
task_id | string | נדרש עבור veo-1080p ו-veo-4k: המזהה שהספק נתן ליצירה המקורית ב-VEO, הערך providerTaskId בפלט של המשימה שלה. עבור seedance-2-5-hd: המזהה שהספק נתן לטיוטה. |
source_job_id | string | ב-seedance-2-5-hd בלבד: מזהה המשימה של טיוטת Seedance 2.5 להשלמה, במקום task_id. |
המודל seedance-2-5-hd מרנדר מחדש טיוטה של Seedance 2.5 כאותו טייק, ב-1080p. המחיר נקבע לפי אורך הטיוטה. ראו את הסעיף Seedance 2.5 HD (מטיוטה) בדף הגדלת וידאו.
מה חוזר: מזהה משימה.
video_depth
הופך סרטון לסרטון עומק, שבו הקרוב בהיר והרחוק כהה. הכלי עובד כמו רכיב עומק וידאו.
הרשאה: workflows:execute. קרדיטים: המחיר נקבע לפי אורך הקליפ. ראו את הסעיף קרדיטים בדף עומק וידאו.
| פרמטר | סוג | הערות |
|---|---|---|
video_url או video_asset_id | string | סרטון המקור. |
provider | string | video-depth-anything (ברירת המחדל), עקבי מפריים לפריים, או depth-anything-frames, שרץ על כל פריים בנפרד, עלול להבהב ומקבל קליפים של עד 80 שניות. |
model_size | string | small, base או large. ברירת המחדל: large. |
colormap | string | grayscale (ברירת המחדל), turbo, inferno, magma או viridis. המודל depth-anything-frames מרנדר רק grayscale ו-inferno. כל ערך אחר הופך ל-grayscale. |
resolution | string | ב-video-depth-anything בלבד: auto (ברירת המחדל), 360p, 480p, 720p או 1080p. |
side_by_side | boolean | ב-video-depth-anything בלבד: המקור והעומק זה לצד זה. |
הגדרה שהמודל לא מקבל נשמטת. קליפ של יותר מ-2,400 פריימים או יותר מ-300 שניות נדחה עוד לפני שמשוריינים קרדיטים.
מה חוזר: מזהה משימה.
video_mask
עוקב לאורך סרטון אחרי נושא שמתואר בטקסט פשוט, ומחזיר סרטון מסכה בשחור־לבן, לבן במקום שבו נמצא הנושא. הכלי עובד כמו רכיב מסכת וידאו.
הרשאה: workflows:execute. קרדיטים: המחיר נקבע לפי אורך הקליפ, מ-55 עד 3,108 קרדיטים ב-SAM 3.1. SAM 3 עולה חצי מזה.
| פרמטר | סוג | הערות |
|---|---|---|
video_url או video_asset_id | string | סרטון המקור, עד 5 דקות ב-30 פריימים לשנייה. קליפ בקצב פריימים גבוה יותר נספר ארוך יותר באופן יחסי. |
prompt | string | נדרש. אחרי מה לעקוב, באורך 1–500 תווים, כגון the woman in the red coat (האישה במעיל האדום). הפרידו בין כמה נושאים בפסיקים. |
threshold | number | מ-0.05 עד 0.95. ברירת המחדל: 0.5. ערך נמוך יותר מוצא יותר: נסו 0.3 כששום דבר לא מתאים. |
provider | string | sam-3.1 (ברירת המחדל) או sam-3, בחצי מחיר. |
hold_last_mask | boolean | ברירת המחדל: false. כשהערך true, פריימים שבהם הנושא אובד חוזרים על המסכה האחרונה שלא הייתה ריקה, לכל היותר שנייה אחת. |
min_subject_height_pct | number | מ-0 עד 100. ברירת המחדל: 0, כבוי. מסיר אזורים שהגובה שלהם קטן מהאחוז הזה מגובה הפריים, לפני החזקת המסכה. |
max_subject_height_pct | number | מ-0 עד 100. ברירת המחדל: 0, כבוי. מסיר אזורים שהגובה שלהם גדול מהאחוז הזה מגובה הפריים. מינימום שגבוה מהמקסימום נדחה. |
zone | object | ברירת המחדל: כבוי. left_pct, right_pct, top_pct ו-bottom_pct, כל אחד מ-0 עד 49% מהפריים. נשמרים רק אזורים שהמרכז שלהם נמצא בתוך התחום שהשוליים האלה תוחמים, למשל כדי להסיר את הפנים בקצוות התמונה. שוליים שלא נשלחו הם 0. גם {} ריק פירושו כבוי. |
per_shot | boolean | ברירת המחדל: false. כשהערך true, החיתוכים בין הסצנות בקליפ מזוהים קודם, והנושא מזוהה מחדש בכל שוט. ההחזקה אף פעם לא מעבירה מסכה מעבר לחיתוך. בקליפ בלי חיתוכים, התוצאה היא אותה מסכה, מותאמת למספר הפריימים המדויק של הקליפ. המחיר לא משתנה. |
redetect_every_sec | number | 0 (ברירת המחדל, כבוי) או ערך מ-1 עד 10. מזהה את הנושא מחדש גם אחרי כל פרק זמן באורך הזה, בתוך כל שוט כשמשתמשים ב-per_shot. כך נתפס מישהו שמופיע או שמסתובב למצלמה באמצע שוט. ההרצה איטית יותר, והמחיר לא משתנה. |
קליפ שאי אפשר לקרוא, או קליפ ארוך מדי, נדחה עוד לפני כל חיוב. פרומפט שלא מתאים לשום דבר באף פריים נכשל, והקרדיטים מוחזרים. כשמסנני הגודל או האזור לא משאירים שום דבר באף פריים, התוצאה היא מסכה ריקה, שנמסרת ומשלמים עליה כרגיל. הפלט של המשימה כולל אז kept: false. כדי להבחין בין מסכה ריקה למסכה קטנה מאוד, בדקו את kept ולא את coverage. עם per_shot, הפלט מדווח גם על shots, מספר השוטים שנמצאו. השדה chunks בפלט סופר את הבקשות שנשלחו למודל, ו-recipe הוא הגרסה של שיטת המיסוך שיצרה את המסכה. העבירו את מזהה המשימה ל-mask_composite בתור mask_asset_id.
מה חוזר: מזהה משימה.
lip_sync
גורם לפנים לדבר או לשיר לפי רצועת אודיו: פורטרט הופך לראש מדבר, או שהפה בקליפ קיים מסתנכרן לאודיו חדש. הכלי עובד כמו רכיב סנכרון שפתיים.
הרשאה: workflows:execute. קרדיטים: המחיר של המודל. התיאור של הפרמטר model בכלי מפרט את המחיר של כל מודל.
| פרמטר | סוג | הערות |
|---|---|---|
image_url או image_asset_id | string | פורטרט. השתמשו בו עם kling-avatar, עם kling-avatar-pro ועם infinitalk. |
video_url או video_asset_id | string | קליפ של הפנים, למודלים שמסנכרנים מחדש סרטון קיים, כגון latentsync ו-video-retalking. |
audio_url או audio_asset_id | string | הדיבור או השיר. |
audio_duration_sec | number | אורך האודיו, מ-0.1 עד 600 שניות. במודלים שמתומחרים לפי שנייה, השריון והחיוב נקבעים לפי האורך הזה. כשמשמיטים אותו, האודיו נמדד קודם. |
model | string | ברירת המחדל: kling-avatar, ראש מדבר ב-720p. בין המודלים האחרים: kling-avatar-pro, infinitalk, omnihuman-1-5, latentsync, wav2lip, video-retalking, sadtalker, heygen-lipsync-precision, lipsync-2-pro, sync-lipsync-v3, volcengine-lipsync, משפחת Seedance 2 ו-minimax-h3. מזהה לא מוכר מוחלף ב-kling-avatar. |
prompt | string | רמז להופעה, כגון a confident TED speaker (נואם TED בטוח בעצמו), עד 500 תווים. חלק מהמודלים משתמשים בו. |
resolution | string | ב-InfiniTalk: הערך 480p או 720p. ב-Seedance 2 וב-Seedance 2 Fast: הערך 480p, 720p או 1080p. ב-OmniHuman 1.5: הערך 720p או 1080p (ברירת המחדל). |
seed, fast_mode | ב-OmniHuman 1.5 בלבד: זרע קבוע, ומצב מהיר יותר באיכות מעט נמוכה יותר. | |
mode | string | ב-Volcengine בלבד: lite (ברירת המחדל, אדם אחד מול המצלמה) או basic (סצנות מורכבות). |
open_scenedet, separate_vocal, align_audio, align_audio_reverse, templ_start_seconds | ב-Volcengine בלבד: זיהוי דוברים כשיש כמה דוברים, הסרת רעשים מהאודיו, לולאה של סרטון המקור לאורך האודיו וזמן ההתחלה במקור. |
הכלי get_node_skill עם lip-sync מסביר איזה מודל מתאים לשירה, לדיבוב, לשוטים קולנועיים של גוף מלא או לטיוטה הזולה ביותר.
| מודל | יצרן | מצבים | קרדיטים | פרטים |
|---|---|---|---|---|
| MiniMax H3 | MiniMax | תמונה לווידאו, טקסט לווידאו | החל מ-253 | MiniMax H3 — רמת פרימיום מולטימודלית: פריים פתיחה וסיום, ייחוסי תמונה, וידאו ואודיו, אודיו מובנה, פלט ב-2K (ברירת מחדל) או ב-768P, ותמחור לפי שנייה, 4–15 שניות. |
| Kling Avatar Standard | Kuaishou | סנכרון שפתיים | 308 | סנכרון שפתיים של פורטרט סטטי לאודיו מוביל. איכות סטנדרטית. |
| Kling Avatar Pro | Kuaishou | סנכרון שפתיים | 616 | סנכרון שפתיים ברמת פרימיום — צורת פה ותזמון טובים יותר. |
| Seedance 2 | Bytedance | תמונה לווידאו, טקסט לווידאו | החל מ-253 | Seedance 2 — רמת פרימיום עם אודיו מובנה. תמחור לפי שנייה, בהתאם לרזולוציה. |
| Seedance 2 Fast | Bytedance | תמונה לווידאו, טקסט לווידאו | החל מ-198 | הרמה הזולה והמהירה יותר של Seedance 2. |
| Seedance 2 Mini | Bytedance | תמונה לווידאו, טקסט לווידאו | החל מ-132 | הרמה החסכונית של Seedance 2 — 480p/720p בלבד, תמחור לפי שנייה בהתאם לרזולוציה. |
| Seedance 2.5 | Bytedance | תמונה לווידאו, טקסט לווידאו | החל מ-374 | Seedance 2.5 — עד 30 שניות בשוט אחד, אודיו מובנה ומגוון רחב של ייחוסים מולטימודליים. 480p/720p/1080p. |
| OmniHuman 1.5 | Bytedance | סנכרון שפתיים | החל מ-1,122 | אווטאר מדבר ברמת פרימיום, מונחה בפרומפט, מתמונה סטטית ואודיו. 720p / 1080p, עד 60 שניות. אנשים, חיות מחמד ואנימה. |
| InfiniTalk | InfiniTalk | סנכרון שפתיים | החל מ-121 | ראש מדבר מתמונה סטטית, שהאודיו מניע אותו. 480p / 720p. |
| Sync Lipsync v3 | Sync | סנכרון שפתיים | החל מ-1,100 | דיבוב של סרטון קיים — מסנכרן מחדש את השפתיים לרצועת אודיו חדשה. קלט וידאו, חיוב לפי שנייה. |
| Volcengine Lip Sync | Volcengine | סנכרון שפתיים | החל מ-330 | דיבוב AI מווידאו לווידאו — מסנכרן מחדש את השפתיים לרצועת קול חדשה. כמה דוברים (זיהוי סצנות וזיהוי דוברים) במצב הבסיסי. קלט וידאו, חיוב לפי שנייה. |
מה חוזר: מזהה משימה. הכרטיס מציג את הסרטון כשהוא מוכן.
speech_to_video
מנפיש פורטרט כך שהוא מדבר לפי קטע אודיו: השפתיים מסונכרנות לדיבור, והראש והגוף זזים. הכלי מריץ את Wan Speech to Video ועובד כמו רכיב דיבור לווידאו.
הרשאה: workflows:execute. קרדיטים: 33–66.
| פרמטר | סוג | הערות |
|---|---|---|
prompt | string | נדרש. התנועה והסצנה, עד 2,500 תווים. |
image_url או image_asset_id | string | הפורטרט. |
audio_url או audio_asset_id | string | הדיבור. |
resolution | string | 480p (ברירת המחדל), 580p או 720p. |
negative_prompt | string | ממה להימנע, עד 2,500 תווים. |
מה חוזר: מזהה משימה.
motion_transfer
מעתיק את התנועה מסרטון מניע לתמונה של דמות, כך שהדמות מבצעת את אותה תנועה. הכלי עובד כמו רכיב העברת תנועה.
הרשאה: workflows:execute. קרדיטים: המחיר נקבע לפי המודל ולפי משך הסרטון.
| פרמטר | סוג | הערות |
|---|---|---|
image_url או image_asset_id | string | נדרש. הדמות. |
video_url או video_asset_id | string | נדרש. הסרטון שהתנועה שלו מועתקת. |
prompt | string | התוצאה שאתם רוצים, עד 8,000 תווים. |
provider | string | המודל. ברירת המחדל: kling. |
resolution | string | 480p, 580p, 720p (ברירת המחדל) או 1080p. |
character_orientation | string | המסגור של מי גובר: image (ברירת המחדל) או video. |
background_source | string | איזה קלט נותן את הרקע: הערך input_video או input_image, במודלים שתומכים בזה. |
video_duration | number | אורך הפלט, מ-1 עד 60 שניות, במודלים שתומכים בזה. |
מה חוזר: מזהה משימה.
face_swap
מחליף את הפנים בסרטון בפנים מפורטרט. הכלי עובד כמו רכיב החלפת פנים.
הרשאה: workflows:execute. קרדיטים: 143.
| פרמטר | סוג | הערות |
|---|---|---|
video_url או video_asset_id | string | סרטון המקור. |
face_image_url או face_image_asset_id | string | הפורטרט שממנו נלקחות הפנים. |
מה חוזר: מזהה משימה.
cast_swap
Nodaro Motion לוקח סרטון באורך 4–30 שניות ומחליף בו את האנשים, חיות המחמד, המוצרים או המקום לפי תמונות הייחוס שלכם. הסרטון שומר על התנועה, המסגור, התזמון והסאונד שלו: האודיו של הקליפ נשמר, והתוצאה באורך של הקליפ. הכלי שומר על השם שלו, cast_swap, ומריץ את ה-API של Nodaro Motion. ב-Nodaro Cloud בלבד.
הרשאה: workflows:execute. קרדיטים: אומדן המחיר שהכלי מחזיר קודם. שום דבר לא נגבה עד שהאומדן מאושר.
| פרמטר | סוג | הערות |
|---|---|---|
video_url | string | נדרש. קליפ המקור, מ-4 עד 30 שניות. |
roles | array | נדרש. עד 6 { kind: "person", name, images?, body?, outfit?, hair? }, 1 { kind: "location", name?, images? }, 3 { kind: "pet", name, images?, body?, coat? } ו-3 { kind: "product", name, images?, shape?, finish? }. כל תפקיד מקבל בין 0 ל-3 תמונות של נושא אחד או של מקום אחד, ועד 30 תמונות בסך הכול. תפקיד בלי תמונות נשאר כמו בסרטון. כל תכונה היא "new" (ברירת המחדל), מהתמונות, או "original", מהסרטון. כל תפקיד יכול לקבל גם preview_name, השם שלו בתצוגה מקדימה, ו-in_preview: false, שמשאיר אותו מחוץ לתצוגה מקדימה. הרצה מלאה מתעלמת משניהם. |
pre_prompt | string | טקסט משלכם שמוצב לפני ההוראות של התפקידים. אותה מגבלה ואותם אזכורי {role:N} כמו ב-post_prompt. |
post_prompt | string | טקסט משלכם, עד 4,000 תווים. הזכירו תפקיד כ-{role:N}, כש-N הוא המיקום שלו ב-roles, בספירה מ-1, כולל תפקידים ריקים. |
preview | boolean | מרנדר 4 שניות, החל מ-preview_start (ברירת המחדל: 0). |
engine | string | motion-prism (Nodaro Motion Prism, ברירת המחדל) או motion-pulse (Nodaro Motion Pulse). Nodaro Motion Pulse מרנדר ב-720p או ב-1080p, בלי טיוטה, ויוצר טייק חדש על סמך הקליפ והתמונות. הוא מקבל לכל היותר 10 תמונות, ויותר מזה נדחה עם too_many_images. גרסת האיכות המלאה שלו היא טייק חדש ב-1080p. |
style | string | המצב precise (ברירת המחדל) נצמד לקליפ בדיוק. המצב motion נצמד לתנועה של הקליפ ולוקח את המראה מהתמונות, בחופשיות רבה יותר מ-precise. המחיר שלו יכול להיות שונה, ואומדן המחיר מציג אותו. |
art_style | string | סגנון אמנותי ב-motion-prism: מזהה מהקטלוג של הבורר סגנון, שמקבלים מ-get_picker_catalog עם "style", כגון pop-art. הוא עובד בהרצה עם style: "motion", ובהרצה במצב precise כשהמנוע מקבל סגנון כזה (preciseArtStyle ב-GET /v1/cast-swap/style-choice). Nodaro עשוי להריץ קריאה כזו במצב precise כהרצה במצב motion. הפרומפט מקבל את הניסוח של הסגנון לווידאו. כשאין אף תפקיד עם תמונות ואין ייחוסים (roles יכול להיות []), הרצה במצב motion מעצבת מחדש את הקליפ כולו, אם המנוע מקבל הרצות של סגנון בלבד (styleOnly). ראו בדף ה-API סגנונות אמנותיים. המנוע motion-pulse לא מקבל סגנון אמנותי ודוחה אותו עם art_style_needs_prism. פרמטר direction משלכם שנשלח יחד איתו נדחה עם use_art_style. |
motion_length | string | ב-motion-pulse בלבד. Nodaro Motion Pulse מרנדר שניות שלמות. הערך cut-end (ברירת המחדל) חותך את הקליפ לשניות שלמות בסוף שלו, והערך cut-start בתחילתו. |
resolution | string | 480p (ברירת המחדל), 720p או 1080p. ב-motion-pulse, 720p (ברירת המחדל שלו) או 1080p. |
draft | boolean | מרנדר טיוטה. מופעל כברירת מחדל ב-480p וכבוי מעל זה. הערך true מעל 480p נדחה, והמנוע motion-pulse דוחה אותו עם draft_unsupported. |
references | array | עד 5 ייחוסים קבועים, שאף תפקיד לא מחליף. כל אחד הוא { images, line }: 1–3 תמונות של דבר אחד, ושורה שמציינת אותו, כגון "the glass she drinks from" (הכוס שהיא שותה ממנה). בשורה, {image} מייצג את התמונה הראשונה שלו. ייחוסים נשלחים כפי שהם, ואף פעם לא עוברים הכנה. התמונות שלהם נספרות במסגרת ה-30. ייחוס לבדו מספיק להרצה. אסימון {role:N} או אסימון {image: גולמי בשורה נדחה. |
prepare_references | boolean | ברירת המחדל: true. לפני הסרטון, מודל תמונה הופך את התמונות של כל תפקיד מסוג אדם, חיית מחמד ומוצר לתמונת ייחוס נקייה אחת. ההכנה עולה קרדיטים נוספים, שנגבים גם אם הסרטון נכשל אחר כך, ומוסיפה כדקה. הערך false מדלג עליה. |
quality | string | מיושן. הערך draft פירושו טיוטה ב-480p. השתמשו ב-resolution וב-draft. |
session_id | string | אחד מסשני היצירה שלכם, שבו התוצאה תתויק. סשן שאין לכם גישה אליו נדחה עם not_found. כך גם סשן של לקוח שמחובר ב-OAuth בלי assets:write. |
client_request_id | string | אסימון ניסיון חוזר. אם אתם מנסים שוב, שלחו את אותו ערך, כדי ש-Nodaro לא יתחיל את ההרצה ולא יחייב אותה פעמיים. |
confirm | boolean | השמיטו אותו כדי לקבל רק את אומדן המחיר. ראו את הסעיף אומדן המחיר. הגדירו את confirm ל-true רק אחרי שהמחיר אושר. |
הכנת הקליפ
Nodaro קובע לכל מנוע איך להכין את הקליפ למודל הווידאו. למשל, הוא מחליט אם לנסות שוב קליפ שהמודל דוחה. לכלי אין הגדרה לזה. ההגדרה face_masking, שלקוח ישן יותר עדיין שולח, לא נלקחת בחשבון.
אומדן המחיר
בלי confirm, הכלי מחזיר את אומדן המחיר ולא גובה כלום:
- השדה
totalCreditsהוא הסכום שמשוריין כשההרצה מתחילה, והשדהexpectedCreditsהוא החיוב הצפוי של ההרצה. - השדה
breakdownמפרט את החלקים:base,references(הכנת הייחוסים, 0 כשההכנה כבויה או כשאין מה להכין),motion(השריון לסרטון),motionExpected(החיוב הצפוי על הסרטון) ו-privacy(הכנת הקליפ). אומדן המחיר יכול לציין גם אתprompt, הפרומפט שמודל שפה כותב, ואתreferenceAudio, הכנת הסאונד של הקליפ. כל אחד משני אלה מופיע רק כשההגדרה של המנוע מריצה את השלב הזה. בהרצה של סגנון בלבד אין חלקprivacy. הרצה עםart_styleיכולה לציין גם אתstyleRefs. השדהstyleRefsהוא השלב שבו תמונות התפקידים מצוירות קודם מחדש בסגנון האמנותי, כשההגדרה של Nodaro למנוע עושה זאת. הוא מופיע רק במקרה הזה, והוא כלול בשני הסכומים. השדותmotionו-motionExpectedהם חלופות, ולכן בדקו את הסכומים הכוללים, ולעולם אל תחברו את החלקים. - הערך
settlesLower: trueפירושו שאורך הסרטון נתון להחלטת המודל, ולכן החיוב הסופי צפוי להיות נמוך יותר. ב-motion-pulse,expectedCreditsשווה ל-totalCredits, ו-settlesLowerהואfalse. - השדות
engineו-engineNameמציינים את המנוע שאומדן המחיר מתייחס אליו. - הסכום
privacyCredits, כשהוא מופיע, נגבה רק אם הקליפ נדחה ומנסים שוב את ההרצה. הוא לא כלול באף אחד מהסכומים.
מה חוזר: בלי confirm, אומדן המחיר. עם confirm: true, מזהה משימה. בדקו את הסטטוס שלה מדי כמה שניות עם wait_for_job. כל אחד מהמקרים האלה חוזר כשגיאת כלי:
- יותר מדי תפקידים מאותו סוג, או יותר מ-30 תמונות.
- טיוטה מעל 480p, או כל טיוטה ב-
motion-pulse. - בפריסה שעדיין לא מריצה את
motion-pulse, הערךengine: "motion-pulse"נדחה עםengine_unavailableעוד לפני שנשלח משהו. - בפריסה שהמנוע שלה עדיין לא מקבל סגנון אמנותי,
art_styleנדחה עםart_style_unavailableעוד לפני שנשלח משהו. - הפרמטר
art_styleבהרצה במצבpreciseכשהמנוע לא מקבל סגנון אמנותי במצב הזה, או בהרצה במצבmotionשהפרומפט שלה הופך ל-preciseלפי ההגדרה של Nodaro (art_style_needs_flex), סגנון שלא נמצא בקטלוג (unknown_art_style) או מודבורד שמור (art_style_not_supported). - קליפ שהאורך שלו לא בין 4 ל-30 שניות, או תצוגה מקדימה שחורגת מסוף הקליפ.
- אסימון
{role:N}שה-N שלו גדול ממספר התפקידים, או אסימון{image:,{video:או{audio:גולמי. - פרומפט שהיה יוצא ארוך מדי.
estimate_full_quality ו-full_quality
אפשר להשלים באיכות מלאה שני סוגים של הרצות Nodaro Motion או של הרצות טרנד, ב-1080p ועם האודיו של הקליפ, כמשימה חדשה שמקושרת להרצה. בהרצה שנוצרה כטיוטה, אותו טייק מרונדר מחדש ב-1080p. בהרצה של Nodaro Motion Pulse ב-720p, נוצר טייק חדש ב-1080p מאותם קלטים. הכלים מריצים את ה-API של Nodaro Motion. ב-Nodaro Cloud בלבד.
הרשאה: workflows:execute. קרדיטים: אומדן המחיר שהכלים מחזירים. שום דבר לא נגבה עד שהאומדן מאושר.
הכלי estimate_full_quality מחזיר אומדן מחיר בחינם, ושום דבר לא מתחיל. הכלי מקבל job_id: הרצת טיוטה שהסתיימה (משימת cast_swap או run_trend שנוצרה כטיוטה), או הרצת motion-pulse שהסתיימה ב-720p, עד 7 ימים אחרי שהיא הושלמה. הכלי מחזיר את kind, את totalCredits, את ה-breakdown שלו ואת availableUntil. השדה kind הוא "same-take", הטייק של הטיוטה עצמה ב-1080p, או "new-take", טייק חדש של motion-pulse ב-1080p. שרת ישן יותר משמיט את kind, וזה אומר שמדובר באותו טייק. השדה totalCredits הוא breakdown.base, שלבי ההשלמה, ועוד הרינדור. באותו טייק, הרינדור הוא breakdown.motionHd, הרינדור ב-1080p. הוא 0 כשניסיון קודם של הטיוטה הזו נכשל אבל כבר השלים את הרינדור הזה, ואז Nodaro משתמש בו שוב. בטייק חדש, הרינדור הוא breakdown.motion.
הכלי full_quality מקבל:
| פרמטר | סוג | הערות |
|---|---|---|
job_id | string | נדרש. ההרצה שהסתיימה, כמו ב-estimate_full_quality. |
session_id | string | אחד מסשני היצירה שלכם, שבו המשימה החדשה תתויק. סשן שאין לכם גישה אליו נדחה עם not_found. |
confirm | boolean | השמיטו אותו כדי לקבל רק את אומדן המחיר. הגדירו אותו ל-true רק אחרי שהמחיר אושר. |
מה חוזר: בלי confirm, אומדן המחיר. עם confirm: true, המזהה של המשימה החדשה. בדקו את הסטטוס שלה מדי כמה שניות עם wait_for_job. לכל הרצה יש משימת איכות מלאה אחת. כשהמשימה כבר רצה או הסתיימה, הכלי מחזיר אותה עם existing: true ולא גובה כלום. אפשר לבקש שוב משימה שנכשלה. אין client_request_id, כי המשימה מזוהה לפי הטיוטה.
דחיות חוזרות כשגיאות כלי: not_found, not_completed, not_a_draft, draft_expired, full_quality_unavailable, וב-full_quality גם insufficient_credits או תקרה של סביבת העבודה. הקוד full_quality_pending הוא לא סופי: רינדור ה-1080p של ניסיון קודם נמצא בבדיקה או עוד לא התחיל. נסו שוב מאוחר יותר.
טרנדים
טרנד הוא מתכון מוכן של Nodaro Motion: קליפ קצר עם משבצות לאנשים, לחיות המחמד, למוצרים או למקום, שאתם ממלאים בתמונות שלכם. ארבעה כלים מריצים אותם, דרך ה-API של הטרנדים. ב-Nodaro Cloud בלבד.
| כלי | הרשאה | מה הוא עושה |
|---|---|---|
list_trends | jobs:read | הקטלוג שפורסם: לכל כרטיס ה-slug, השם, התגיות, מה הוא צריך מכל סוג והאורך שלו. פרמטרים אופציונליים: query, tag, favorites: true ו-cursor. |
get_trend | jobs:read | טרנד אחד לפי slug: ה-original שלו, הקליפ שכל הרצה מתחילה ממנו, להצגה (videoUrl, posterUrl, width, height, durationSec ו-previewStartSec כשיש לו תצוגה מקדימה; בטרנד שמסתיר את הקליפ המקורי שלו, זו הדוגמה הראשונה שלו, ו-examples מתחיל אז מהשנייה), ה-slots שלו (key, label, kind, required, hint, hintImageUrl, תמונה של מי או מה שהמשבצת מייצגת במקור, chips, התגיות שאפשר להגדיר במשבצת הזו או [] כשאין כאלה, וערכי ברירת המחדל שלהן), ה-examples שלו, שיכול להיות ריק, previewSec (4, או null), engine, המנוע שכל הרצה משתמשת בו (motion-prism או motion-pulse), עם ה-engineName שלו ("Nodaro Motion Prism" או "Nodaro Motion Pulse"), ו-resolutions, הרזולוציות שהרצה יכולה לבקש, ברירת המחדל ראשונה. ב-motion-prism, 480p היא טיוטה. המנוע motion-pulse מציע 720p ו-1080p, בלי טיוטה. slug לא מוכר, או slug של טרנד בטיוטה, שלא פורסם או שבארכיון, נדחה עם not_found. |
estimate_trend | workflows:execute | אומדן מחיר בחינם: expectedCredits, החיוב הצפוי של ההרצה, ו-holdCredits, הסכום שמשוריין בזמן שהיא רצה. בטרנד שמנסה שוב קליפ שמודל הווידאו דוחה, הכלי מחזיר גם privacyCredits. הסכום הזה נגבה רק אם הניסיון החוזר הזה רץ. הוא לא כלול בשני הסכומים, וגם החלק שלו ב-breakdown לא כלול בהם. הערך שלו 0 בטרנד שהקליפ שלו הוכן מראש. אותם ארגומנטים כמו ב-run_trend, בלי session_id ו-confirm. |
run_trend | workflows:execute | יוצר את הסרטון של הטרנד עם התמונות שלכם. |
הכלי run_trend מקבל:
| פרמטר | סוג | הערות |
|---|---|---|
slug | string | נדרש. הטרנד. ה-slug runs נדחה. |
slots | object | נדרש. אובייקט שהמפתחות שלו הם מפתחות המשבצות של הטרנד: { images?, …chips }, עם 1–3 כתובות URL של תמונות של נושא אחד. כל משבצת נדרשת צריכה תמונות. התגיות הן אלה ש-get_trend מפרט ב-chips של המשבצת, כל אחת "new" או "original", מתוך התגיות של הסוג: לאדם body, outfit, hair; לחיית מחמד body, coat; למוצר shape, finish. הערך של תגית שהמשבצת לא מפרטת קבוע בטרנד. |
example | integer | משבצת אופציונלית שלא נשלחה מקבלת את התמונות של הדוגמה הזו. המספור מתחיל ב-1, לפי הסדר שבו get_trend מפרט את ה-examples שלו, וברירת המחדל היא 1. כשלדוגמה הזו אין תמונות למשבצת, המשבצת נשארת כמו במקור. השמיטו את הפרמטר בטרנד בלי דוגמאות: משבצת אופציונלית שלא נשלחה נשארת אז כמו במקור. בטרנד שמסתיר את המקור שלו, כשמשמיטים את הפרמטר, הכלי משתמש בדוגמה שמוצגת כ-original שלו. טרנד בעומק מלא אף פעם לא משתמש בדוגמאות: משבצת אופציונלית שלא נשלחה מקבלת את תמונת ברירת המחדל של הטרנד לתפקיד הזה, אם הוגדרה כזו, ואחרת את המראה של המקור. |
details | string | עד 1,000 תווים. הזכירו משבצת כ-{slot:<key>}. |
preview | boolean | הרצה באורך 4 שניות, כש-previewSec הוא 4. |
resolution | string | אחת מהרזולוציות ב-resolutions של get_trend. ברירת המחדל היא הרזולוציה הראשונה ברשימה. ערך אחר נדחה עם resolution_unsupported. |
draft | boolean | ברירת המחדל: true, ב-480p בלבד. לטרנד של motion-pulse אין טיוטה, ו-true נדחה עם draft_unsupported. |
preview_job_id | string | להרצה מלאה: מזהה המשימה של תצוגה מקדימה שהושלמה של הטרנד הזה, מהחשבון שלכם. ההרצה פועלת אז כבר מההתחלה כמו הניסיון החוזר של התצוגה המקדימה הזו. כל משימה אחרת לא נלקחת בחשבון. |
session_id | string | מתקבל, אבל עדיין לא מוחל: הרצות טרנד עדיין לא מתויקות בסשנים. הסשן בכל זאת נבדק: סשן שאין לכם גישה אליו נדחה עם not_found. |
client_request_id | string | אסימון ניסיון חוזר. |
confirm | boolean | השמיטו אותו כדי לקבל רק את אומדן המחיר. הגדירו אותו ל-true רק אחרי שהמחיר אושר. |
מה חוזר: בלי confirm, אומדן המחיר. עם confirm: true, מזהה משימה. בדקו את הסטטוס שלה מדי כמה שניות עם wait_for_job. דחייה, כגון missing_slot, unknown_slot, invalid_choice או chip_not_offered, חוזרת כשגיאת כלי. שגיאה של משבצת מציינת את המפתח של המשבצת. אפשר להשלים ב-1080p, עם full_quality, הרצת טרנד שנוצרה כטיוטה או הרצת טרנד של motion-pulse ב-720p.
stop_video_pro
עוצר משימה פעילה של יצירת וידאו Pro, המנוע שיוצר סרטונים ארוכים במקטעים, למשל מתהליך עם רכיב יצירת וידאו Pro. המקטע שמרונדר באותו רגע ננטש, אבל משלמים עליו בכל זאת, שאר המקטעים לא נוצרים, וכל המקטעים שהסתיימו מאוחדים לסרטון הסופי של המשימה. שאר הקרדיטים המשוריינים מוחזרים. משימה שעוד לא התחילה מבוטלת עם החזר מלא.
הרשאה: workflows:execute. קרדיטים: חינם; הקרדיטים המשוריינים שלא נדרשו מוחזרים.
| פרמטר | סוג | הערות |
|---|---|---|
job_id | string | נדרש. משימת יצירת וידאו Pro. |
מה חוזר: אישור. בדקו את הסטטוס של המשימה מדי כמה שניות עם get_job: היא מסתיימת כש-output_data.pro.stopped מוגדר ל-true, והתוצאה שלה היא הסרטון החלקי.
continue_video_pro
ממשיך הרצה של יצירת וידאו Pro שנעצרה, נכשלה או הושלמה, כמשימה חדשה. המקטעים שלפני from_segment משמשים שוב, וכל מקטע ממנו והלאה נוצר מחדש. הרצה שנכשלה צריכה לפחות מקטע אחד שנמסר.
הרשאה: workflows:execute. קרדיטים: רק המקטעים שנוצרים מחדש, ועוד התשלום הקבוע של יצירת וידאו Pro.
| פרמטר | סוג | הערות |
|---|---|---|
job_id | string | נדרש. משימת יצירת וידאו Pro המקורית. |
from_segment | integer | המקטע הראשון ליצירה מחדש, בספירה מ-1, עד 24. ברירת המחדל: המקטע החסר הראשון. העבירו מקטע מוקדם יותר כדי ליצור מחדש את הסוף של הרצה שהושלמה. |
מה חוזר: המזהה של המשימה החדשה.
שאלות נפוצות
באיזה מודל הכלי generate_video משתמש כברירת מחדל?
הכלי generate_video משתמש כברירת מחדל ב-Seedance 2 Fast. כדי להחליף אותו, העבירו בפרמטר model מזהה אחר מהכלי list_models. מזהה לא מוכר מוחלף בברירת המחדל בלי שגיאה, וכשלא מעבירים רזולוציה, הכלי משתמש ברזולוציה הנמוכה ביותר של המודל, שהיא גם הזולה ביותר.
מה ההבדל בין generate_video ל-animate_image?
הכלי generate_video מתחיל מטקסט. הכלי animate_image מתחיל מתמונת סטילס, ויכול לקבל גם פריים סיום, כך שהסרטון עובר מתמונה אחת לאחרת.
איך גורמים לפורטרט לדבר דרך MCP?
קראו לכלי lip_sync עם פורטרט או סרטון של הפנים ועם רצועת אודיו. מודל ברירת המחדל של הכלי הוא Kling Avatar. אפשרות נוספת היא הכלי speech_to_video, שמנפיש פורטרט לפי קטע דיבור.
כמה עולה יצירת וידאו דרך MCP?
יצירת וידאו דרך MCP עולה כמו בעורך. רוב מודלי הווידאו מתומחרים לפי משך ורזולוציה, ולכן בדקו את המחיר של המודל בכלי list_models לפני שאתם נותנים אומדן מחיר.
האם אפשר להרחיב סרטון שלא נוצר ב-Nodaro?
כן, עם המודל seedance-2-extend. המודל הזה מרחיב כל סרטון לפי כתובת URL או לפי מזהה של Nodaro. המודלים veo-extend ו-runway-extend ממשיכים רק סרטון שהם עצמם יצרו קודם.
דפים קשורים
יצירת וידאו
סנכרון שפתיים
עריכת וידאו
תמונה
טרנדים
עודכן לאחרונה