Для розробників і SaaS
Додай ШІ-відео до свого продукту за кілька викликів API
REST API, MCP-сервер і вебхуки: твій продукт створює пояснювальні відео та нарізає довгі відео на шорти, а твої користувачі навіть не відкривають ClipOnIt.
Уже на безкоштовному тарифі (3 відео на місяць із водяним знаком) · ключ створюється в Налаштування → Інтеграції
Два способи скористатися
Два продукти ClipOnIt, які викликаються з твого коду або агентом.
AI Explainer
Навчальний інструмент: пояснювальне відео для кожного уроку
Твій продукт надсилає заголовок або текст уроку; ClipOnIt пише сцени, ілюструє їх, додає озвучення та субтитри, а потім рендерить вертикальний MP4, який ти показуєш поруч із курсом.
POST /api/agent/produceMCP
ШІ-агент, який керує ClipOnIt
Твій агент (Claude, Cursor, VS Code або власний) підключається до сервера MCP: він імпортує відео, обирає кліпи, запускає пояснювальне відео й чекає результату з уже описаними інструментами.
POST /mcp
Завжди один і той самий потік
Відео створюється хвилини, а не мілісекунди: ти створюєш завдання, стежиш за його станом і отримуєш файл.
- Створити завдання
POST-запит із темою або посиланням на відео. Миттєва відповідь з ідентифікатором.
- Стеж за станом
GET приблизно кожні 10 с: етап, відсоток, час, що залишився. Для Explainer вебхук може повідомити тебе замість цього.
- Отримати відео
Після завершення URL MP4 міститься у відповіді. Завантаж його або покажи у своєму продукті.
AI Explainer
Пояснювальне відео за темою
POST /api/agent/produce приймає тему (або сценарій, або аудіозапис) і запускає написання, а потім рендеринг. GET /api/jobs/{id} повертає status, step, percent, а потім url, коли відео готове.
- duration_sвід 15 до 180 секунд
- стиль24 візуальних стилів, і твій: GET /api/explainer/styles
- voiceголос із каталогу за назвою або ідентифікатором
- dry_runtrue: перевіряє квоту й вартість без запуску
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
MCP-сервер для агентів
Єдина адреса https://cliponit.app/mcp, через HTTP «streamable». Інструменти охоплюють обидва продукти: імпорт, очікування, створення й експорт кліпів, генерація пояснювального відео та очікування його завершення. Ті, що щось змінюють, позначені, щоб агент питав дозвіл перед дією.
Claude Desktop і Claude.ai: Налаштування → Конектори → Додати власний конектор, з адресою вище. Підключення відбувається через OAuth, без ключа для копіювання; ChatGPT працює так само. Покроково
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": {}}}'Дізнатися першим, а не питати
У Налаштуваннях → Інтеграції додай до 3 https-URL. Коли завершується генерація в Explainer, ClipOnIt надсилає на них job.done або job.failed з тим самим об'єктом, що й GET /api/jobs/{id}. Шість спроб у разі збою, приблизно протягом 8 годин.
Для кліпів Smart Clipper поки немає вебхука: стеж за станом через 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", ""))Ліміти та квоти за тарифами
API-виклики враховуються так само, як в інтерфейсі: ті самі квоти, той самий обліковий запис. Переглянути тарифи
| Безкоштовний | Starter | Pro | Business | |
|---|---|---|---|---|
| API та MCP | — | ✓ | ✓ | ✓ |
| Відео Explainer на місяць | — | 15 | 30 | 100 |
| Одночасні продукції Explainer | — | 2 | 2 | 2 |
| API-ключі на обліковий запис | — | 10 | 10 | 10 |
| Вебхуки для облікового запису | — | 3 | 3 | 3 |
Безпека
Викликай ClipOnIt зі свого сервера, ніколи з браузера твоїх користувачів.
Політика конфіденційності- Ключ залишається на твоєму сервері.Він дає доступ до всього облікового запису ClipOnIt: ніколи не в браузері, мобільному застосунку чи Git-репозиторії. Зберігай його у змінній середовища і викликай ClipOnIt зі свого бекенду.
- Один ключ на сценарій, з обмеженою дією.Доступ «читання» (перегляд, перевірка) або «генерація» (створення відео). Кожен ключ має назву, дату останнього використання і відкликається одним клацанням: він перестає працювати 401 з наступного виклику.
- Секрет показується лише один раз.ClipOnIt зберігає лише його відбиток (SHA-256). Якщо ключ загубиться, його замінюють, а не відновлюють.
- Підписані вебхуки.Кожне надсилання містить X-ClipOnIt-Signature (HMAC-SHA256 тіла та мітки часу); відхиляй будь-яке надсилання старше 5 хв. URL для отримання мають бути https і перевірятися при кожному надсиланні.
- Розміщено в Європейському Союзі.Сервери Hetzner в ЄС; субпідрядники перелічені в політиці конфіденційності.
Часті запитання
SDK, віджет, терміни, квоти та обсяг.
Який тариф потрібен для API?
Безкоштовного тарифу достатньо для початку: ключ створюється, а сервер MCP відповідає, для 3 відео Explainer на місяць із водяним знаком, у 8 безкоштовних стилях. Платні тарифи додають більше відео (15, 30 або 100 на місяць), без водяного знака, 24 стилів, твій голос через мікрофон і ШІ-режисера. Квоти API — ті самі, що в акаунті та інтерфейсі.
Чи є SDK?
Офіційного SDK поки немає. API працює через HTTP і JSON, описаний у OpenAPI 3.1 (/openapi.json): приклади на цій сторінці займають кілька рядків fetch або стандартного Python, а клієнт можна згенерувати з файлу OpenAPI.
Чи можна вбудувати плеєр або редактор ClipOnIt на мій сайт?
Ні, віджета для вбудовування немає. Ти отримуєш файл MP4 і показуєш його у своєму плеєрі або розміщуєш у себе.
Скільки часу займає відео?
Пояснювальне відео: кілька хвилин (написання, потім рендеринг, близько 4 хв на рендеринг). Кліпи: приблизно від 1 до 5 хвилин на 20 хвилин відео, а потім експорт кожного кліпа. API повертає етап, відсоток і оцінку часу, що залишився.
Що відбувається, коли досягнуто квоту?
API відповідає 402 з чітким повідомленням (квота на місяць або бюджет ШІ), 403, якщо функції немає в тарифі, 429, якщо вже працюють дві генерації Explainer. Для Explainer «dry_run»: true перевіряє все перед запуском, нічого не створюючи і не списуючи оплату.
Хочу підключити ClipOnIt для всіх моїх користувачів.
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.
Твоє перше відео через API, сьогодні
Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.