Fejlesztőknek és SaaS-cégeknek
Adj hozzá MI-videót a termékedhez néhány hívással
Egy API REST, egy MCP szerver és webhookok: a terméked magyarázó videókat hoz létre, és a hosszú videókat rövid shortokra vágja, anélkül hogy a felhasználóid megnyitnák a ClipOnItet.
Már az ingyenes csomagtól (3 videó havonta vízjellel) · a kulcs a Beállítások → Integrációk menüben hozható létre
Kétféle használat
A ClipOnIt két terméke, amelyeket a kódodból vagy egy ügynökkel hívhatsz.
AI Explainer
Képzési eszköz: egy magyarázó videó leckénként
A terméked elküldi a lecke címét vagy szövegét; a ClipOnIt megírja a jeleneteket, illusztrálja őket, hangot és feliratokat ad hozzá, majd függőleges MP4 videót renderel, amelyet a tanfolyam mellett jeleníthetsz meg.
POST /api/agent/produceMCP
Egy MI-ügynök, amely a ClipOnIt-et vezérli
Az ügynököd (Claude, Cursor, VS Code vagy saját) az MCP-szerverhez csatlakozik: importál egy videót, kiválasztja a klipeket, magyarázó videót indít, és a már leírt eszközökkel megvárja az eredményt.
POST /mcp
Mindig ugyanaz a folyamat
Egy videó percekig tart, nem milliszekundumokig: létrehozol egy feladatot, követed az állapotát, és letöltöd a fájlt.
- Feladat létrehozása
Egy POST a témával vagy a videó linkjével. Azonnali válasz azonosítóval.
- Állapot követése
Nagyjából 10 másodpercenként egy GET: lépés, százalék, hátralévő idő. Az Explainerhez egy webhook is értesíthet helyette.
- Videó letöltése
Ha kész, az MP4 URL-je a válaszban van. Töltsd le, vagy jelenítsd meg a termékedben.
AI Explainer
Magyarázó videó egy témából
A POST /api/agent/produce témát (vagy szkriptet, vagy hangfelvételt) fogad, és elindítja az írást, majd a renderelést. A GET /api/jobs/{id} visszaadja a status, step, percent mezőket, majd a url-t, amikor a videó kész.
- duration_s15 – 180 másodperc
- stílus24 vizuális stílus, és a tied: GET /api/explainer/styles
- voicea katalógus egyik hangja, név vagy azonosító alapján
- dry_runtrue: ellenőrzi a kvótát és a költséget anélkül, hogy bármit elindítana
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 szerver ügynököknek
Egyetlen végpont: https://cliponit.app/mcp, HTTP „streamable” módban. Az eszközök mindkét terméket lefedik: klipek importálása, megvárása, létrehozása és exportálása, magyarázó videó készítése és annak befejezésének megvárása. A módosítást végzők meg vannak jelölve, hogy az ügynök előbb kérdezzen.
Claude Desktop és Claude.ai: Beállítások → Összekötők → Egyéni összekötő hozzáadása, a fenti címmel. A csatlakozás OAuth-tal történik, nincs másolandó kulcs; a ChatGPT ugyanígy működik. Lépésről lépésre
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": {}}}'Értesítést kapj ahelyett, hogy kérdezgetnél
A Beállítások → Integrációk részben legfeljebb 3 https URL-t adhatsz meg. Amikor egy Explainer-gyártás véget ér, a ClipOnIt elküldi a job.done vagy job.failed eseményt, ugyanazzal az objektummal, mint a GET /api/jobs/{id}. Hiba esetén hat újrapróbálkozás, nagyjából 8 órán belül.
A Smart Clipper klipekhez egyelőre nincs webhook: az állapotot GET-tel kövesd.
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", ""))Korlátok és kvóták csomagonként
Az API-hívások ugyanúgy számítanak, mint a felületen: ugyanazok a kvóták, ugyanaz a fiók. Árak megtekintése
| Ingyenes | Starter | Pro | Business | |
|---|---|---|---|---|
| API és MCP | — | ✓ | ✓ | ✓ |
| Havi Explainer videók | — | 15 | 30 | 100 |
| Egyidejű Explainer-gyártások | — | 2 | 2 | 2 |
| API-kulcsok fiókonként | — | 10 | 10 | 10 |
| Webhookok fiókonként | — | 3 | 3 | 3 |
Biztonság
Hívd a ClipOnIt-et a szerveredről, sosem a felhasználóid böngészőjéből.
Adatvédelmi szabályzat- A kulcs a szerveredén marad.Teljes hozzáférést ad a ClipOnIt-fiókhoz: soha ne a böngészőben, mobilalkalmazásban vagy Git-tárolóban. Tartsd környezeti változóban, és a ClipOnIt-et a backendedről hívd.
- Kulcs használatonként, jogosultsággal.Hatókör „olvasás” (lekérdezés, ellenőrzés) vagy „gyártás” (videók létrehozása). Minden kulcsnak van neve, utolsó használatának dátuma, és egy kattintással visszavonható: a következő hívástól 401 választ ad.
- A titkot csak egyszer mutatjuk meg.A ClipOnIt csak az ujjlenyomatát (SHA-256) tárolja. Ha elveszett, a kulcsot új váltja fel, nem lehet visszanézni.
- Aláírt webhookok.Minden küldemény az X-ClipOnIt-Signature fejlécet hordozza (a törzs és az időbélyeg HMAC-SHA256 értéke); elutasít minden 5 percnél régebbi küldeményt. A fogadó URL-ek https-ek, és minden küldésnél ellenőrzik őket.
- Az Európai Unióban tárolva.Hetzner szerverek az EU-ban; az alvállalkozókat az adatvédelmi szabályzat sorolja fel.
Gyakori kérdések
SDK, widget, határidők, kvóták és volumen.
Melyik csomag kell az API-hoz?
Az ingyenes csomag elég a kezdéshez: a kulcs létrehozható és az MCP szerver válaszol, havi 3 Explainer-videóval vízjellel, 8 ingyenes stílusban. A fizetős csomagok több videót adnak (15, 30 vagy 100 havonta), vízjel nélkül, a 24 stílussal, a hangoddal a mikrofonról és az MI Rendezővel. Az API kvótái a fiók kvótái, ahogy a felületen is.
Van SDK?
Hivatalos SDK egyelőre nincs. Az API HTTP és JSON alapú, OpenAPI 3.1 formátumban írják le (/openapi.json): ennek az oldalnak a példái néhány sor fetch vagy szabványos Python kód, és az OpenAPI-fájlból kliens is generálható.
Beágyazhatok ClipOnIt lejátszót vagy szerkesztőt a weboldalamba?
Nem, nincs beágyazható widget. Letöltöd az MP4 fájlt, és a saját lejátszódban jeleníted meg, vagy saját szerveren tárolod.
Mennyi idő alatt készül egy videó?
Magyarázó videó: néhány perc (írás, majd renderelés, a renderelés körülbelül 4 perc). Klipek: körülbelül 1–5 perc 20 perc videóhoz, majd minden klip exportja. Az API visszaadja a lépést, a százalékot és a hátralévő idő becslését.
Mi történik, ha elérsz egy kvótát?
Az API 402 választ ad egyértelmű üzenettel (havi keret vagy AI-költségkeret), 403, ha a funkció nincs a csomagban, 429, ha már két Explainer-gyártás fut. Az Explainernél a „dry_run”: true mindent ellenőriz indítás előtt, anélkül hogy bármit létrehozna vagy terhelne.
Mindenki számára szeretném bekötni a ClipOnIt-et.
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.
Az első videód az API-n keresztül, még ma
Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.