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/produceMCP
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.
- Utwórz zadanie
POST z tematem lub linkiem do wideo. Natychmiastowa odpowiedź z identyfikatorem.
- Śledź stan
GET mniej więcej co 10 s: etap, procent, pozostały czas. Dla Explainera webhook może cię powiadomić zamiast tego.
- 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"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
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
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": {}}}'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
| Darmowy | Starter | Pro | Business | |
|---|---|---|---|---|
| API i MCP | — | ✓ | ✓ | ✓ |
| Filmy Explainer miesięcznie | — | 15 | 30 | 100 |
| Produkcje Explainer równocześnie | — | 2 | 2 | 2 |
| Klucze API dla konta | — | 10 | 10 | 10 |
| Webhooki na konto | — | 3 | 3 | 3 |
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.