Dla deweloperów i firm SaaS

Dodaj wideo AI do swojego produktu w kilku wywołaniach

REST API, serwer MCP i webhooki: twój produkt tworzy wideo wyjaśniające i tnie długie filmy na shorty, bez otwierania ClipOnIt przez twoich użytkowników.

Już w darmowym planie (3 filmów miesięcznie ze znakiem wodnym) · klucz tworzysz w Ustawienia → Integracje

Dwa sposoby, by z tego korzystać

Dwa produkty ClipOnIt, wywoływane z twojego kodu lub przez agenta.

  • AI Explainer

    Narzędzie szkoleniowe: jedno wideo wyjaśniające na lekcję

    Twój produkt wysyła tytuł lub treść lekcji; ClipOnIt pisze sceny, ilustruje je, dodaje lektora i napisy, po czym generuje pionowy MP4, który wyświetlasz obok kursu.

    POST /api/agent/produce

  • MCP

    Agent AI, który steruje ClipOnIt

    Twój agent (Claude, Cursor, VS Code lub własny) łączy się z serwerem MCP: importuje wideo, wybiera klipy, uruchamia wideo wyjaśniające i czeka na wynik, korzystając z już opisanych narzędzi.

    POST /mcp

Zawsze ten sam przepływ

Wideo zajmuje minuty, nie milisekundy: tworzysz zadanie, śledzisz jego stan i pobierasz plik.

  1. Utwórz zadanie

    POST z tematem lub linkiem do wideo. Natychmiastowa odpowiedź z identyfikatorem.

  2. Śledź stan

    GET mniej więcej co 10 s: etap, procent, pozostały czas. Dla Explainera webhook może cię powiadomić zamiast tego.

  3. Pobierz wideo

    Po zakończeniu adres URL pliku MP4 znajdziesz w odpowiedzi. Pobierz go lub wyświetl w swoim produkcie.

AI Explainer

Wideo wyjaśniające na podstawie tematu

POST /api/agent/produce przyjmuje temat (lub skrypt, lub nagranie audio) i uruchamia pisanie, a potem renderowanie. GET /api/jobs/{id} zwraca status, step, percent, a potem url, gdy wideo jest gotowe.

  • duration_s15 do 180 sekund
  • style24 stylów wizualnych i twój: GET /api/explainer/styles
  • voicegłos z katalogu, po nazwie lub identyfikatorze
  • dry_runtrue: sprawdza limit i koszt bez niczego uruchamiania
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

Serwer MCP dla agentów

Unikalny adres https://cliponit.app/mcp, w HTTP „streamable”. Narzędzia obejmują oba produkty: importowanie, czekanie, tworzenie i eksportowanie klipów, tworzenie wideo wyjaśniającego i czekanie na jego zakończenie. Te, które coś modyfikują, są oznaczone, aby agent pytał wcześniej.

Claude Desktop i Claude.ai: Ustawienia → Konektory → Dodaj niestandardowy konektor, z powyższym adresem. Logowanie odbywa się przez OAuth, bez klucza do skopiowania; ChatGPT działa tak samo. Krok po kroku

Generuj wideo z Claude: narzędzia, przykłady, limity

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

Powiadomienie zamiast odpytywania

W Ustawienia → Integracje dodaj do 3 adresów URL https. Gdy produkcja Explainer się zakończy, ClipOnIt wysyła na nie job.done lub job.failed, z tym samym obiektem co GET /api/jobs/{id}. Sześć prób w razie niepowodzenia, przez mniej więcej 8 godzin.

Dla klipów Smart Clipper nie ma jeszcze webhooka: śledź stan za pomocą 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 i kwoty według planu

Wywołania API liczą się tak jak w interfejsie: te same limity, to samo konto. Zobacz ceny

DarmowyStarterProBusiness
API i MCP—✓✓✓
Filmy Explainer miesięcznie—1530100
Produkcje Explainer równocześnie—222
Klucze API dla konta—101010
Webhooki na konto—333

Bezpieczeństwo

Wywołuj ClipOnIt z własnego serwera, nigdy z przeglądarki twoich użytkowników.

Polityka prywatności
  • Klucz zostaje na twoim serwerze.Daje dostęp do całego konta ClipOnIt: nigdy w przeglądarce, aplikacji mobilnej ani repozytorium Git. Przechowuj go w zmiennej środowiskowej i wywołuj ClipOnIt z własnego backendu.
  • Jeden klucz na zastosowanie, z jego zakresem.Zakres „odczyt” (przeglądanie, sprawdzanie) lub „produkcja” (tworzenie wideo). Każdy klucz ma nazwę, datę ostatniego użycia i unieważnia się jednym kliknięciem: odpowiada 401 już przy następnym wywołaniu.
  • Sekret jest pokazywany tylko raz.ClipOnIt przechowuje tylko jego odcisk (SHA-256). Po zgubieniu klucz się zastępuje, nie da się go odczytać.
  • Podpisane webhooki.Każda wysyłka zawiera X-ClipOnIt-Signature (HMAC-SHA256 treści i znacznika czasu); odrzuca każdą wysyłkę starszą niż 5 minut. Adresy odbiorcze działają po https i są weryfikowane przy każdej wysyłce.
  • Hostowane w Unii Europejskiej.Serwery Hetzner w UE; podwykonawcy wymienieni w polityce prywatności.

Często zadawane pytania

SDK, widżet, terminy, limity i wolumen.

Jaki plan jest potrzebny do API?

Darmowy plan wystarczy, by zacząć: klucz tworzy się od razu, a serwer MCP odpowiada, dla 3 filmów Explainer miesięcznie ze znakiem wodnym, w 8 darmowych stylach. Płatne plany dodają więcej filmów (15, 30 lub 100 miesięcznie), bez znaku wodnego, 24 stylów, twój głos z mikrofonu i Reżysera AI. Limity API są takie jak na koncie, tak jak w interfejsie.

Czy jest SDK?

Oficjalnego SDK na razie nie ma. API działa w HTTP i JSON, opisane jest w OpenAPI 3.1 (/openapi.json): przykłady na tej stronie mieszczą się w kilku liniach fetch lub standardowego Pythona, a klienta możesz wygenerować z pliku OpenAPI.

Czy mogę osadzić odtwarzacz lub edytor ClipOnIt na mojej stronie?

Nie, nie ma widżetu do osadzenia. Pobierasz plik MP4 i wyświetlasz go we własnym odtwarzaczu albo hostujesz u siebie.

Ile trwa wygenerowanie wideo?

Wideo wyjaśniające: kilka minut (pisanie, potem renderowanie, około 4 min na renderowanie). Klipy: około 1 do 5 minut na 20 minut wideo, potem eksport każdego klipu. API zwraca etap, procent i szacowany pozostały czas.

Co się dzieje, gdy osiągnięty zostanie limit?

API odpowiada 402 z czytelnym komunikatem (limit miesiąca lub budżet AI), 403, jeśli funkcji nie ma w planie, 429, jeśli dwie produkcje Explainer już działają. Dla Explainera „dry_run”: true sprawdza wszystko przed uruchomieniem, bez tworzenia i bez obciążania.

Chcę podłączyć ClipOnIt dla wszystkich moich użytkowników.

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.

Twoje pierwsze wideo przez API już dziś

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