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/produce

  • MCP

    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.

  1. Feladat létrehozása

    Egy POST a témával vagy a videó linkjével. Azonnali válasz azonosítóval.

  2. Á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.

  3. 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"

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

Videók generálása Claude-dal: eszközök, példák, kvóták

claude mcp add --transport http cliponit https://cliponit.app/mcp \
  --header "Authorization: Bearer $CLIPONIT_API_KEY"

É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

IngyenesStarterProBusiness
API és MCP—✓✓✓
Havi Explainer videók—1530100
Egyidejű Explainer-gyártások—222
API-kulcsok fiókonként—101010
Webhookok fiókonként—333

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.

llms-api.txt · OpenAPI 3.1 · mcp.json