Unsere Pipeline.
Dein Produkt.

Aus einem langen Video werden fertige Shorts — geschnitten, untertitelt, im richtigen Format. Dieselbe Pipeline wie im Studio, angesteuert aus deinem Code: Job anlegen, Status abfragen, Clips laden.

API-Key im Account erstellen Zur Referenz ↓

In vier Schritten zum Clip.

Key erstellen

Im Account unter „API-Keys“ einen Key anlegen (kostenloses Konto reicht). Er wird genau einmal angezeigt — sicher speichern und wie ein Passwort behandeln.

Job anlegen

Eine Video-URL (YouTube, Twitch-VOD oder Kick-VOD) per POST einreichen. Die Antwort enthält die Job-ID; die benötigten Credits werden reserviert und erst bei Erfolg abgebucht.

curl -X POST https://www.lucflow.de/api/v1/jobs \
  -H "Authorization: Bearer lf_DEIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_url": "https://www.youtube.com/watch?v=…",
       "options": {"format": "9:16", "content_type": "gaming"}}'

# → {"id": "…", "status": "queued", "reserved_credits": 42, …}

Status abfragen

Ein Job braucht einige Minuten (abhängig von Videolänge und Warteschlange). Den Status pollen — z. B. alle 30 Sekunden — bis er auf done steht.

curl https://www.lucflow.de/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer lf_DEIN_KEY"

# → {"status": "processing", "progress": 55, …}

Clips laden

Bei done liefert dieselbe Abfrage die Clip-Liste mit Titel, Länge, Viral-Score und Download-URL pro Clip. Die Dateien bleiben je nach Plan 14–30 Tage verfügbar.

# Sobald status = "done":
# {"clips": [{"id": "clip_1", "title": "…", "score": 87,
#             "download_url": "https://www.lucflow.de/api/v1/jobs/…/download"}]}

curl -OJ CLIP_DOWNLOAD_URL -H "Authorization: Bearer lf_DEIN_KEY"

Referenz.

Basis-URL https://www.lucflow.de/api/v1 — alle Endpunkte erwarten den Key als Authorization: Bearer lf_… und antworten mit JSON.

POST /jobs

Clipping-Job anlegen. Pflichtfeld source_url; optional options mit format (9:16 · 1:1 · 16:9), language (de · en · auto), content_type (gaming · podcast · reallife), clip_mode (basic · anything), clip_length (auto · short · medium · long · xl) und facecam (auto · yes · no).

GET /jobs

Die letzten 20 eigenen Jobs mit Status und Clip-Anzahl.

GET /jobs/{id}

Status, Fortschritt und — sobald done — die Clip-Liste inkl. Download-URLs.

GET /jobs/{id}/clips/{clipId}/download

Clip-Datei (MP4) als Download-Stream.

GET /me

Key-Check: aktuelles Credit-Guthaben und Plan.

Credits & Limits.

1 Credit = 1 Minute Quellvideo — dasselbe Modell wie im Studio, ein gemeinsames Guthaben für beides.
Beim Anlegen werden die Credits nur reserviert; abgebucht wird erst, wenn der Job erfolgreich fertig ist. Schlägt er fehl, wird die Reservierung freigegeben.
Höchstens 3 gleichzeitig laufende Jobs pro Konto (Studio + API zusammen) und 10 Job-Anfragen pro Minute und Key.
Im Free-Plan tragen Clips das LucFlow-Badge — wie im Studio.
Quellen: öffentliche YouTube-Videos, Twitch-VODs, Kick-VODs sowie direkte .mp4/.mov-Datei-URLs. Laufende Livestreams werden abgelehnt — erst nach Stream-Ende clippen.

Fehlercodes.

Fehler kommen als { "error": { "code", "message" } } mit passendem HTTP-Status:

unauthorizedKey fehlt, ist ungültig oder widerrufen (401).

unsupported_sourceURL liegt auf keiner unterstützten Plattform (400).

live_url_unsupportedKanal-Link oder noch laufender Stream (400).

insufficient_creditsGuthaben reicht für die Videolänge nicht (402).

too_many_jobsSchon 3 Jobs in Arbeit — warten, bis einer fertig ist (429).

rate_limitedZu viele Anfragen — kurz warten und erneut versuchen (429).

Die API ist neu (Beta): Das Antwortformat kann sich in Details noch ändern, bestehende Felder bleiben aber stabil. Fragen oder Wünsche? Melde dich über den Discord-Support unten rechts.

Unsere Pipeline.Dein Produkt.