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