Geliştiriciler ve SaaS'ler için
Birkaç çağrıyla ürününe yapay zeka videosu ekle
Bir REST API, bir MCP sunucusu ve webhook'lar: ürünün açıklayıcı videolar oluşturur ve uzun videoları shorts'a böler, kullanıcıların ClipOnIt'i açmadan.
Ücretsiz plandan itibaren (3 video/ay, filigranlı) · anahtar Ayarlar → Entegrasyonlar bölümünde oluşturulur
Bunu kullanmanın iki yolu
ClipOnIt'in iki ürünü, kodundan ya da bir ajan tarafından çağrılır.
AI Explainer
Bir eğitim aracı: ders başına bir açıklayıcı video
Ürünün ders başlığını ya da metnini gönderir; ClipOnIt sahneleri yazar, görselleştirir, seslendirmeyi ve altyazıları ekler, ardından dersin yanında gösterdiğin dikey bir MP4 üretir.
POST /api/agent/produceMCP
ClipOnIt'i yöneten bir yapay zeka ajanı
Ajanın (Claude, Cursor, VS Code ya da kendininki) MCP sunucusuna bağlanır: video içe aktarır, klipleri seçer, bir açıklayıcı video başlatır ve hazır tanımlı araçlarla sonucu bekler.
POST /mcp
Her zaman aynı akış
Bir video dakikalar sürer, milisaniyeler değil: bir görev oluşturur, durumunu takip eder, dosyayı alırsın.
- Görevi oluştur
Video konusu veya bağlantısıyla bir POST isteği. Hemen bir kimlikle yanıt verilir.
- Durumu takip et
Yaklaşık her 10 sn'de bir GET: adım, yüzde, kalan süre. Explainer için bunun yerine bir webhook seni haberdar edebilir.
- Videoyu al
Bittiğinde MP4'ün URL'si yanıtta yer alır. İndir ya da ürününde göster.
AI Explainer
Bir konudan açıklayıcı video
POST /api/agent/produce bir konu (ya da bir senaryo, ya da bir ses kaydı) alır ve yazımı, ardından render işlemini başlatır. GET /api/jobs/{id} video hazır olduğunda status, step, percent ve ardından url döndürür.
- duration_s15 - 180 saniye
- stil24 görsel stil, bir de senin : GET /api/explainer/styles
- ses kataloğdan bir ses, ad ya da kimliğiyle
- dry_runtrue: kotayı ve maliyeti kontrol eder, hiçbir şey başlatmaz
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
Ajanlar için bir MCP sunucusu
https://cliponit.app/mcp için tek adres, « streamable » HTTP üzerinden. Araçlar iki ürünü kapsar: içe aktarma, bekleme, klip oluşturma ve dışa aktarma, açıklayıcı video üretme ve sonunu bekleme. Bir şeyi değiştirenler, ajanın önce sormasını sağlamak için işaretlenmiştir.
Claude Desktop ve Claude.ai: Ayarlar → Connectors → Özel connector ekle, yukarıdaki adresle. Bağlantı OAuth ile kurulur, kopyalanacak bir anahtar yok; ChatGPT de aynı şekilde çalışır. Adım adım
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": {}}}'Sormak yerine haberdar ol
Ayarlar → Entegrasyonlar'da en fazla 3 https URL ekle. Bir Explainer üretimi bittiğinde ClipOnIt oraya job.done ya da job.failed gönderir; içerik GET /api/jobs/{id} ile aynı nesnedir. Hata olursa altı deneme yapılır; yaklaşık 8 saat içinde.
Smart Clipper klipleri için henüz webhook yok: durumu GET ile takip et.
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", ""))Plana göre limitler ve kotalar
API çağrıları arayüzdekiyle aynı sayılır: aynı kotalar, aynı hesap. Fiyatlara bak
| Ücretsiz | Starter | Pro | Business | |
|---|---|---|---|---|
| API ve MCP | — | ✓ | ✓ | ✓ |
| Ayda Explainer videoları | — | 15 | 30 | 100 |
| Aynı anda Explainer üretimleri | — | 2 | 2 | 2 |
| Hesap başına API anahtarları | — | 10 | 10 | 10 |
| Hesap başına webhook'lar | — | 3 | 3 | 3 |
- Anahtar sunucunda kalır.Tüm ClipOnIt hesabına erişim verir: asla tarayıcıda, mobil uygulamada ya da Git deposunda değil. Ortam değişkeni olarak sakla ve ClipOnIt'i arka ucundan çağır.
- Kullanım başına bir anahtar, kapsamıyla.Kapsam « okuma » (inceleme, doğrulama) ya da « üretim » (video oluşturma). Her anahtarın bir adı, son kullanım tarihi var ve tek tıkla iptal edilebilir: iptal edilince bir sonraki çağrıda 401 yanıtı verir.
- Sır yalnızca bir kez gösterilir.ClipOnIt yalnızca parmak izini (SHA-256) saklar. Kaybolursa anahtar yenilenir, geri alınamaz.
- İmzalı webhook'lar.Her gönderim X-ClipOnIt-Signature başlığını taşır (gövde ve zaman damgasının HMAC-SHA256'sı); 5 dakikadan eski gönderimleri reddet. Alıcı URL'leri https olmalı ve her gönderimde doğrulanır.
- Avrupa Birliği'nde barındırılır.Hetzner sunucuları AB'de; alt işleyiciler gizlilik politikasında listelenir.
Sıkça sorulan sorular
SDK, widget, süreler, kotalar ve hacim.
API için hangi plan gerekli?
Başlamak için ücretsiz plan yeter: anahtar oluşturulur ve MCP sunucusu yanıt verir; ayda 3 Explainer videosu, filigranlı, 8 ücretsiz stille. Ücretli planlar daha fazla video ekler (ayda 15, 30 veya 100), filigransız, 24 stil, mikrofon sesin ve Yapay Zeka Yönetmeni ile. API kotaları, arayüzdekiler gibi hesabınıza aittir.
SDK var mı?
Henüz resmi bir SDK yok. API, HTTP ve JSON üzerinden çalışır ve OpenAPI 3.1 ile tanımlanmıştır (/openapi.json): bu sayfadaki örnekler birkaç satır fetch ya da standart Python ile yazılır; OpenAPI dosyasından bir istemci de üretebilirsin.
ClipOnIt oynatıcısını ya da editörünü sitene gömebilir miyim?
Hayır, gömülebilir bir widget yok. MP4 dosyasını alır ve kendi oynatıcında gösterir ya da kendi sunucunda barındırırsın.
Bir video ne kadar sürer?
Bir açıklayıcı video: birkaç dakika (yazım, ardından render; render için yaklaşık 4 dk). Klipler: 20 dakikalık video için yaklaşık 1 ile 5 dakika, ardından her klibin dışa aktarımı. API adımı, yüzdeyi ve kalan süre tahminini döndürür.
Bir kota dolduğunda ne olur?
API, 402 ile yanıt verir: açık bir mesaj (aylık kota ya da YZ bütçesi), 403 işlev planda yoksa, 429 iki Explainer üretimi zaten çalışıyorsa. Explainer için « dry_run »: true, başlatmadan önce her şeyi kontrol eder; hiçbir şey oluşturmaz ve ücretlendirmez.
ClipOnIt'i tüm kullanıcılarım için bağlamak istiyorum.
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.
Bugün API ile ilk videon
Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.