Pro vývojáře a SaaS

Přidej AI video do svého produktu během několika volání

REST API, server MCP a webhooky: tvůj produkt vytváří vysvětlující videa a dělí dlouhá videa na shorty, aniž by tvoji uživatelé museli otevřít ClipOnIt.

Už v bezplatném tarifu (3 videí měsíčně s vodoznakem) · klíč vytvoříš v Nastavení → Integrace

Dva způsoby použití

Dva produkty ClipOnIt, volané z tvého kódu nebo agentem.

  • AI Explainer

    Nástroj pro výuku: jedno vysvětlující video na lekci

    Tvůj produkt pošle název nebo text lekce; ClipOnIt napíše scény, ilustruje je, přidá hlas a titulky a vyrenderuje vertikální MP4, které zobrazíš vedle kurzu.

    POST /api/agent/produce

  • MCP

    Agent AI, který ovládá ClipOnIt

    Tvůj agent (Claude, Cursor, VS Code nebo vlastní) se připojí k MCP serveru: importuje video, vybere klipy, spustí vysvětlující video a čeká na výsledek s již popsanými nástroji.

    POST /mcp

Pořád stejný postup

Video trvá minuty, ne milisekundy: vytvoříš úlohu, sleduješ její stav a stáhneš soubor.

  1. Vytvořit úlohu

    POST s tématem nebo odkazem na video. Okamžitá odpověď s identifikátorem.

  2. Sledovat stav

    GET přibližně každých 10 s: krok, procento, zbývající čas. U Explaineru tě místo toho může upozornit webhook.

  3. Stáhnout video

    Po dokončení je URL MP4 v odpovědi. Stáhni ho nebo ho zobraz ve svém produktu.

AI Explainer

Vysvětlující video z tématu

POST /api/agent/produce přijme téma (nebo skript, nebo audionahrávku) a spustí zápis a následně render. GET /api/jobs/{id} vrátí status, step, percent a pak url, jakmile je video hotové.

  • duration_s15 až 180 sekund
  • styl24 vizuálních stylů a ten tvůj: GET /api/explainer/styles
  • hlashlas z katalogu, podle názvu nebo identifikátoru
  • dry_runtrue: ověří kvótu a náklady, nic nespustí
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

Server MCP pro agenty

Jednotná adresa https://cliponit.app/mcp, přes HTTP „streamable“. Nástroje pokrývají oba produkty: importovat, čekat, vytvářet a exportovat klipy, vytvářet vysvětlující video a čekat na jeho dokončení. Nástroje, které něco mění, jsou označené, aby agent nejdřív požádal o potvrzení.

Claude Desktop a Claude.ai: Nastavení → Konektory → Přidat vlastní konektor, s adresou výše. Připojení probíhá přes OAuth, bez klíče ke kopírování; ChatGPT funguje stejně. Postup krok za krokem

Generujte videa s Claude: nástroje, příklady, kvóty

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

Upozornění místo dotazování

V Nastavení → Integrace přidej až 3 URL adres https. Když se produkce Explaineru dokončí, ClipOnIt na ně pošle job.done nebo job.failed se stejným objektem jako GET /api/jobs/{id}. Při selhání proběhne šest pokusů během přibližně 8 hodin.

Pro klipy Smart Clipper zatím žádný webhook není: stav sleduj přes 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", ""))

Limity a kvóty podle plánu

API volání se počítají jako v rozhraní: stejné kvóty, stejný účet. Zobrazit tarify

ZdarmaStarterProBusiness
API a MCP—✓✓✓
Videa Explainer za měsíc—1530100
Souběžné produkce Explaineru—222
Klíče API podle účtu—101010
Webhooky podle účtu—333

Bezpečnost

Volej ClipOnIt z tvého serveru, nikdy z prohlížeče tvých uživatelů.

Zásady ochrany osobních údajů
  • Klíč zůstane na tvém serveru.Dává přístup k celému účtu ClipOnIt: nikdy v prohlížeči, v mobilní aplikaci ani v repozitáři Git. Ulož ho do proměnné prostředí a volej ClipOnIt z backendu.
  • Jeden klíč na použití, s jeho rozsahem.Rozsah „čtení“ (prohlížet, ověřovat) nebo „produkce“ (vytvářet videa). Každý klíč má název, datum posledního použití a lze ho odvolat jedním kliknutím: reaguje 401 už při dalším volání.
  • Tajný klíč se zobrazí jen jednou.ClipOnIt si ponechává jen jeho otisk (SHA-256). Když se ztratí, klíč se nahradí, nelze ho znovu zobrazit.
  • Podepsané webhooky.Každé odeslání nese X-ClipOnIt-Signature (HMAC-SHA256 těla a časového razítka); odmítni každé odeslání starší než 5 minut. Přijímací URL jsou v https a ověřují se při každém odeslání.
  • Hostováno v Evropské unii.Servery Hetzner v EU; subdodavatelé jsou uvedeni v zásadách ochrany osobních údajů.

Časté otázky

SDK, widget, limity, kvóty a objem.

Jaký tarif potřebuji pro API?

Bezplatný tarif na začátek stačí: klíč se vytvoří a MCP server odpovídá, pro 3 videí Explainer měsíčně s vodoznakem, v 8 bezplatných stylech. Placené tarify přidají více videí (15, 30 nebo 100 měsíčně), bez vodoznaku, všech 24 stylů, tvůj hlas z mikrofonu a AI režisér. Kvóty API jsou kvóty účtu, stejně jako v rozhraní.

Existuje SDK?

Zatím žádné oficiální SDK. API běží na HTTP a JSON, popsané v OpenAPI 3.1 (/openapi.json): příklady na této stránce zaberou pár řádků fetch nebo standardního Pythonu a z OpenAPI souboru si můžeš vygenerovat klienta.

Můžu na svůj web vložit přehrávač nebo editor ClipOnIt?

Ne, žádný vložitelný widget není. Stáhneš soubor MP4 a zobrazíš ho ve svém vlastním přehrávači, nebo ho hostuješ u sebe.

Jak dlouho trvá vytvoření videa?

Vysvětlující video: několik minut (psaní a poté render, přibližně 4 min na render). Klipy: přibližně 1 až 5 minut na 20 minut videa, poté export každého klipu. API vrací krok, procento a odhad zbývajícího času.

Co se stane, když dojde kvóta?

API odpoví 402 s jasnou zprávou (měsíční kvóta nebo rozpočet AI), 403, pokud funkce není v tarifu, 429, pokud už běží dvě produkce Explaineru. U Explaineru „dry_run“: true ověří vše před spuštěním, aniž by něco vytvořila nebo účtovala.

Chci připojit ClipOnIt pro všechny své uživatele.

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.

Tvoje první video přes API, dnes

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