שילוב לפי מסכה

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

השותף הטבעי של רכיב שילוב לפי מסכה הוא רכיב מסכת וידאו. צרו ברכיב מסכת וידאו מסכה של נושא בסרטון המקורי שלו, ואז השתמשו בסרטון הזה כחזית ובכל סרטון אחר כרקע. כך הנושא מופיע בסצנה החדשה.

רכיב שילוב לפי מסכה לא צריך מפתח ספק, ולכן הוא רץ בכל מהדורה, כולל בהתקנה של מהדורת Community בלי שום מפתח.

מתי להשתמש

• להעביר נושא לסצנה חדשה, למשל רקדן לחוף ים.
• להחליף את הרקע מאחורי מוצר או מגיש.
• להשאיר הכול חוץ מהנושא, עם היפוך המסכה, ולהציב נושא חדש במקומו.
• לשלב שני קליפים דרך מסכה בשחור־לבן שנוצרה בכלי אחר.
• להסתיר פנים, לוחיות רישוי או מסכים בקליפ: בחרו בהגדרה מילוי את פיקסול או טשטוש, והשתמשו כמסכה בפלט של רכיב מסכת וידאו שמסמן אותם.

התחלה מהירה

כדי לטשטש נושא במקומו, חברו את אותו סרטון לקלט רקע ולרכיב מסכת וידאו, ובחרו בהגדרה מילוי את טשטוש. אין צורך בחזית.

קלטים

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

עם פיקסול או טשטוש, התוצאה נקבעת במקום זאת לפי הרקע: הגודל, קצב הפריימים והאורך שלו. הרקע לא מותאם ולא רץ בלולאה.

פלטים

על התוצאה אף פעם אין סימן מים.

הגדרות

מגבלות

• אורך: חזית באורך של עד 300 שניות. עם פיקסול או טשטוש, רקע באורך של עד 300 שניות.

חזית ש-Nodaro לא יכול לקרוא, או חזית ארוכה מ-300 שניות, נדחית עוד לפני כל חיוב.

קרדיטים

רכיב שילוב לפי מסכה עולה 11 קרדיטים לכל 5 שניות של התוצאה, או חלק מהן. התוצאה ארוכה כמו החזית, או כמו הרקע עם פיקסול או טשטוש. הרצה נספרת לפחות כמדרגה אחת של 5 שניות: תוצאה של 3 שניות נספרת כמדרגה אחת, תוצאה של 10 שניות כשתי מדרגות, ותוצאה של 61 שניות כ-13 מדרגות. לפני הספירה, חריגה של עד 0.05 שנייה מעבר לשנייה שלמה לא נלקחת בחשבון, ולכן תוצאה של 10.01 שניות נספרת כשתי מדרגות, לא שלוש.

לפני הרצה, הרכיב יודע מה אורך החזית רק כשהתהליך מעביר לו אותו. אחרת, הרכיב מציג טווח, מהמחיר של מדרגה אחת של 5 שניות ועד המחיר של תוצאה של 300 שניות. ההרצה מודדת את החזית לפני כל חיוב, ואתם משלמים לפי האורך שלה בפועל.

טיפים

• קצצו קודם את החזית. התוצאה ארוכה כמו החזית, ולכן קצצו אותה לרגע שאתם צריכים ברכיב קיצוץ וידאו.
• השתמשו ברקע ארוך לפחות כמו החזית. רקע קצר יותר רץ בלולאה, ועלולה להיראות קפיצה.
• הסירו הילות עם כיווץ. קבעו בהגדרה הרחבה / כיווץ ערך שלילי קטן כשקו דק של הרקע הישן נראה סביב הנושא.
• השאירו קצת ריכוך. כמה פיקסלים של ריכוך מסתירים את הקצה המדורג של מסכה שנוצרה במעקב.
• הסתירו פרטים עם ריבועים גדולים יותר. עם פיקסול, ערך גדול יותר בהגדרה גודל ריבוע (% מהרוחב) מסתיר יותר פרטים.
• כל מסכה מתאימה. סרטון בשחור־לבן או בגווני אפור מכלי אחר, כגון אנימציית צורות מרונדרת, יכול לשמש מסכה.

פתרון בעיות

סביב הנושא יש קו מתאר דק של הרקע הישן. קבעו בהגדרה הרחבה / כיווץ ערך שלילי קטן, והשאירו קצת ריכוך.

הרקע מופיע איפה שהנושא אמור להיות. הקוטביות של המסכה הפוכה. סמנו את התיבה היפוך המסכה.

לתוצאה אין סאונד. רצועת האודיו שנבחרה תחת אודיו לא קיימת בסרטון הזה. בחרו את האודיו של הסרטון השני, או מיקס של שניהם.

לרקע יש פסים שחורים, או שהוא חתוך. שנו את ההגדרה התאמת הרקע. האפשרות מילוי (חיתוך למילוי המסגרת) חותכת, האפשרות התאמה (פסים שחורים) מוסיפה פסים, והאפשרות מתיחה ממלאת את הפריים בלי אף אחד מהם.

דרך ה-API

הנתיב POST /v1/mask-composite מקבל את foregroundUrl, את backgroundUrl ואת maskUrl. ההגדרות האופציונליות הן invertMask, feather (0–20), grow (בין מינוס 10 ל-10), opacity (0–1, ברירת מחדל 1) ו-fill (video, pixelate או blur, ברירת מחדל video). הן כוללות גם את pixelSizePct (0.2–10, ברירת מחדל 1.25), blurStrengthPct (0.1–5, ברירת מחדל 2), backgroundFit (cover, contain או stretch) ו-audioSource (foreground, background, mix או none). הנתיב מחזיר משימה. השדה foregroundUrl נדרש עם המילוי video. עם pixelate או blur, חזית שנשלחת לא נלקחת בחשבון, וגם audioSource לא נלקח בחשבון. הפלט של משימה שהסתיימה כולל את videoUrl, thumbnailUrl, width, height ו-durationSec. חזית ארוכה מ-300 שניות נדחית עם שגיאת 400 עוד לפני כל חיוב.

• SDK: maskComposite({ foregroundUrl, backgroundUrl, maskUrl, invertMask, feather, grow, opacity, fill, pixelSizePct, blurStrengthPct, backgroundFit, audioSource }). ראו את הדף מדיה והעלאות.
• MCP: הכלי mask_composite מקבל כל אחד משלושת הסרטונים כ-<name>_url או כ-<name>_asset_id (foreground, background, mask), כך שמזהה משימה של video_mask יכול לשמש כ-mask_asset_id. ההגדרות הן invert_mask, feather, grow, opacity, fill, pixel_size_pct, blur_strength_pct, background_fit ו-audio_source. ראו את מדריך כלי ה-MCP.
• CLI: nodaro media mask-composite <foregroundUrl> <backgroundUrl> <maskUrl> [--invert] [--feather <px>] [--grow <px>] [--background-fit cover|contain|stretch] [--audio foreground|background|mix|none]. לפיקסול או לטשטוש: nodaro media mask-composite <backgroundUrl> <maskUrl> --fill pixelate|blur [--pixel-size-pct <pct>] [--blur-strength-pct <pct>]. ראו את הדף פקודות מדיה וקול.

ראו את דפי ה-API הרצת רכיב יחיד ומשימות.