סרטון קומפלט · בסיסיוידאועד 125 קרדיטים לדקה

B-roll מסטוק במקום וידאו AI

3 שוטים מסטוק ברגעים שהמילים מתארות משהו שמצלמה יכולה להראות · מסך מלא או מסך מפוצל שהפנים נשארות בו · צילומים אמיתיים מ-Pexels (ומאגרי CC0), רישיון לכל שוט · כל מילה על המסך ברגע שהיא נאמרת

תיעוד

העריכה הקינטית בסגנון CapCut של דובר מול מצלמה, עם B-roll אמיתי במקום קליפים מג׳ונרטים: Gemini Flash-Lite קורא את המילים ובוחר את הרגעים שתמונה עוזרת בהם, הסטוק נבחר, מדורג מול הפריים ונבדק על ידי אותו מודל זול לפי תמונות ממוזערות, ושלושה שוטים נכנסים — שוט אנכי במסך מלא, שוט רוחבי בחצי התחתון כשהפנים נשארות למעלה. כל מילה על המסך, הוק, זומים, סטיקרים, עיצוב סאונד וביט מתחת לקול, ברינדור אחד. הצילומים לא עולים כלום: שלושה קרדיטים לכל התוכנית, כששלושה קליפים של Veo היו עולים 360. תמונות וסרטונים באדיבות Pexels.

curl -X POST https://apihub.co.il/v1/skills/apihub-stock-broll/run \
  -H "Authorization: Bearer $APIHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"media_url": "https://example.com/my-video.mp4", "max_credits": 120}'

המפתח נקרא ממשתנה הסביבה APIHUB_API_KEY — אף פעם לא מדביקים מפתח אמיתי בקוד.

הקריאה

POST/v1/skills/apihub-stock-broll/run

פותחת ריצה של הסוכן עם העריכה הזאת. התשובה חוזרת מיד (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-stock-broll/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"

כל ה-API בתיעוד ←המתכון המלא של העריכה (Markdown) ←