עברית טבעית ושיבוט קול
הקול שלכם משובט פעם אחת, מ-1–3 דקות שלכם מדברים · תסריט שכתוב לאוזן, לא לדף · במאי קול בתוך כל טייק: תגית ביצוע לכל שורה, ה-stability הנכון, ומילים שקול נוטה לטעות בהן נשלחות בכתיב שעבד · שלושה טייקים, ו-Gemini מקשיב לכולם לפני שאחד נבחר
הקול שלכם, בעברית שנשמעת כמו בן אדם ולא כמו מכונה שקוראת מדף — ממה שהרילים של הבעלים עצמו עשויים, לכולם. הקול משובט פעם אחת מכמה דקות שלכם מדברים; התסריט נכתב לאוזן; ובתוך כל טייק במאי קול (Gemini) מוסיף את מה שקול עברי צריך ואף אחד לא יודע להוסיף: תגית ביצוע באנגלית איפה שהביצוע משתנה — חברי בהצעה, שקט בסיפור, צעקה אמיתית בשיא — וה-stability שמתאים, ומילים שקול נוטה לטעות בהן נשלחות בכתיב שעבד. בלי ניקוד, והמילים לא משתנות. נעשים שלושה טייקים, Gemini 3.1 Pro מקשיב לכולם ומסמן כל מילה שנקראה לא נכון, והטייק הנקי הכי טוב הופך לריל בלי פנים: סטוק, כל מילה על המסך ברגע שהיא נאמרת, סאונד ומוזיקה מתחת לקול. או רק הקריינות, לסרטון שלכם.
curl -X POST https://dev.apihub.tools/v1/skills/apihub-natural-voice/run \
-H "Authorization: Bearer $APIHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"media_url": "https://example.com/my-video.mp4", "max_credits": 110}'הקריאה
פותחת ריצה של הסוכן עם העריכה הזאת. התשובה חוזרת מיד (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://dev.apihub.tools/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://dev.apihub.tools/v1/skills/apihub-natural-voice/run \
-H "Authorization: Bearer $APIHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"media_url": "https://example.com/my-video.mp4", "max_credits": 110}'
# follow the run (its id is in the answer) until status is done / failed / cancelled
curl https://dev.apihub.tools/v1/agent/runs/RUN_ID \
-H "Authorization: Bearer $APIHUB_API_KEY"