# וידאו

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

Source: https://nodaro.ai/he/docs/mcp/tools/video

**כלי הווידאו** מאפשרים לעוזר AI ליצור ולשנות וידאו ב-Nodaro: ליצור קליפ מטקסט או מתמונה, להרחיב אותו או לעצב אותו מחדש, להאיר אותו מחדש, להגדיל אותו ולגרום לפנים לדבר או להעתיק תנועה. כל כלי מתחיל משימה ומחזיר את המזהה שלה, והתוצאה נשמרת בספרייה שלכם. כל כלי וידאו צריך את ההרשאה `workflows:execute`. משימות וידאו נמשכות בדרך כלל בין 2 ל-10 דקות.

| כלי | מה הוא עושה |
| --- | --- |
| [`generate_video`](#generate_video) | טקסט לווידאו, עם ייחוסים אופציונליים |
| [`animate_image`](#animate_image) | תמונה לווידאו, עם פריים סיום אופציונלי |
| [`extend_video`](#extend_video) | ממשיך קליפ קדימה בזמן |
| [`modify_video`](#modify_video) | מעצב מחדש או עורך קליפ לפי פרומפט |
| [`relight_video`](#relight_video) | מאיר מחדש קליפ, או מחליף את הרקע שלו, על סמך הפיקסלים של הקליפ עצמו |
| [`video_upscale`](#video_upscale) | מגדיל קליפ, או משלים טיוטה של Seedance 2.5 ב-1080p |
| [`video_depth`](#video_depth) | הופך קליפ לסרטון עומק |
| [`video_mask`](#video_mask) | עוקב אחרי נושא שמתואר בטקסט ומחזיר סרטון מסכה |
| [`lip_sync`](#lip_sync) | גורם לפנים לדבר או לשיר לפי רצועת אודיו |
| [`speech_to_video`](#speech_to_video) | מנפיש פורטרט לפי קטע דיבור |
| [`motion_transfer`](#motion_transfer) | מעתיק את התנועה של סרטון לתמונה של דמות |
| [`face_swap`](#face_swap) | מחליף פנים בסרטון |
| [`cast_swap`](#cast_swap) | Nodaro Motion: מחליף את האנשים, חיות המחמד, המוצרים או המקום בסרטון קצר לפי התמונות שלכם |
| [`list_trends`, `get_trend`, `estimate_trend`, `run_trend`](#trends) | מריצים מתכון מוכן של Nodaro Motion עם התמונות שלכם |
| [`stop_video_pro`](#stop_video_pro), [`continue_video_pro`](#continue_video_pro) | עוצרים או ממשיכים הרצה ארוכה של יצירת וידאו Pro |

## `generate_video`
יוצר סרטון מפרומפט טקסט. הכלי עובד כמו רכיב [יצירת וידאו](https://nodaro.ai/docs/nodes/video/generate-video).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של המודל, שברוב המודלים נקבע לפי משך ורזולוציה. בדקו את `pricing` של המודל ב-[`list_models`](https://nodaro.ai/docs/mcp/tools/models-and-credits#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](https://nodaro.ai/docs/nodes/video/generate-video#seedance-25-draft-mode) בדף יצירת וידאו. |
| `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`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_node_presets). שדות שאתם שולחים גוברים עליה. |
| `structured` | object | פרטים בפורמט מובנה שמתווספים לפרומפט, כמו ב-[`generate_image`](https://nodaro.ai/docs/mcp/tools/image#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-a-persons-face). |
| `keep_original_sound` | boolean | ב-Kling 4.0 בלבד. שומר על הסאונד המקורי של סרטוני הייחוס. בלי סרטון ייחוס אין לו השפעה. |
| `audio_soundtrack` | boolean | ב-Kling 4.0 בלבד. כברירת מחדל, הקליפ הראשון ב-`reference_audio_urls` מתנגן כפסקול. הערך `false` שולח כל קליפ כדגימת קול, בלי פסקול. |
| `user_request` | string | ההודעה האחרונה שנשלחה לעוזר, מילה במילה, עד 4,000 תווים. ההודעה נשמרת ברכיב שבתהליך של השיחה, ואף פעם לא משנה את מה שנוצר. ראו [איך שיחות MCP הופכות לתהליכים](https://nodaro.ai/docs/mcp/conversation-flows). |
| `flow_id` | string | הערך `"new"` מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף [התחלה או בחירה של תהליך בעצמכם](https://nodaro.ai/docs/mcp/conversation-flows#start-or-choose-a-workflow-yourself) בדף שיחות MCP. |

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

ב-Seedance, כתבו את הפרומפט של סרטון עם כמה רגעים בצורה `Shot 1: … Shot 2: …` (שוט 1: … שוט 2: …), השתמשו בתנועת מצלמה אחת לכל שוט ותארו את הסאונד בפרומפט. הכלי `get_node_skill` עם `generate-video` מחזיר את כללי כתיבת הפרומפט של כל משפחת מודלים.

סרטון ייחוס אומר למודל להעתיק משהו מהקליפ. כתבו ב-`reference_video_captions` למה הוא משמש. למשל, רינדור חימר אפור של [סצנת תלת־ממד](https://nodaro.ai/docs/mcp/3d-scenes) הוא קו מנחה לפריסה, לא למראה; בלי כיתוב, המודל עלול להעתיק גם את מראה החימר האפור.

### הערות על מודלים
| מודל | מה כדאי לדעת |
| --- | --- |
| 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`
מנפיש תמונת סטילס לסרטון. כשמעבירים גם פריים סיום, הסרטון עובר מהתמונה הראשונה לשנייה. הכלי עובד כמו רכיב [יצירת וידאו](https://nodaro.ai/docs/nodes/video/generate-video) במצב תמונה לווידאו.

**הרשאה:** `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 הופכות לתהליכים](https://nodaro.ai/docs/mcp/conversation-flows). |
| `flow_id` | string | הערך `"new"` מתחיל תהליך חדש לשלב הזה. מזהה תהליך מתוצאה קודמת מוסיף את השלב לתהליך הזה. עד 36 תווים. ראו את הסעיף [התחלה או בחירה של תהליך בעצמכם](https://nodaro.ai/docs/mcp/conversation-flows#start-or-choose-a-workflow-yourself) בדף שיחות MCP. |

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

**מה חוזר:** מזהה משימה.

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

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של מודל ההרחבה.

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Seedance 2 Extend](https://nodaro.ai/docs/models/video/seedance-2-extend) | Bytedance | Video extension | החל מ-286 | Extend ANY video: generates the continuation (audio included) and trim-stitches it into one seamless clip. |
| [VEO Extend](https://nodaro.ai/docs/models/video/veo-extend) | Google | Video extension | החל מ-209 | Extend an existing VEO 3.1 clip by another segment. |
| [Runway Extend](https://nodaro.ai/docs/models/video/runway-extend) | Runway | Video extension | 352 | Extend a Runway video by another clip. |

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `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`
מעצב מחדש או עורך קליפ קיים לפי פרומפט. הכלי עובד כמו רכיב [וידאו לווידאו](https://nodaro.ai/docs/nodes/video/video-to-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 ועובד כמו רכיב [תאורה מחדש והחלפה](https://nodaro.ai/docs/nodes/video/relight-and-switch).

**הרשאה:** `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`
מגדיל קליפ לרזולוציה גבוהה יותר. הכלי עובד כמו רכיב [הגדלת וידאו](https://nodaro.ai/docs/nodes/video/upscale-video).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר של מודל ההגדלה. ב-Topaz החיוב הוא לפי שימוש: משוריינים קרדיטים לפי גודל הפלט, ומשלמים על מה שההגדלה השתמשה בו בפועל. ראו את הסעיף [קרדיטים](https://nodaro.ai/docs/nodes/video/upscale-video#credits) בדף הגדלת וידאו.

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Topaz Video Upscale](https://nodaro.ai/docs/models/video/topaz-video-upscale) | Topaz | Video upscaling | 209 | High-quality video upscale and enhancement. |
| [VEO 1080p Upscale](https://nodaro.ai/docs/models/video/veo-1080p-upscale) | Google | Video upscaling | 22 | Upscale VEO output to 1080p. |
| [VEO 4K Upscale](https://nodaro.ai/docs/models/video/veo-4k-upscale) | Google | Video upscaling | 418 | Upscale VEO output to 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 (מטיוטה)](https://nodaro.ai/docs/nodes/video/upscale-video#seedance-25-hd-from-draft) בדף הגדלת וידאו.

**מה חוזר:** מזהה משימה.

## `video_depth`
הופך סרטון לסרטון עומק, שבו הקרוב בהיר והרחוק כהה. הכלי עובד כמו רכיב [עומק וידאו](https://nodaro.ai/docs/nodes/video/video-depth).

**הרשאה:** `workflows:execute`. **קרדיטים:** המחיר נקבע לפי אורך הקליפ. ראו את הסעיף [קרדיטים](https://nodaro.ai/docs/nodes/video/video-depth#credits) בדף עומק וידאו.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `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`
עוקב לאורך סרטון אחרי נושא שמתואר בטקסט פשוט, ומחזיר סרטון מסכה בשחור־לבן, לבן במקום שבו נמצא הנושא. הכלי עובד כמו רכיב [מסכת וידאו](https://nodaro.ai/docs/nodes/video/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`](https://nodaro.ai/docs/mcp/tools/video-editing#mask_composite) בתור `mask_asset_id`.

**מה חוזר:** מזהה משימה.

## `lip_sync`
גורם לפנים לדבר או לשיר לפי רצועת אודיו: פורטרט הופך לראש מדבר, או שהפה בקליפ קיים מסתנכרן לאודיו חדש. הכלי עובד כמו רכיב [סנכרון שפתיים](https://nodaro.ai/docs/nodes/video/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` מסביר איזה מודל מתאים לשירה, לדיבוב, לשוטים קולנועיים של גוף מלא או לטיוטה הזולה ביותר.

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [MiniMax H3](https://nodaro.ai/docs/models/video/minimax-h3) | MiniMax | Image to video, Text to video | החל מ-253 | MiniMax H3 — premium multimodal tier: first/last frame + image/video/audio references, native audio, 2K (default) or 768P output, 4-15s per-second pricing. |
| [Kling Avatar Standard](https://nodaro.ai/docs/models/video/kling-avatar-standard) | Kuaishou | Lip sync | 308 | Lip-sync a still portrait to driving audio. Standard quality. |
| [Kling Avatar Pro](https://nodaro.ai/docs/models/video/kling-avatar-pro) | Kuaishou | Lip sync | 616 | Premium lip-sync — better mouth shape and timing. |
| [Seedance 2](https://nodaro.ai/docs/models/video/seedance-2) | Bytedance | Image to video, Text to video | החל מ-253 | Seedance 2 — premium tier with native audio. Per-second pricing by resolution. |
| [Seedance 2 Fast](https://nodaro.ai/docs/models/video/seedance-2-fast) | Bytedance | Image to video, Text to video | החל מ-198 | Cheaper / quicker Seedance 2 tier. |
| [Seedance 2 Mini](https://nodaro.ai/docs/models/video/seedance-2-mini) | Bytedance | Image to video, Text to video | החל מ-132 | Budget Seedance 2 tier — 480p/720p only, per-second pricing by resolution. |
| [Seedance 2.5](https://nodaro.ai/docs/models/video/seedance-2-5) | Bytedance | Image to video, Text to video | החל מ-374 | Seedance 2.5 — up to 30s in one shot, native audio, wide multimodal references. 480p/720p/1080p. |
| [OmniHuman 1.5](https://nodaro.ai/docs/models/video/omnihuman-1-5) | Bytedance | Lip sync | החל מ-1,122 | Premium prompt-directed talking avatar from a still image + audio. 720p / 1080p, up to 60s. People, pets, anime. |
| [InfiniTalk](https://nodaro.ai/docs/models/video/infinitalk) | InfiniTalk | Lip sync | החל מ-121 | Audio-driven talking-head from a still image. 480p / 720p. |
| [Sync Lipsync v3](https://nodaro.ai/docs/models/video/sync-lipsync-v3) | Sync | Lip sync | החל מ-1,100 | Dub existing footage — re-syncs lips to a new audio track. Video input, billed per second. |
| [Volcengine Lip Sync](https://nodaro.ai/docs/models/video/volcengine-lip-sync) | Volcengine | Lip sync | החל מ-330 | Video-to-video AI dubbing — re-syncs lips to a new vocal track. Multi-speaker (scene detection + speaker ID) in basic mode. Video input, billed per second. |

**מה חוזר:** מזהה משימה. הכרטיס מציג את הסרטון כשהוא מוכן.

## `speech_to_video`
מנפיש פורטרט כך שהוא מדבר לפי קטע אודיו: השפתיים מסונכרנות לדיבור, והראש והגוף זזים. הכלי מריץ את Wan Speech to Video ועובד כמו רכיב [דיבור לווידאו](https://nodaro.ai/docs/nodes/video/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`
מעתיק את התנועה מסרטון מניע לתמונה של דמות, כך שהדמות מבצעת את אותה תנועה. הכלי עובד כמו רכיב [העברת תנועה](https://nodaro.ai/docs/nodes/video/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`
מחליף את הפנים בסרטון בפנים מפורטרט. הכלי עובד כמו רכיב [החלפת פנים](https://nodaro.ai/docs/nodes/video/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](https://nodaro.ai/docs/developers/api/cast-swap). ב-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`: מזהה מהקטלוג של הבורר [סגנון](https://nodaro.ai/docs/nodes/creative-controls/style), שמקבלים מ-[`get_picker_catalog`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#get_picker_catalog) עם `"style"`, כגון `pop-art`. הוא עובד בהרצה עם `style: "motion"`, ובהרצה במצב `precise` כשהמנוע מקבל סגנון כזה (`preciseArtStyle` ב-[`GET /v1/cast-swap/style-choice`](https://nodaro.ai/docs/developers/api/cast-swap#style)). Nodaro עשוי להריץ קריאה כזו במצב `precise` כהרצה במצב `motion`. הפרומפט מקבל את הניסוח של הסגנון לווידאו. כשאין אף תפקיד עם תמונות ואין ייחוסים (`roles` יכול להיות `[]`), הרצה במצב `motion` מעצבת מחדש את הקליפ כולו, אם המנוע מקבל הרצות של סגנון בלבד (`styleOnly`). ראו בדף ה-API [סגנונות אמנותיים](https://nodaro.ai/docs/developers/api/cast-swap#art-styles). המנוע `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 | השמיטו אותו כדי לקבל רק את אומדן המחיר. ראו את הסעיף [אומדן המחיר](#cast-swap-quote). הגדירו את `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`](https://nodaro.ai/docs/mcp/tools/jobs#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](https://nodaro.ai/docs/developers/api/cast-swap). ב-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`](https://nodaro.ai/docs/mcp/tools/jobs#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 של הטרנדים](https://nodaro.ai/docs/developers/api/trends). ב-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`](https://nodaro.ai/docs/mcp/tools/jobs#wait_for_job). דחייה, כגון `missing_slot`, `unknown_slot`, `invalid_choice` או `chip_not_offered`, חוזרת כשגיאת כלי. שגיאה של משבצת מציינת את המפתח של המשבצת. אפשר להשלים ב-1080p, עם [`full_quality`](#full-quality), הרצת טרנד שנוצרה כטיוטה או הרצת טרנד של `motion-pulse` ב-720p.

## `stop_video_pro`
עוצר משימה פעילה של יצירת וידאו Pro, המנוע שיוצר סרטונים ארוכים במקטעים, למשל מתהליך עם רכיב [יצירת וידאו Pro](https://nodaro.ai/docs/nodes/video/generate-video-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 ממשיכים רק סרטון שהם עצמם יצרו קודם.