API-Dokumentation
v1Vollständige Referenz der SnipKit Video Orchestration API. Ein API-Call — fertig gebrandetes MP4.
https://api.snipkit.euInteraktive API-Referenz (Swagger)Einführung
SnipKit ist eine DSGVO-konforme Video Orchestration API für den DACH-Markt. Du schickst ein kreatives Briefing per JSON-Request — SnipKit generiert vollautomatisch ein geschnittenes, gebrandetes MP4: KI-Storyboard, Video-Generierung, Text-to-Speech und FFmpeg-Compositing. Alle Daten bleiben in der EU.
Async by Default
Jede Anfrage gibt sofort eine job_id zurück. Kein Timeout-Risiko.
BYOK
Verwende deine eigenen Provider-Keys. Volle Kostenkontrolle.
DSGVO
100% EU-Datenhaltung. Frankfurt. Kein Transfer in Drittländer.
Schnellstart
In zwei Schritten zum fertigen Video:
# 1. Video erstellencurl -X POST https://api.snipkit.eu/v1/videos \-H "Authorization: Bearer sk_live_dein_key" \-H "Content-Type: application/json" \-d '{"briefing": "30s Instagram Reel ueber Coaching","template": "social_reel_9x16","byok": {"video_provider": "veo","video_api_key": "dein_veo_key"}}'# Antwort: 202 Accepted# { "job_id": "vid_abc123", "status": "queued" }# 2. Status abfragen (pollen bis status = "completed")curl https://api.snipkit.eu/v1/videos/vid_abc123 \-H "Authorization: Bearer sk_live_dein_key"# Antwort wenn fertig:# { "job_id": "vid_abc123", "status": "completed", "url": "https://..." }
Alternativ: Konfiguriere einen Webhook, um bei Fertigstellung benachrichtigt zu werden — kein Polling nötig. Siehe Sektion .
Authentifizierung
Alle API-Requests benötigen einen API-Key im Authorization-Header.
curl https://api.snipkit.eu/v1/account/credits \-H "Authorization: Bearer sk_live_dein_key"
Key-Formate
| Präfix | Umgebung | Hinweis |
|---|---|---|
| sk_live_xxx | Produktion | Credits werden verbraucht |
| sk_test_xxx | Sandbox | Kostenlos, 5 Credits, kein echtes Video |
API-Keys erstellst du im Dashboard.
Auth-Fehler
Endpoints
Klicke auf einen Endpoint, um Parameter, Request-Body und Response-Beispiel anzuzeigen.
Templates
Templates definieren Format, Dauer und Schnitt-Stil des generierten Videos.
| Template-ID | Format | Max. Dauer | Use Case |
|---|---|---|---|
| social_reel_9x16 | 9:16 | 60s | Instagram Reels, TikTok |
| social_post_1x1 | 1:1 | 60s | Instagram Feed, Facebook |
| linkedin_video_16x9 | 16:9 | 120s | LinkedIn, Unternehmenskommunikation |
| product_demo_16x9 | 16:9 | 180s | Produktvorstellungen, Landing Pages |
| youtube_short_9x16 | 9:16 | 60s | YouTube Shorts |
Repurposing-Pattern — ein Briefing, N Plattformen
SnipKit hat keinen dedizierten Repurpose-Endpoint — und das ist Absicht. Repurposing entsteht durch mehrere parallele POST /v1/videos-Calls, die sich dasselbe Briefing und dieselbe brand_profile_id teilen, aber unterschiedliche template- und aspect_ratio-Werte verwenden.
Damit liegt die Fan-out-Logik in deiner Pipeline — kein magischer Endpoint, kein impliziter State auf SnipKit-Seite. Du entscheidest, welche Plattformen ausgespielt werden, in welcher Reihenfolge, mit welchen Variationen.
Minimales Repurpose-Beispiel (curl)
# Drei Plattform-Variants aus einem Briefing — parallel.BRIEF='Q2-Recap: drei lessons learned aus der API-Migration.'BRAND='bp_acme_main'for TPL in social_reel_9x16 linkedin_video_16x9 youtube_short_9x16; docurl -X POST https://api.snipkit.eu/v1/videos \-H "Authorization: Bearer sk_live_..." \-H "Content-Type: application/json" \-d "{\"briefing\": \"$BRIEF\",\"brand_profile_id\": \"$BRAND\",\"template\": \"$TPL\",\"webhook_url\": \"