Pentru dezvoltatori și SaaS-uri
Adaugă videoclipul IA în produsul tău în câteva apeluri
Un API REST, un server MCP și webhook-uri: produsul tău creează videoclipuri explicative și taie videoclipuri lungi în shorts, fără ca utilizatorii tăi să deschidă ClipOnIt.
De la planul gratuit (3 videoclipuri pe lună cu filigran) · cheia se creează în Setări → Integrări
Două moduri de utilizare
Cele două produse ClipOnIt, apelate din codul tău sau de un agent.
AI Explainer
Un instrument de formare: un videoclip explicativ pentru fiecare lecție
Produsul tău trimite titlul sau textul lecției; ClipOnIt scrie scenele, le ilustrează, adaugă vocea și subtitrările, apoi generează un MP4 vertical pe care îl afișezi lângă curs.
POST /api/agent/produceMCP
Un agent AI care controlează ClipOnIt
Agentul tău (Claude, Cursor, VS Code sau al tău) se conectează la serverul MCP: importă un video, alege clipurile, lansează un videoclip explicativ și așteaptă rezultatul cu uneltele deja descrise.
POST /mcp
Mereu același flux
Un videoclip durează minute, nu milisecunde: creezi o sarcină, îi urmărești starea și descarci fișierul.
- Creează sarcina
Un POST cu subiectul sau linkul videoclipului. Răspuns imediat, cu un identificator.
- Urmărește starea
Un GET la aproximativ 10 s: etapă, procent, timp rămas. Pentru Explainer, un webhook te poate anunța în locul acestuia.
- Descarcă videoclipul
Odată terminat, URL-ul MP4-ului se află în răspuns. Descarcă-l sau afișează-l în produsul tău.
AI Explainer
Un videoclip explicativ dintr-un subiect
POST /api/agent/produce primește un subiect (sau un script, sau o înregistrare audio) și pornește scrierea, apoi randarea. GET /api/jobs/{id} returnează status, step, percent, apoi url când videoclipul este gata.
- duration_s15 până la 180 secunde
- stil24 stiluri vizuale, și al tău: GET /api/explainer/styles
- voceo voce din catalog, după nume sau identificator
- dry_runtrue: verifică cota și costul fără să lansezi nimic
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
Un server MCP pentru agenți
Adresă unică https://cliponit.app/mcp, în HTTP „streamable”. Uneltele acoperă ambele produse: importă, așteaptă, creează și exportă clipuri, produce un videoclip explicativ și așteaptă finalizarea acestuia. Cele care modifică ceva sunt marcate, ca agentul să ceară confirmare înainte.
Claude Desktop și Claude.ai: Setări → Conectori → Adaugă un conector personalizat, cu adresa de mai sus. Conectarea se face prin OAuth, fără cheie de copiat; ChatGPT funcționează la fel. Pas cu pas
Generează videoclipuri cu Claude: instrumente, exemple, cote
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": {}}}'Fii anunțat în loc să confirmi
În Setări → Integrări, adaugă până la 3 URL-uri https. Când o producție Explainer se termină, ClipOnIt trimite acolo job.done sau job.failed, cu același obiect ca GET /api/jobs/{id}. Șase încercări în caz de eșec, pe parcursul a aproximativ 8 ore.
Pentru clipurile Smart Clipper nu există încă webhook: urmărește starea cu 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", ""))Limite și cote pe abonament
Apelurile API se contorizează ca în interfață: aceleași cote, același cont. Vezi tarifele
| Gratuit | Starter | Pro | Business | |
|---|---|---|---|---|
| API și MCP | — | ✓ | ✓ | ✓ |
| Videoclipuri Explainer pe lună | — | 15 | 30 | 100 |
| Producții Explainer simultane | — | 2 | 2 | 2 |
| Chei API per cont | — | 10 | 10 | 10 |
| Webhook-uri per cont | — | 3 | 3 | 3 |
Securitate
Apelează ClipOnIt din serverul tău, niciodată din browserul utilizatorilor tăi.
Politica de confidențialitate- Cheia rămâne pe serverul tău.Ea dă acces la întregul cont ClipOnIt: niciodată în browser, într-o aplicație mobilă sau într-un depozit Git. Păstreaz-o într-o variabilă de mediu și apelează ClipOnIt din backend-ul tău.
- O cheie per utilizare, cu domeniul ei.Domeniu „citire” (consultare, verificare) sau „producție” (creare de videoclipuri). Fiecare cheie are un nume, o dată a ultimei utilizări și se revocă dintr-un clic: returnează 401 de la apelul următor.
- Secretul se afișează o singură dată.ClipOnIt păstrează doar amprenta (SHA-256). Dacă se pierde, cheia se înlocuiește, nu se mai poate citi.
- Webhook-uri semnate.Fiecare trimitere poartă X-ClipOnIt-Signature (HMAC-SHA256 al corpului și al marcajului de timp); refuză orice trimitere mai veche de 5 minute. URL-urile de primire sunt în https și verificate la fiecare trimitere.
- Găzduit în Uniunea Europeană.Servere Hetzner în UE; subprocesatorii sunt listați în politica de confidențialitate.
Întrebări frecvente
SDK, widget, termene, cote și volum.
Ce abonament e necesar pentru API?
Planul gratuit este suficient pentru început: cheia se creează și serverul MCP răspunde, pentru 3 videoclipuri Explainer pe lună cu filigran, în cele 8 stiluri gratuite. Planurile plătite adaugă mai multe videoclipuri (15, 30 sau 100 pe lună), fără filigran, cele 24 stiluri, vocea ta la microfon și Regizorul IA. Cotele API sunt cele ale contului, ca în interfață.
Există un SDK?
Nu există încă un SDK oficial. API-ul este HTTP și JSON, descris în OpenAPI 3.1 (/openapi.json): exemplele de pe această pagină au câteva rânduri de fetch sau Python standard, iar poți genera un client din fișierul OpenAPI.
Pot integra un player sau un editor ClipOnIt în site-ul meu?
Nu, nu există widget de integrat. Descarci fișierul MP4 și îl afișezi în propriul tău player sau îl găzduiești pe serverele tale.
Cât durează un videoclip?
Un videoclip explicativ: câteva minute (scriere, apoi randare, aproximativ 4 min pentru randare). Clipuri: aproximativ 1 până la 5 minute pentru 20 minute de video, apoi exportul fiecărui clip. API-ul returnează pasul, procentul și o estimare a timpului rămas.
Ce se întâmplă când se atinge o cotă?
API-ul răspunde 402 cu un mesaj clar (cota lunii sau bugetul IA), 403 dacă funcția nu este în plan, 429 dacă două producții Explainer rulează deja. Pentru Explainer, „dry_run”: true verifică totul înainte de lansare, fără să creeze nimic și fără să factureze.
Vreau să conectez ClipOnIt pentru toți utilizatorii mei.
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.
Primul tău videoclip prin API, azi
Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.