Для розробників і SaaS

Додай ШІ-відео до свого продукту за кілька викликів API

REST API, MCP-сервер і вебхуки: твій продукт створює пояснювальні відео та нарізає довгі відео на шорти, а твої користувачі навіть не відкривають ClipOnIt.

Уже на безкоштовному тарифі (3 відео на місяць із водяним знаком) · ключ створюється в Налаштування → Інтеграції

Два способи скористатися

Два продукти ClipOnIt, які викликаються з твого коду або агентом.

  • AI Explainer

    Навчальний інструмент: пояснювальне відео для кожного уроку

    Твій продукт надсилає заголовок або текст уроку; ClipOnIt пише сцени, ілюструє їх, додає озвучення та субтитри, а потім рендерить вертикальний MP4, який ти показуєш поруч із курсом.

    POST /api/agent/produce

  • MCP

    ШІ-агент, який керує ClipOnIt

    Твій агент (Claude, Cursor, VS Code або власний) підключається до сервера MCP: він імпортує відео, обирає кліпи, запускає пояснювальне відео й чекає результату з уже описаними інструментами.

    POST /mcp

Завжди один і той самий потік

Відео створюється хвилини, а не мілісекунди: ти створюєш завдання, стежиш за його станом і отримуєш файл.

  1. Створити завдання

    POST-запит із темою або посиланням на відео. Миттєва відповідь з ідентифікатором.

  2. Стеж за станом

    GET приблизно кожні 10 с: етап, відсоток, час, що залишився. Для Explainer вебхук може повідомити тебе замість цього.

  3. Отримати відео

    Після завершення 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"

MCP

MCP-сервер для агентів

Єдина адреса https://cliponit.app/mcp, через HTTP «streamable». Інструменти охоплюють обидва продукти: імпорт, очікування, створення й експорт кліпів, генерація пояснювального відео та очікування його завершення. Ті, що щось змінюють, позначені, щоб агент питав дозвіл перед дією.

Claude Desktop і Claude.ai: Налаштування → Конектори → Додати власний конектор, з адресою вище. Підключення відбувається через OAuth, без ключа для копіювання; ChatGPT працює так само. Покроково

Створюй відео з Claude: інструменти, приклади, квоти

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

Дізнатися першим, а не питати

У Налаштуваннях → Інтеграції додай до 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-виклики враховуються так само, як в інтерфейсі: ті самі квоти, той самий обліковий запис. Переглянути тарифи

БезкоштовнийStarterProBusiness
API та MCP—✓✓✓
Відео Explainer на місяць—1530100
Одночасні продукції Explainer—222
API-ключі на обліковий запис—101010
Вебхуки для облікового запису—333

Безпека

Викликай 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.

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