FlowData

Wie starte ich einen Medienauftrag?

Veröffentlicht am 05. November 2026

Mit der Medienverarbeitung von FlowData verkleinerst und komprimierst du Videos, Bilder und Audio, blendest dein Logo ein oder erzeugst Vorschaubilder. Du schickst dafür einen Auftrag an die API, FlowData verarbeitet ihn im Hintergrund und legt die Ergebnisse dort ab, wo du es angibst. Dieser Artikel zeigt dir den Ablauf mit einem kleinen Beispiel.

Was du vorher brauchst

In FlowData findest du links unter Medienverarbeitung die Aufträge, deine Presets, die Wasserzeichen und die Webhooks.

Einen Auftrag anlegen

Ein Auftrag besteht aus einer Pipeline (was gemacht wird), einer Eingabe und den gewünschten Ausgaben. Dieses Beispiel macht aus einem großen Produktfoto ein Vorschaubild und lässt das Ergebnis bei uns speichern:

curl -X POST "https://api.flowdata.one/v1/media/jobs" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4712-v1" \
  -d '{
    "pipeline": "chat_image",
    "reference": "order:4712",
    "input": { "url": "https://files.example.com/products/4712.png" },
    "outputs": { "preview": { "managed": true } }
  }'

Die API antwortet mit HTTP 202 und dem Auftrag im Status queued. Merke dir die id aus der Antwort, damit fragst du den Auftrag später mit GET https://api.flowdata.one/v1/media/jobs/{id} ab.

Die wichtigsten Felder:

  • pipeline oder preset: genau eines von beiden. Statt einer System-Pipeline kannst du ein eigenes Preset angeben, siehe Wie lege ich Presets für die Medienverarbeitung an?.
  • reference (optional): deine eigene Kennung mit höchstens 191 Zeichen, zum Beispiel eine Bestellnummer. Danach kannst du in der Auftragsliste suchen.
  • input.url oder input.upload_id: die Quelle. Die URL muss mit https:// beginnen und öffentlich erreichbar sein.
  • outputs: je Ausgabe entweder "managed": true (wir speichern die Datei sieben Tage) oder eine put_url, an die FlowData das Ergebnis direkt in deinen eigenen Speicher hochlädt. Höchstens zehn Ausgaben je Auftrag.
  • priority (optional): high, normal oder low.
  • callback (optional): endpoint_id eines Webhook-Endpunkts oder eine freie url. Dann meldet sich FlowData, sobald der Auftrag fertig oder fehlgeschlagen ist, siehe Wie richte ich Webhooks für die Medienverarbeitung ein?.
  • metadata (optional): beliebiges JSON bis 4 KB, das unverändert in der Rückmeldung zurückkommt.
  • Idempotency-Key (Header, empfohlen): Schickst du denselben Auftrag innerhalb von 24 Stunden mit demselben Key noch einmal, bekommst du den ursprünglichen Auftrag mit HTTP 200 zurück statt eines doppelten. Derselbe Key mit anderem Inhalt ergibt 409 idempotency_conflict.

Alle Felder stehen in der API-Dokumentation zur Medienverarbeitung.

Die System-Pipelines

Pipeline Wofür Ausgaben
ugc_video Hochkant-Video mit oder ohne Wasserzeichen plus Vorschaubild watermarked, clean, thumbnail. Mindestens watermarked oder clean.
ugc_image Bild mit oder ohne Wasserzeichen watermarked, clean. Mindestens eine von beiden.
video_thumbnail Vorschaubild aus einem Video thumbnail
chat_image verkleinertes Vorschaubild als WebP preview
chat_video komprimiertes Video plus Posterbild video (Pflicht), poster
course_video lange Kursvideos verkleinern video
audio_extract Tonspur als MP3 herauslösen audio
video, image frei benennbare Ausgaben für eigene Kombinationen beliebig

Die genauen Standardwerte jeder Pipeline siehst du in FlowData unter Presets bei den System-Presets. Ausgaben mit Wasserzeichen brauchen immer ein eigenes Logo, siehe Wie lade ich ein Wasserzeichen für die Medienverarbeitung hoch?.

Eigene Dateien direkt hochladen

Liegt deine Datei nicht öffentlich im Netz, holst du dir mit POST /v1/media/uploads eine Upload-Adresse und übergibst im Auftrag statt der URL die upload_id. Wie das geht, steht in Wie lade ich eine eigene Datei direkt für die Medienverarbeitung hoch?.

Grenzen

  • Videos bis 2 GB und 10 Minuten, Kursvideos und Audio bis 5 GB und 3 Stunden
  • Videos bis 8.192 Pixel je Seite
  • Bilder bis 50 MB und 16.000 × 16.000 Pixel
  • 60 neue Aufträge pro Minute je Schlüssel, 600 weitere Anfragen pro Minute je Schlüssel
  • höchstens 200 wartende Aufträge je Team

Was kostet ein Auftrag?

Berechnet werden nur Ausgaben, die tatsächlich erzeugt und hochgeladen wurden: Video und Audio je angefangener Minute der Ausgabe, Bilder, Vorschaubilder und Poster je Ausgabe. Bei Videos richtet sich die Preisstufe nach der kürzeren Seite der Ausgabe. Beim Anlegen reserviert FlowData eine Schätzung, am Ende wird der tatsächliche Betrag abgerechnet. Mehr dazu steht in Warum ist Guthaben reserviert und wie setzen sich die Kosten eines Medienauftrags zusammen?, die Beträge auf der Preisseite.

Wenn etwas nicht klappt

  • 422 validation_failed: Ein Feld fehlt oder ist ungültig. Das Feld steht in details.field.
  • 413 input_too_large: Die angegebene Größe liegt über dem Limit der Pipeline.
  • 429 insufficient_quota: Das Guthaben, der Kreditrahmen oder das Monatslimit reicht nicht.
  • 429 spend_limit_exceeded: Das Ausgabenlimit des Schlüssels oder des Teams ist erreicht.
  • 429 rate_limited: Zu viele Anfragen pro Minute oder die Warteschlange deines Teams ist voll. Der Header Retry-After nennt dir die Wartezeit.
  • 429 upload_quota_exceeded: Es gibt schon zu viele offene Direkt-Uploads.

Wie es nach dem Anlegen weitergeht, liest du in Wie verfolge ich den Status meiner Medienaufträge?.

War dieser Artikel hilfreich?

Zurück zu Medienverarbeitung