מיוטיוב לריל
חיפוש ביוטיוב או קישור — הרישיון שלכם קובע את הדרך · Gemini צופה בסרטון ובוחר את הריל · השניות הכי חזקות, בלי לחתוך באמצע מילה · שוטים מהסרטון עצמו משולבים כקאט-אוויי
סרטון מיוטיוב הופך לריל אנכי, לפי הזכויות שלכם: מחפשים ביוטיוב (רק Creative Commons כשהסרטון לא שלכם) או מביאים קישור, ו-Gemini צופה בו במקום ומתכנן את הריל — השניות הכי חזקות, הוק, כותרת וטקסט לפוסט. עם רישיון (הערוץ שלכם, סרטון Creative Commons או אישור בכתב) הקובץ נלקח והרישיון נשמר עם העבודה; הריל נחתך על גבולות משפטים, שוטים חזקים מהסרטון עצמו נכנסים מעל הדיבור כקאט-אוויי, כתוביות והוק נצרבים וקרדיט CC BY נשאר על המסך — רינדור אחד, 9:16. בלי רישיון לא נוגעים בקובץ של הסרטון: יוצא ריל תגובה על צילום שלכם (התסריט נכתב בשבילכם), עם קטעי סטוק CC0 וציטוטים קצרים מהסרטון על המילים שלכם.
curl -X POST https://apihub.co.il/v1/skills/apihub-youtube-reel/run \
-H "Authorization: Bearer $APIHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"media_url": "https://example.com/my-video.mp4", "max_credits": 120}'הקריאה
פותחת ריצה של הסוכן עם העריכה הזאת. התשובה חוזרת מיד (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-youtube-reel/run \
-H "Authorization: Bearer $APIHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"media_url": "https://example.com/my-video.mp4", "max_credits": 120}'
# 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"