גילוי נאות: API Hub, השירות שהמדריך הזה מתאר, הוא של ויבקודינג, החברה שמפעילה גם את WEBA.
פיצ׳ר וידאו באתר נשמע כמו כפתור אחד: המשתמש מעלה סרטון ומקבל אותו בחזרה עם כתוביות. מאחורי הכפתור יש שרת עיבוד, גופנים לעברית, ספק תמלול, לפעמים ספק וידאו גנרטיבי וספק קול, והרשאות נפרדות לכל רשת חברתית שרוצים לפרסם אליה. במדריך הזה נפרק את החלקים, ונראה איך מחליפים אותם בקריאות ל־API לעריכת וידאו ותמלול.
חמישה ספקים, חמישה מפתחות
רינדור של וידאו צריך שרת עם מעבד פנוי ותור עבודות, כי סרטון של דקה לא נגמר בזמן של בקשת HTTP רגילה. תמלול צריך ספק שמבין עברית. קליפ שנוצר מאפס צריך חשבון אצל ספק וידאו גנרטיבי, וקריינות צריכה ספק קול. כל אחד מהם מגיע עם מפתח, חשבונית ומצב כשל משלו.
כתוביות בעברית הן המקום שבו הרבה פרויקטים נתקעים. שורה מימין לשמאל שיש בתוכה מספר או מילה באנגלית יוצאת הפוכה אם מנוע הרינדור לא מטפל נכון בכיוון הטקסט, והגופן צריך לתמוך בעברית. ופרסום לרשתות הוא פרויקט נפרד: לכל רשת יש אפליקציה, הרשאות ותהליך אישור משלה.
זה נראה כמו שבוע עבודה. זה בדרך כלל חודש.
ממשק אחד במקום
ב־API Hub כל הפעולות האלה יושבות מאחורי כתובת אחת ומפתח אחד, עם תיעוד OpenAPI לכל כלי. לפי התיעוד, עריכה היא POST לנתיב studio/edit, פרסום לרשתות הוא POST לנתיב social/publish, והרצה שלמה של סוכן היא POST לנתיב agent/runs. הכתוביות נצרבות בעברית מימין לשמאל, ב־24 סגנונות, והתמלול עובד ב־99 שפות עם זיהוי דוברים.
שלושה פרטים שחוסכים כאב ראש בפרודקשן: בכל נתיב יש קריאת estimate שמחזירה את המחיר לפני שמריצים, כל POST מקבל Idempotency-Key כדי שבקשה שנשלחה פעמיים לא תחויב פעמיים, ורינדור שנכשל לא מחויב בכלל. את התוצאה מחכים לקבל בכותרת x-wait-ms, או בודקים את מצב ההרצה לפי המזהה שלה.
| חלק | לבד | דרך API Hub |
|---|---|---|
| עיבוד וידאו | שרת, תור עבודות וניטור | studio/edit |
| כתוביות בעברית | גופן, כיוון טקסט ועיצוב | 24 סגנונות מוכנים |
| תמלול | ספק נפרד וחשבון נפרד | 99 שפות, עם זיהוי דוברים |
| קליפים וקול | חשבון אצל ספק וידאו וספק קול | Veo, Seedance ו־ElevenLabs באותו חשבון |
| פרסום לרשתות | אפליקציה והרשאות לכל רשת | 8 רשתות בקריאה אחת |
איך מחברים את זה לאתר
חיבור בצד השרת
- יוצרים מפתח בחשבון ושומרים אותו במשתנה סביבה בשרת.
- כשמשתמש מעלה סרטון, השרת קורא קודם ל־estimate ומציג לו כמה הפעולה תעלה.
- אחרי אישור, השרת שולח את הבקשה עם Idempotency-Key ייחודי.
- השרת מחכה לתוצאה או בודק את מצב ההרצה, ומחזיר למשתמש קישור לקובץ המוכן.
אם זו הפעם הראשונה שאתם מחברים API לאתר, כדאי לקרוא קודם את המדריך לחיבור API לאתר. את שמות השדות המדויקים וקודי השגיאה תמצאו בתיעוד המלא.
מתי לבנות לבד
יש מקרים שבהם צנרת משלכם שווה את החודש. אם הסרטונים לא יכולים לצאת מהשרתים שלכם מסיבות רגולטוריות, אם אתם צריכים אפקטים שאף שירות לא נותן, או אם הנפח כל כך גבוה שתשתית משלכם זולה יותר. לרוב האתרים, צנרת וידאו פרטית היא פרויקט של חודשים בשביל פיצ׳ר שמשתמשים בו פעם בשבוע, ושם הייתי מתחיל מקריאה.
ועוד דבר אחד לפני שעולים לאוויר: אם המשתמשים שלכם מעלים סרטונים, הם עוברים לעיבוד אצל ספק חיצוני. את זה צריך לכתוב במדיניות הפרטיות של האתר, ובמפורש.
המשתמש יראה כפתור אחד. ככה זה צריך להיות.
מקורות
- apihub.co.ilhttps://apihub.co.il/
- apihub.co.il/docshttps://apihub.co.il/docs
המדריך נכתב מהמקורות שלמעלה בתאריך הפרסום. מחירים ותנאים משתנים; לפני החלטה כספית בודקים מול המקור. מצאתם טעות? כתבו.