למפתחים ולעסקים מסוג SaaS
הוסף וידאו AI למוצר שלך בכמה קריאות
ממשק API של REST, שרת MCP ווובהוקים: המוצר שלך יוצר סרטוני הסברה ומפרק סרטונים ארוכים לשורטס, בלי שהמשתמשים שלך יפתחו את ClipOnIt.
החל מהתוכנית החינמית (3 סרטונים בחודש עם סימן מים) · המפתח נוצר ב-הגדרות ← אינטגרציות
שתי דרכים להשתמש בזה
שני המוצרים של ClipOnIt, נקראים מהקוד שלך או על ידי סוכן.
AI Explainer
כלי הכשרה: סרטון הסבר אחד לכל שיעור
המוצר שלך שולח את כותרת השיעור או הטקסט; ClipOnIt כותב את הסצנות, מאייר אותן, מוסיף קריינות וכתוביות, ומפיק קובץ MP4 אנכי שתציג לצד הקורס.
POST /api/agent/produceMCP
סוכן AI שמפעיל את ClipOnIt
הסוכן שלך (Claude, Cursor, VS Code או שלך) מתחבר לשרת MCP: הוא מייבא וידאו, בוחר קליפים, מפעיל סרטון הסבר ומחכה לתוצאה בעזרת כלים שכבר מתוארים.
POST /mcp
תמיד אותו זרם
וידאו לוקח דקות, לא אלפיות שנייה: יוצרים משימה, עוקבים אחרי מצבה ומורידים את הקובץ.
- יצירת המשימה
POST עם הנושא או הקישור של הסרטון. תשובה מיידית עם מזהה.
- מעקב אחר המצב
קריאת GET כל 10 שניות בערך: שלב, אחוזים, זמן שנותר. עבור ה-Explainer, webhook יכול לשלוח לך הודעה במקום.
- הורדת הוידאו
לאחר הסיום, כתובת ה-MP4 נמצאת בתגובה. הורד אותו או הצג אותו במוצר שלך.
AI Explainer
סרטון הסברה מנושא
POST /api/agent/produce מקבל נושא (או תסריט, או הקלטה קולית) ומתחיל בכתיבה ואז ברינדור. GET /api/jobs/{id} מחזיר status, step, percent, ואז url כשהוידאו מוכן.
- duration_s15 עד 180 שניות
- סגנון24 סגנונות חזותיים, וגם שלך: GET /api/explainer/styles
- voiceקול מהקטלוג, לפי שם או מזהה
- dry_runtrue: בודק את המכסה והעלות בלי להפעיל דבר
curl -s -X POST https://cliponit.app/api/agent/produce \
-H "Authorization: Bearer $CLIPONIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"topic": "La photosynthèse en 3 étapes", "duration_s": 45}'
curl -s https://cliponit.app/api/jobs/JOB_ID \
-H "Authorization: Bearer $CLIPONIT_API_KEY"
curl -s -o lecon.mp4 "URL_DU_JOB"const API = "https://cliponit.app";
const headers = {
Authorization: `Bearer ${process.env.CLIPONIT_API_KEY}`,
"Content-Type": "application/json",
};
async function call(method, path, body) {
const res = await fetch(API + path, { method, headers, body: body && JSON.stringify(body) });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
return res.json();
}
let { job } = await call("POST", "/api/agent/produce", { topic: "La photosynthèse en 3 étapes", duration_s: 45 });
while (!["done", "failed", "canceled"].includes(job.status)) {
await new Promise((r) => setTimeout(r, 10_000));
job = await call("GET", `/api/jobs/${job.id}`);
}
console.log(job.status === "done" ? job.url : job.error);import json, os, time, urllib.request
API = "https://cliponit.app"
KEY = os.environ["CLIPONIT_API_KEY"]
def call(method, path, body=None):
req = urllib.request.Request(API + path, method=method,
data=None if body is None else json.dumps(body).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"})
with urllib.request.urlopen(req) as r:
return json.load(r)
job = call("POST", "/api/agent/produce", {"topic": "La photosynthèse en 3 étapes", "duration_s": 45})["job"]
while job["status"] not in ("done", "failed", "canceled"):
time.sleep(10)
job = call("GET", f"/api/jobs/{job['id']}")
if job["status"] == "done":
urllib.request.urlretrieve(job["url"], "lecon.mp4")
else:
print(job["error"])MCP
שרת MCP עבור סוכנים
כתובת יחידה https://cliponit.app/mcp, ב-HTTP “streamable”. הכלים מכסים את שני המוצרים: ייבוא, המתנה, יצירה וייצוא של קליפים, הפקת סרטון הסברה והמתנה לסיומו. הפעולות שמשנות משהו מסומנות כדי שהסוכן יבקש אישור קודם.
Claude Desktop ו-Claude.ai: הגדרות ← מחברים ← הוסף מחבר מותאם אישית, עם הכתובת שלמעלה. החיבור נעשה דרך OAuth, בלי מפתח להעתיק; ChatGPT פועל באותה דרך. מדריך צעד אחר צעד
claude mcp add --transport http cliponit https://cliponit.app/mcp \
--header "Authorization: Bearer $CLIPONIT_API_KEY"{
"mcpServers": {
"cliponit": {
"url": "https://cliponit.app/mcp",
"headers": { "Authorization": "Bearer ${env:CLIPONIT_API_KEY}" }
}
}
}{
"inputs": [
{ "type": "promptString", "id": "cliponit-key", "description": "ClipOnIt API key", "password": true }
],
"servers": {
"cliponit": {
"type": "http",
"url": "https://cliponit.app/mcp",
"headers": { "Authorization": "Bearer ${input:cliponit-key}" }
}
}
}curl -s -X POST https://cliponit.app/mcp \
-H "Authorization: Bearer $CLIPONIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_quota", "arguments": {}}}'לקבל התראה במקום לשאול
בהגדרות ← אינטגרציות, הוסף עד 3 כתובות URL של https. כשהפקת Explainer מסתיימת, ClipOnIt שולח אליהן job.done או job.failed, עם אותו אובייקט כמו GET /api/jobs/{id}. שש ניסיונות במקרה של כישלון, במשך כ-8 שעות.
לקליפים של Smart Clipper עדיין אין webhook: עקוב אחרי המצב עם GET.
import hashlib, hmac, time
def verify(secret: str, header: str, body: bytes, tolerance: int = 300) -> bool:
"""header = X-ClipOnIt-Signature, body = raw request bytes."""
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
if abs(time.time() - int(parts.get("t", 0))) > tolerance:
return False
mac = hmac.new(secret.encode(), parts["t"].encode() + b"." + body, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, parts.get("v1", ""))מגבלות ומכסות לפי תוכנית
קריאות API נספרות כמו בממשק: אותן מכסות, אותו חשבון. צפייה במחירים
| חינם | Starter | Pro | Business | |
|---|---|---|---|---|
| API ו-MCP | — | ✓ | ✓ | ✓ |
| סרטוני Explainer בחודש | — | 15 | 30 | 100 |
| הפקות Explainer במקביל | — | 2 | 2 | 2 |
| מפתחות API לפי חשבון | — | 10 | 10 | 10 |
| Webhooks לפי חשבון | — | 3 | 3 | 3 |
- המפתח נשאר בשרת שלך.הוא נותן גישה לכל חשבון ClipOnIt: לעולם לא בדפדפן, באפליקציה לנייד או במאגר Git. שמור אותו במשתנה סביבה וקרא ל-ClipOnIt מה-backend שלך.
- מפתח אחד לכל שימוש, עם הרשאות משלו.הרשאת “קריאה” (צפייה, בדיקה) או “הפקה” (יצירת סרטונים). לכל מפתח יש שם, תאריך שימוש אחרון, וניתן לבטל אותו בלחיצה: הוא נכנס לתוקף 401 כבר בקריאה הבאה.
- הסוד מוצג רק פעם אחת.ClipOnIt שומר רק את טביעת האצבע שלו (SHA-256). מפתח שאבד מוחלף, לא נקרא מחדש.
- Webhooks חתומים.כל שליחה נושאת X-ClipOnIt-Signature (HMAC-SHA256 של הגוף והחותמת הזמן); דחה כל שליחה בת יותר מ-5 דקות. כתובות הקבלה הן https ומאומתות בכל שליחה.
- מתארח באיחוד האירופי.שרתי Hetzner באיחוד האירופי; תת-הקבלנים מפורטים במדיניות הפרטיות.
שאלות נפוצות
SDK, ווידג'ט, זמנים, מכסות ונפח.
איזו תוכנית נדרשת ל-API?
התוכנית החינמית מספיקה להתחלה: המפתח נוצר והשרת MCP עונה, עבור 3 סרטוני Explainer בחודש עם סימן מים, בתוך 8 הסגנונות החינמיים. התוכניות בתשלום מוסיפות עוד סרטונים (15, 30 או 100 בחודש), בלי סימן מים, את כל 24 הסגנונות, את הקול שלך במיקרופון ואת הבמאי AI. מכסות ה-API הן של החשבון, כמו בממשק.
האם יש SDK?
אין כרגע SDK רשמי. ה-API הוא HTTP ו-JSON, מתועד ב-OpenAPI 3.1 (/openapi.json): הדוגמאות בדף הזה מסתכמות בכמה שורות של fetch או Python סטנדרטי, ואפשר ליצור לקוח מקובץ ה-OpenAPI.
האם אפשר להטמיע נגן או עורך של ClipOnIt באתר שלי?
לא, אין ווידג'ט להטמעה. מורידים את קובץ ה-MP4 ומציגים אותו בנגן שלך, או מארחים אותו אצלך.
כמה זמן לוקחת יצירת סרטון?
סרטון הסבר: כמה דקות (כתיבה ואז רינדור, בערך 4 דקות לרינדור). קליפים: בערך 1 עד 5 דקות עבור 20 דקות של וידאו, ואז ייצוא של כל קליפ. ה-API מחזיר את השלב, האחוזים והערכת הזמן שנותר.
מה קורה כשמגיעים למכסה?
ה-API מחזיר 402 עם הודעה ברורה (מכסה חודשית או תקציב AI), 403 אם הפונקציה לא כלולה בתוכנית, 429 אם כבר רצות שתי הפקות Explainer. עבור Explainer, “dry_run”: true בודק הכול לפני ההפעלה, בלי ליצור או לחייב דבר.
אני רוצה לחבר את ClipOnIt לכל המשתמשים שלי.
Une clé agit sur un seul compte ClipOnIt : les vidéos et les quotas sont ceux de ce compte. Pour un usage à plus grande échelle, écris-nous à contact@cliponit.app avec ton volume et ton cas d'usage.
הסרטון הראשון שלך דרך ה-API, היום
Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.