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/produce

  • MCP

    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.

  1. Görevi oluştur

    Video konusu veya bağlantısıyla bir POST isteği. Hemen bir kimlikle yanıt verilir.

  2. 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.

  3. 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"

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 ile video üret: araçlar, örnekler, kotalar

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

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

ÜcretsizStarterProBusiness
API ve MCP—✓✓✓
Ayda Explainer videoları—1530100
Aynı anda Explainer üretimleri—222
Hesap başına API anahtarları—101010
Hesap başına webhook'lar—333

Güvenlik

ClipOnIt'i sunucundan çağır, asla kullanıcılarının tarayıcısından değil.

Gizlilik politikası
  • 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.

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