סרטון קומפלט · AI חסכוניוידאועד 380 קרדיטים לדקה

מודעת מכירה

הוק מונה · כתוביות · תמונות מוצר AI · אייקונים על נקודות ההוכחה

סרטון מכירה: הוק מונה, כתוביות פופ, תמונות מוצר ב-Nano Banana Pro, אייקונים על נקודות ההוכחה, כרטיס סיום קינטי עם המחיר (או המוצר, כשאין מחיר — אף פעם לא מחיר מומצא), מוזיקה וקריאה לפעולה בסוף.

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

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

הקריאה

POST/v1/skills/apihub-sales/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-sales/run \
  -H "Authorization: Bearer $APIHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"media_url": "https://example.com/my-video.mp4", "max_credits": 370}'

# 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) ←