קליפ UGC

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

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

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

בסרטון בעברית, כל רינדור נבדק גם מול הדיבור המוקלט של הקליפ. רינדור בלי סאונד נכשל בבדיקה הזו, והקליפ מרונדר פעם נוספת. אם אין סאונד באף רינדור, הקליפ נעצר עם ההודעה "Clip N has no sound, so the video cannot be finished. Re-render that clip from its UGC Clip node." (לקליפ N אין סאונד, ולכן אי אפשר לסיים את הסרטון. רנדרו מחדש את הקליפ הזה מרכיב קליפ UGC שלו).

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

רכיב קליפ UGC רץ רק ב-Nodaro Cloud. בכל התקנה אחרת, כל רכיב UGC נכשל לפני שמשהו משוריין, עם ההודעה ״סרטוני UGC הם תכונה של Nodaro Cloud, ולכן הם לא זמינים בהתקנה הזו.״

מתי להשתמש

• קיבלתם קליפים מרכיב קליפי UGC, ואתם רוצים לרנדר אותם.
• אתם רוצים טייק חדש של קליפ אחד, בלי לרנדר שוב את האחרים.

התחלה מהירה

קלטים

פלטים

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

אותו פלט מזין גם את הקלט הערות הקליפים של רכיב כרטיסי UGC, שקורא את האזהרות ואת האורך בפועל של כל קליפ.

הגדרות

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

רינדור מחדש של קליפ

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

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

הכול או כלום

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

הרצה בשרת יכולה להיות הרצת תהליך, הרצת אפליקציה או הרצה דרך ה-API. בהרצה כזו, המצב של הרכיב שנכשל מציין מה הוא סיים. השדה iterationTotal הוא מספר הקליפים שלו, והשדה iterationCompleted הוא מספר הקליפים שהסתיימו. השדה jobIds מפרט את המשימות של הקליפים שהסתיימו, והשדה jobRows את הקליפ שכל אחת מהמשימות האלה יצרה, בספירה שמתחילה מ-0. היסטוריית ההרצה מפרטת כל קליפ שהסתיים תחת הרכיב שנכשל. ועדיין, הרכיב לא מעביר שום דבר הלאה.

קרדיטים

על כל קליפ משלמים:

• את המחיר של מודל הווידאו לפי אורך הקליפ;
• על הקול, כשיש בקליפ דיבור;
• על ניתוח פריימים אחד לכל רינדור. הניתוח הוא קריאה לרכיב תיאור תמונה, שמחויבת לפי הטוקנים שבהם השתמשה, בתעריף של המודל שלה.

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

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

במחיר המוצג של אפליקציה או תבנית

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

מחירים בעורך

לפני הרצה שכוללת רכיב UGC, העורך מתמחר את חלק ה-UGC של ההרצה לפי הסכום שהשרת עצמו מחשב. הסכום מכסה בדיוק את הרכיבים שההרצה מריצה, כולל כל אחת מאפשרויות היוצר/ת. המחיר שהעורך מציג הוא מה שההרצה צפויה לעלות.

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

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

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

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

הרצה שהקליפים שלה כבר נוצרו

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

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

למשל, אחרי הרצה של שלושה קליפים שבה קליפ 2 נכשל, המחיר הוא של קליפ 2 בלבד. אם תלחצו גם על רינדור מחדש בקליפ 3, המחיר יהיה של קליפים 2 ו-3.

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

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

טיפים

• צפו בכל קליפ לפני שאתם מאחדים את הקליפים. לחצו על רינדור מחדש בקליפים שלא אהבתם, ואז הריצו שוב. רק הקליפים האלה מרונדרים מחדש.
• קראו את ההערות של רכיב כרטיסי UGC. הערה כמו "Clip 2 may not say its line exactly" (ייתכן שקליפ 2 לא אומר את השורה שלו במדויק) מצביעה על הקליפ שצריך לרנדר מחדש.
• פתחו שוב את העורך אחרי הרצה ארוכה. כשהרצה מסתיימת בזמן שהעורך שלה סגור, פתיחה מחדש של העורך מציגה את התוצאות של אותה הרצה ברכיבי ה-UGC, וברכיבי האיחוד, השכבה והכתוביות של הסרטון עצמו. ההרצה החדשה יותר גוברת. רכיב קליפ UGC ושלושת הרכיבים האלה מציגים קודם את הסרטון החדש יותר, ושומרים את הישנים יותר מתחתיו.
• פרסום לא כולל טייקים. תבנית שמתפרסמת עם האפשרות הכללת תוצאות ההרצה הזו מציגה את הטייק הנוכחי של כל קליפ כדוגמה.

פתרון בעיות

דרך ה-API

רכיב קליפ UGC קורא ל-POST /v1/ugc/clip כשהוא רץ, והנתיב מחזיר מזהה משימה. מבנה הבקשות והתשובות של נתיבי ה-UGC שייך לרכיבים, והוא יכול להשתנות בין גרסאות. כדי ליצור סרטון UGC דרך קוד, הריצו תהליך או אפליקציה שפורסמה שכוללים את רכיבי ה-UGC. ראו בדף ה-API של התהליכים.

הרצה של סרטון UGC באפליקציה שפורסמה נבדקת לפני שהיא מתחילה. כשהמשלם לא יכול לכסות את מה שעשוי להיות משוריין לסרטון בזמן הרינדור של הקליפים שלו, ההרצה נדחית עם 402 insufficient_credits, לפני שמשהו רץ ולפני כל חיוב. ההודעה היא "This video can hold up to about … credits while it renders; your balance is …." (הסרטון הזה יכול לשריין עד בערך … קרדיטים בזמן הרינדור; היתרה שלכם היא …). ראו את הסעיף הטמעת מיני־אפליקציה או הרצה שלה מקוד בדף אפליקציות, ואת דף ה-API קרדיטים.