# כרטיסי UGC

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

Source: https://nodaro.ai/he/docs/nodes/video/ugc-cards

רכיב **כרטיסי UGC** מתזמן את כרטיסי צילומי המסך ואת הכתוביות של סרטון UGC לפי הדיבור של היוצר/ת. הרכיב עובד על הסרטון המאוחד: הקליפים של רכיב [קליפ UGC](https://nodaro.ai/docs/nodes/video/ugc-clip), אחרי שרכיב [שילוב סרטונים](https://nodaro.ai/docs/nodes/video/combine-videos) איחד אותם. הוא גם בודק שכל קליפ אמר את השורה שלו, וכותב את הפלט **הערות**.

- Found in: Video › UGC Video
- API type: `ugc-cards`

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

- **כרטיסי צילומי המסך.** כל צילום מסך קופץ בזמן שהיוצר/ת מדבר עליו. הכרטיסים יוצאים מהרכיב כתוכנית שכבות לרכיב [שכבה על וידאו](https://nodaro.ai/docs/nodes/video/video-overlay#layer-plan-input).
- **הכתוביות.** בתוכנית נמצאים שורת הפתיחה, הזמן שבו היא מסתיימת והמילים המתוזמנות של שאר הסרטון. הכתוביות יוצאות מהרכיב כתוכנית כתוביות לרכיב [הוספת כתוביות](https://nodaro.ai/docs/nodes/video/add-captions#caption-plan-input). רכיב הוספת כתוביות מציג את שורת הפתיחה במראה של לוחית פתיחה, ואת השאר בסגנון הכתוביות שלו.

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

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

## התחלה מהירה
### הוספת הרכיב
הקישו Tab על הקנבס ובחרו **וידאו › וידאו UGC › כרטיסי UGC**.

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

### חיבור התוכניות
חברו את הפלט **תוכנית שכבות** לקלט **תוכנית שכבות** של רכיב שכבה על וידאו. חברו את הפלט **תוכנית כתוביות** לקלט **תוכנית כתוביות** של רכיב הוספת כתוביות.

### הרצה וקריאת ההערות
הריצו את התהליך. קראו את ההערות ברכיב או בחלונית ההגדרות שלו.

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

- קליפי UGC → כרטיסי UGC (תסריט (מותאם לאורך))
- קליפ UGC → שילוב סרטונים (חבילה)
- קליפ UGC → כרטיסי UGC (הערות הקליפים)
- שילוב סרטונים → כרטיסי UGC (וידאו)
- כרטיסי UGC → שכבה על וידאו (תוכנית שכבות)
- שכבה על וידאו → הוספת כתוביות (וידאו)

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

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

## הגדרות
לרכיב כרטיסי UGC אין הגדרות. חלונית ההגדרות מציגה את ההערות של ההרצה האחרונה.

### איך המילים מתוזמנות
תזמון המילים מגיע מיישור של מילות הקליפים מול הסרטון המאוחד.

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

ההערות מציינות איזה מהמקרים האלה קרה.

### ההערות
המשפט "No issues." (אין בעיות) מופיע רק כששום דבר לא השתבש וכל הבדיקות רצו: הבדיקות של כל קליפ ובדיקת הדיבור. בדיקה שלא רצה תמיד מקבלת משפט משלה.

| מתי | משפט |
| --- | --- |
| אין צילומי מסך, או שיש רק 1 או 2, והתסריט משמיט אותם | "No screenshot cards: the video is the creator talking. Add 3 to 8 screenshots for cards." (אין כרטיסי צילומי מסך: הסרטון מציג את היוצר/ת מדבר. הוסיפו בין 3 ל-8 צילומי מסך כדי לקבל כרטיסים) |
| יישור המילים נכשל או לא מצא מילים | "Captions and cards were timed from speech recognition." (הכתוביות והכרטיסים תוזמנו לפי זיהוי דיבור) |
| התמלול נכשל או לא שמע מילים | "The speech check did not run: the speech could not be transcribed." (בדיקת הדיבור לא רצה: אי אפשר היה לתמלל את הדיבור) |
| אי אפשר היה להבחין בין הקליפים של הסרטון, ולכן אי אפשר היה לבדוק את המילים של אף קליפ | "The speech check did not run: the video's clips could not be told apart." (בדיקת הדיבור לא רצה: אי אפשר היה להבחין בין הקליפים של הסרטון) |
| אי אפשר היה לתזמן שום דבר | "No cards or captions: the speech could not be timed." (אין כרטיסים או כתוביות: אי אפשר היה לתזמן את הדיבור) |
| כרטיס היה מסתיר את שורת הסיום | "Card *n* was left out: it would have covered the closing line." (כרטיס *n* הושמט: הוא היה מסתיר את שורת הסיום) |
| קליפ נכשל בבדיקה שלו פעמיים | "Clip *n* still showed a problem after one re-render (*what the check found*). Re-render it from the UGC Clip node." (בקליפ *n* עדיין נמצאה בעיה אחרי רינדור מחדש אחד (*מה שהבדיקה מצאה*). רנדרו אותו מחדש מרכיב קליפ UGC) |
| קליפ נכשל בבדיקה שלו, ולא נשאר מקום לרנדר אותו מחדש | "Clip *n* showed a problem (*what the check found*) and there was no room left to re-render it. Re-render it from the UGC Clip node." (בקליפ *n* נמצאה בעיה (*מה שהבדיקה מצאה*), ולא נשאר מקום לרנדר אותו מחדש. רנדרו אותו מחדש מרכיב קליפ UGC) |
| הרינדור מחדש של קליפ נכשל | "Clip *n*'s re-render failed, so the first render is kept." (הרינדור מחדש של קליפ *n* נכשל, ולכן הרינדור הראשון נשמר) |
| הבדיקה האוטומטית של קליפ לא יכלה לרוץ, ולכן הקליפ נשמר בלי בדיקה | "Clip *n* was kept without its automatic check: the check could not run this time. Watch it, and re-render it from the UGC Clip node if something looks wrong." (קליפ *n* נשמר בלי הבדיקה האוטומטית שלו: הפעם הבדיקה לא יכלה לרוץ. צפו בו, ורנדרו אותו מחדש מרכיב קליפ UGC אם משהו נראה לא תקין) |
| הדיבור בקליפ לא תאם את השורה שלו | "Clip *n* may not say its line exactly: heard "*what was heard*"." (ייתכן שקליפ *n* לא אומר את השורה שלו במדויק: נשמע ״*מה שנשמע*״) |
| קליפ הוארך כדי להכיל את הקול שלו | "Clip *n* was lengthened to fit its voice." (קליפ *n* הוארך כדי להכיל את הקול שלו) |
| שום דבר לא השתבש וכל הבדיקות רצו | "No issues." (אין בעיות) |

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

- משימת יישור מילים אחת, במחיר של רכיב [יישור מאולץ](https://nodaro.ai/docs/nodes/audio/forced-alignment): 33 קרדיטים;
- משימת תמלול אחת, שמחויבת לפי המחיר שלה.

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

העורך מציג את המחיר של ההרצה כולה לפני שהיא מתחילה. ראו את הסעיף [מחירים בעורך](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-editor) בדף קליפ UGC.

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

## פתרון בעיות
| הודעה או בעיה | סיבה ופתרון |
| --- | --- |
| ״חברו את הפלט **תסריט (מותאם לאורך)** של **קליפי UGC**.״ | הקלט **תסריט** ריק, או שמחובר אליו פלט של רכיב אחר, כגון רכיב תסריט UGC. חברו את הפלט **תסריט (מותאם לאורך)** של רכיב קליפי UGC. |
| ״חברו את הסרטון המאוחד.״ | חברו לקלט **וידאו** את הסרטון המאוחד מרכיב שילוב סרטונים. |
| ״חברו את הפלט **תמלול** של **קליפי UGC**.״ | חברו את הפלט **תמלול** של רכיב קליפי UGC לקלט **תמלול**. |
| אין כרטיסים בסרטון. | לרכיב תסריט UGC מחוברים פחות מ-3 צילומי מסך. הוסיפו בין 3 ל-8 צילומי מסך. |
| אין בסרטון כרטיסים וגם לא כתוביות. | אי אפשר היה לתזמן את הדיבור, וההערות מציינות זאת. בדקו שיש בסרטון המאוחד את הדיבור של היוצר/ת. |
| ההערות לא אומרות דבר על הקליפים. | חברו את הפלט **וידאו** של רכיב קליפ UGC לקלט **הערות הקליפים**. |

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

בתוצאה של הרצה דרך ה-API, ההערות הן ה-`text` של רכיב כרטיסי UGC. ראו בדף [ה-API של התהליכים](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values) ובדף [ה-API של ההרצות](https://nodaro.ai/docs/developers/api/executions).

עוזרי AI שמחוברים דרך MCP משתמשים בכלי UGC נפרדים, כגון `build_ugc_cards`. המתכון ugc-website, שנטען עם `get_recipe`, מסביר אותם. ראו את הדף [מתכוני תוכן](https://nodaro.ai/docs/mcp/recipes).

## שאלות נפוצות

### מה עושה רכיב כרטיסי UGC?

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

### כמה קרדיטים עולה רכיב כרטיסי UGC?

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

### מה הן ההערות של רכיב כרטיסי UGC?

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

### למה אין כרטיסי צילומי מסך בסרטון ה-UGC שלי?

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

### מה קורה אם אי אפשר לתזמן את הדיבור?

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