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
- einen FlowData-Schlüssel (
fd_…), siehe Wie lege ich einen FlowData-API-Schlüssel an? - genug Guthaben oder einen Kreditrahmen, siehe Wie funktioniert die Abrechnung in FlowData?
- die Eingabedatei unter einer öffentlich erreichbaren
https-Adresse oder als Direkt-Upload
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:
pipelineoderpreset: 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.urloderinput.upload_id: die Quelle. Die URL muss mithttps://beginnen und öffentlich erreichbar sein.outputs: je Ausgabe entweder"managed": true(wir speichern die Datei sieben Tage) oder eineput_url, an die FlowData das Ergebnis direkt in deinen eigenen Speicher hochlädt. Höchstens zehn Ausgaben je Auftrag.priority(optional):high,normaloderlow.callback(optional):endpoint_ideines Webhook-Endpunkts oder eine freieurl. 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 ergibt409 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 indetails.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 HeaderRetry-Afternennt 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?.