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/produceMCP
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.
- Vytvořit úlohu
POST s tématem nebo odkazem na video. Okamžitá odpověď s identifikátorem.
- 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.
- 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"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
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
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": {}}}'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
| Zdarma | Starter | Pro | Business | |
|---|---|---|---|---|
| API a MCP | — | ✓ | ✓ | ✓ |
| Videa Explainer za měsíc | — | 15 | 30 | 100 |
| Souběžné produkce Explaineru | — | 2 | 2 | 2 |
| Klíče API podle účtu | — | 10 | 10 | 10 |
| Webhooky podle účtu | — | 3 | 3 | 3 |
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.