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