Untuk developer dan SaaS
Tambahkan video AI ke produkmu dalam beberapa panggilan
Satu API REST, server MCP, dan webhook: produkmu membuat video penjelasan dan memotong video panjang menjadi shorts, tanpa penggunamu perlu membuka ClipOnIt.
Mulai dari paket gratis (3 video per bulan dengan watermark) · kunci dibuat di Pengaturan → Integrasi
Dua cara menggunakannya
Dua produk ClipOnIt, dipanggil dari kodemu atau oleh agen.
AI Explainer
Alat pelatihan: satu video penjelas per pelajaran
Produkmu mengirim judul atau teks pelajaran; ClipOnIt menulis adegan, mengilustrasikannya, menambahkan suara dan teks, lalu menghasilkan MP4 vertikal yang kamu tampilkan di samping kursus.
POST /api/agent/produceMCP
Agen AI yang mengendalikan ClipOnIt
Agenmu (Claude, Cursor, VS Code, atau milikmu) terhubung ke server MCP: ia mengimpor video, memilih klip, menjalankan video penjelas, dan menunggu hasilnya dengan alat yang sudah dijelaskan.
POST /mcp
Alurnya selalu sama
Video butuh menit, bukan milidetik: kamu membuat tugas, memantau statusnya, lalu mengambil filenya.
- Buat tugas
Satu POST dengan topik atau tautan video. Respons langsung berisi sebuah ID.
- Pantau statusnya
GET sekitar setiap 10 detik: langkah, persentase, sisa waktu. Untuk Explainer, webhook dapat memberitahumu sebagai gantinya.
- Ambil video
Setelah selesai, URL MP4 ada di respons. Unduh atau tampilkan di produkmu.
AI Explainer
Video penjelas dari sebuah topik
POST /api/agent/produce menerima topik (atau naskah, atau rekaman audio) dan memulai penulisan lalu render. GET /api/jobs/{id} mengembalikan status, step, percent, lalu url saat video siap.
- duration_s15 hingga 180 detik
- style24 gaya visual, dan milikmu: GET /api/explainer/styles
- Suara dari katalog, berdasarkan nama atau ID
- dry_runtrue: memeriksa kuota dan biaya tanpa menjalankan apa pun
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
Server MCP untuk agen
Satu alamat https://cliponit.app/mcp, dengan HTTP « streamable ». Alatnya mencakup kedua produk: mengimpor, menunggu, membuat dan mengekspor klip, menghasilkan video penjelas dan menunggu hasilnya selesai. Yang mengubah sesuatu diberi anotasi agar agen meminta izin dulu.
Claude Desktop dan Claude.ai: Pengaturan → Konektor → Tambah konektor kustom, dengan alamat di atas. Koneksi dilakukan lewat OAuth, tanpa kunci yang perlu disalin; ChatGPT bekerja dengan cara yang sama. Panduan langkah demi langkah
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": {}}}'Diberi tahu, tanpa perlu bertanya
Di Pengaturan → Integrasi, tambahkan hingga 3 URL https. Saat produksi Explainer selesai, ClipOnIt mengirim job.done atau job.failed ke sana, dengan objek yang sama seperti GET /api/jobs/{id}. Enam percobaan jika gagal, dalam sekitar 8 jam.
Untuk klip Smart Clipper, belum ada webhook: pantau statusnya dengan 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", ""))Batas dan kuota per paket
Panggilan API dihitung sama seperti di antarmuka: kuota yang sama, akun yang sama. Lihat harga
| Gratis | Starter | Pro | Business | |
|---|---|---|---|---|
| API dan MCP | — | ✓ | ✓ | ✓ |
| Video Explainer per bulan | — | 15 | 30 | 100 |
| Produksi Explainer sekaligus | — | 2 | 2 | 2 |
| Kunci API per akun | — | 10 | 10 | 10 |
| Webhook per akun | — | 3 | 3 | 3 |
- Kunci tetap di servermu.Kunci ini memberi akses ke seluruh akun ClipOnIt: jangan pernah di browser, aplikasi seluler, atau repositori Git. Simpan di variabel lingkungan dan panggil ClipOnIt dari backend-mu.
- Satu kunci per penggunaan, dengan cakupannya.Cakupan «baca» (melihat, memverifikasi) atau «produksi» (membuat video). Setiap kunci punya nama, tanggal terakhir digunakan, dan bisa dicabut dengan satu klik: kunci itu langsung merespons 401 pada panggilan berikutnya.
- Rahasia hanya ditampilkan sekali.ClipOnIt hanya menyimpan sidik jarinya (SHA-256). Jika hilang, kunci diganti, tidak bisa dilihat ulang.
- Webhook bertanda tangan.Setiap pengiriman membawa X-ClipOnIt-Signature (HMAC-SHA256 dari isi dan stempel waktu); tolak pengiriman yang lebih dari 5 menit. URL penerima wajib https dan diverifikasi setiap pengiriman.
- Dihosting di Uni Eropa.Server Hetzner di UE; subkontraktor tercantum dalam kebijakan privasi.
Pertanyaan umum
SDK, widget, tenggat, kuota, dan volume.
Paket apa yang dibutuhkan untuk API?
Paket gratis sudah cukup untuk memulai: kunci dibuat dan server MCP merespons, untuk 3 video Explainer per bulan dengan watermark, dalam 8 gaya gratis. Paket berbayar menambah lebih banyak video (15, 30 atau 100 per bulan), tanpa watermark, semua 24 gaya, suaramu lewat mikrofon, dan Sutradara AI. Kuota API mengikuti akun, sama seperti di antarmuka.
Apakah ada SDK?
Belum ada SDK resmi. API berbasis HTTP dan JSON, dijelaskan dalam OpenAPI 3.1 (/openapi.json): contoh di halaman ini hanya beberapa baris fetch atau Python standar, dan kamu bisa membuat klien dari file OpenAPI.
Bisakah saya menyematkan pemutar atau editor ClipOnIt di situs saya?
Tidak, tidak ada widget yang bisa ditanamkan. Kamu mengambil file MP4 dan menampilkannya di pemutarmu sendiri, atau menyimpannya di servermu.
Berapa lama video dibuat?
Video penjelasan: beberapa menit (penulisan lalu render, sekitar 4 menit untuk render). Klip: sekitar 1 sampai 5 menit untuk 20 menit video, lalu ekspor setiap klip. API mengembalikan langkah, persentase, dan perkiraan sisa waktu.
Apa yang terjadi saat kuota tercapai?
API merespons 402 dengan pesan yang jelas (kuota bulanan atau anggaran AI), 403 jika fungsi tidak termasuk dalam paket, 429 jika dua produksi Explainer sudah berjalan. Untuk Explainer, « dry_run »: true memeriksa semuanya sebelum memulai, tanpa membuat atau menagihkan apa pun.
Saya ingin menghubungkan ClipOnIt untuk semua pengguna saya.
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.
Video pertamamu lewat API, hari ini
Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.