קליפי UGC

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

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

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

מתי להשתמש

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

התחלה מהירה

קלטים

פלטים

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

הגדרות

בדיקה חוזרת של התסריט

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

האורך המרבי של קליפ

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

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

תסריט בעברית

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

ההקלטה יכולה להימשך לכל היותר פי 1.2 מאורך הסרטון, ואף פעם לא יותר מ-21 שניות. הקלטה ארוכה יותר עוצרת את ההרצה בשלב הפיצול, עם ההודעה "SPEECH_TOO_LONG … Shorten the script." (… קצרו את התסריט). הקרדיטים על הפיצול מוחזרים. החיוב על הדיבור ועל תזמון המילים שלו נשאר. רכיב תסריט UGC כבר כותב מחדש תסריט בעברית שארוך מדי לאורך הסרטון, לפי קצב של 2.5 מילים לשנייה: 45 מילים לסרטון של 15 שניות, ו-52 מילים לכל היותר.

הקולות בעברית הם Maya ו-Shira (קולות של אישה), ו-Itai ו-Omer (קולות של גבר).

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

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

כמה יעלו הקליפים

כשמריצים את רכיב קליפי UGC עם כפתור ההרצה שלו, הרכיב מציג כמה יעלו הקליפים שלו:

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

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

קרדיטים

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

טיפים

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

פתרון בעיות

דרך ה-API

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

הנתיב POST /v1/ugc/quote מתמחר סרטון UGC. הקריאה חינמית, שום דבר לא משוריין, והנתיב מקבל עד 30 קריאות לדקה. יש לו שתי צורות:

• צורת tickets: בקשה עם { "tickets": [ … ], "hasCards": true } מתמחרת את הקליפים, בין 1 ל-11, שרכיב קליפי UGC העביר הלאה, כמו שיתומחרו ברכיב קליפ UGC ובשלבים שאחריו. זה הסכום שרכיב קליפי UGC מציג.
• צורת estimate: בקשה עם { "estimate": { "targetDurationSec": 15, "screenshotCount": 3, "source": "sampled" } } מתמחרת סרטון שלם לפני שמשהו רץ, כולל התסריט והיוצר/ת. הערך של targetDurationSec הוא בין 4 ל-300. הערך של screenshotCount הוא בין 0 ל-8, והערכים 1 או 2 מתומחרים כאילו אין צילומי מסך. הערך של source הוא sampled (יוצר/ת AI) או photo. השדה האופציונלי rendersEveryCandidate מתמחר את כל אפשרויות היוצר/ת, כמו שהרצה בעורך מרנדרת אותן.

צורת tickets מקבלת שני שדות אופציונליים:

• הערך finishes: true מציין שהקליפים עוברים את משימת הגימור של UGC, כמו בסרטון בעברית. בתשובה יש אז שורה "Finish the clips" (גימור הקליפים, מפתח finish), שמשלמים עליה פעם אחת. שורת האיחוד (מפתח join) מתומחרת כמו שמשלמים על רכיב האיחוד של התבנית: לפי ההגדרות שלו, וכל קליפ לפי האורך הסטנדרטי של 8 שניות ברכיב שילוב סרטונים, כי הקליפים מגיעים אליו כרשימה אחת בלי אורכי קליפים.
• השדה runEstimate הוא קלט האומדן של הסרטון שהקליפים שייכים לו (targetDurationSec, screenshotCount, source ו-language). בתשובה יש אז גם runHold: הסכום המרבי שמשוריין לפי האומדן של הסרטון לקליפים שלו ולשלבים שאחריהם, בתמחור עם אותם hasCards ו-finishes.

שתי הצורות מחזירות lines (לכל שורה יש label באנגלית, credits ו-key קבוע), expected, ceiling (מה שמשוריין לסרטון בזמן הרינדור של הקליפים שלו), parts ו-holdParts. צורת estimate מחזירה גם range, המחיר הצפוי באורך של פי 0.8 ושל פי 1.2 מאורך היעד, ו-worstCase. פריט שאי אפשר לתמחר נדחה עם 422 unpriceable. במקום שבו נתיבי ה-UGC לא זמינים, הנתיב מחזיר 503 not_available.

בסרטון בעברית (language: "he" באומדן), הדיבור המוקלט קובע כמה קליפים יהיו, ולכן באומדן אין חישובים של פי 0.8 ופי 1.2. הערכים expected ו-ceiling מחושבים לפי מספר הקליפים שהדיבור צפוי לדרוש, ו-range מגיע עד המספר הגדול ביותר של קליפים שדיבור כזה דורש בדרך כלל. ב-worstCase נמצאת הדרך היקרה ביותר לחתוך הקלטה מקובלת כלשהי, כשכל קליפ מחושב פי 2 מהמחיר שלו. הקלטה יכולה להימשך לכל היותר פי 1.2 מאורך היעד, ואף פעם לא יותר מ-21 שניות: 18 שניות לסרטון של 15 שניות, ו-21 שניות מסרטון של 17.5 שניות ומעלה. לכן התרחיש הגרוע ביותר גדל עם אורך היעד, עד 6 קליפים של עד 7 שניות. הדיבור, תזמון המילים שלו, הפיצול שלו והגימור הם שורות נפרדות, ועל כל אחת מהן משלמים פעם אחת.

לפני הרינדור של הקליפים של סרטון בעברית, רכיב קליפי UGC שולח בקשה בצורת tickets, עם runEstimate, כדי לתמחר את הקליפים שהפיצול העביר הלאה. זה קורה באותו אופן בעורך, באפליקציה שפורסמה ובהרצה דרך ה-API. כשה-ceiling שלהם גבוה מ-runHold, או כשאי אפשר לקבל סכום, ההרצה נעצרת ברכיב קליפי UGC לפני שקליפ כלשהו מרונדר.