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

  • MCP

    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.

  1. Creează sarcina

    Un POST cu subiectul sau linkul videoclipului. Răspuns imediat, cu un identificator.

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

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

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"

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

GratuitStarterProBusiness
API și MCP—✓✓✓
Videoclipuri Explainer pe lună—1530100
Producții Explainer simultane—222
Chei API per cont—101010
Webhook-uri per cont—333

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.

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