דיבוב סרטון — מקישור יוטיוב או מקובץ
קישור יוטיוב או קובץ — הרישיון נשמר עם העבודה · כל הסרטון או קטע ממנו, בפריים שלו · הדיבוב ש-Gemini כותב כשהוא צופה בדובר · קול מוכן בשפה החדשה, הטוב מבין 3 טייקים
אותו סרטון בשפה אחרת: מביאים קישור יוטיוב — מהערוץ שלכם, סרטון Creative Commons או סרטון שיש לכם אישור עליו; הרישיון שהצהרתם נשמר עם העבודה — או מעלים קובץ. הדיבור מתומלל, Gemini צופה בדובר וכותב את הדיבוב כמו שדובר השפה היה אומר אותו, קול מוכן של ElevenLabs מקריא אותו (הטוב מבין שלושה טייקים לכל משפט), וכל חלק נחתך ומותאם לביטוי של הדובר — הקול החדש מתחיל ונעצר עם הפה שלו. כתוביות הדיבוב, רינדור אחד, ואם רוצים — פרסום בערוץ היוטיוב שלכם דרך החשבונות המחוברים. קריין, לא שכפול קול.
curl -X POST https://apihub.co.il/v1/skills/apihub-dub-video/run \
-H "Authorization: Bearer $APIHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"media_url": "https://example.com/my-video.mp4", "max_credits": 160}'הקריאה
פותחת ריצה של הסוכן עם העריכה הזאת. התשובה חוזרת מיד (201) והסרטון נבנה ברקע.
גוף הבקשה
| שדה | סוג | חובה | מה זה |
|---|---|---|---|
| media_url | string (url) | כן | הסרטון: קישור ציבורי, או קובץ שהועלה (POST /v1/agent/uploads) |
| max_credits | integer | לא | התקרה: תוכנית עד הסכום הזה מאושרת לבד. בלי תקרה הריצה מחכה ב-awaiting_approval |
| message | string | לא | מה אתם רוצים, במילים שלכם — העריכה יודעת את העבודה גם בלי |
| locale | "he" | "en" | "uk" | לא | השפה שבה הסוכן עונה: he, en או uk |
| media_name | string | לא | שם הקובץ להצגה |
| profile_id | string | לא | הסוכן שלכם (GET /v1/agent/profiles): הרשתות והפרסום שלו נשארים |
| client_key | string (8–100) | לא | מפתח משלכם: אותו מפתח פעמיים מחזיר 409 במקום ריצה שנייה בתשלום |
התשובה ומעקב
התשובה היא הריצה (AgentRunView): id, status, plan ו-skill. עוקבים אחריה ב-GET /v1/agent/runs/RUN_ID כל 10 שניות עד שה-status הוא done, failed או cancelled. הסרטון המוכן נמצא ב-attachments[].url של ההודעה האחרונה, ו-cost מפרט מה זה עלה.
אישור מעל התקרה
תוכנית שעולה יותר מ-max_credits נעצרת ב-status awaiting_approval, לפני שמשהו מחויב. מאשרים אותה כך:
curl -X POST https://apihub.co.il/v1/agent/runs/RUN_ID/actions \
-H "Authorization: Bearer $APIHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"action": "approve"}'קודי שגיאה
- 400
- שדה לא תקין — השגיאה אומרת איזה
- 401
- המפתח שגוי
- 402
- אין מספיק קרדיטים
- 404
- skill_not_found — אין עריכה כזאת
- 409
- skill_not_available, או duplicate_client_key
- 422
- skill_input_length — הסרטון קצר או ארוך מדי לעריכה
- 429
- יותר מדי בקשות — מחכים ומנסים שוב
דוגמת קוד מלאה
curl -X POST https://apihub.co.il/v1/skills/apihub-dub-video/run \
-H "Authorization: Bearer $APIHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"media_url": "https://example.com/my-video.mp4", "max_credits": 160}'
# follow the run (its id is in the answer) until status is done / failed / cancelled
curl https://apihub.co.il/v1/agent/runs/RUN_ID \
-H "Authorization: Bearer $APIHUB_API_KEY"