Medienverarbeitung
Video, Audio und Bilder per API verarbeiten
Du nennst eine Quelle und eine Pipeline, FlowData erzeugt die Ausgaben und meldet sich, wenn sie fertig sind. Abgerechnet wird je angefangener Ausgabeminute, Bilder je Datei.
Nur für Unternehmen und Selbstständige
- Video SD 0,008 EUR je angefangene Ausgabeminute
- Video HD 0,014 EUR je angefangene Ausgabeminute
- Video 4K 0,03 EUR je angefangene Ausgabeminute
- Audio 0,004 EUR je angefangene Ausgabeminute
- Bild 0,001 EUR je Ausgabedatei
/v1/media/jobs
curl -X POST "https://api.flowdata.one/v1/media/jobs" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{
"pipeline": "ugc_video",
"input": {
"url": "https://files.example.com/in.mov"
},
"outputs": {
"clean": {
"managed": true
}
},
"reference": "order-4711"
}'
{
"id": "01J8Z6Q4T0M3S1V7B2X9K5N4RD",
"status": "queued",
"pipeline": "ugc_video",
"preset": null,
"reference": "order-4711",
"priority": "normal",
"created_at": "2026-11-09T10:00:00Z",
"started_at": null,
"finished_at": null,
"input": {
"size": null,
"duration": null,
"width": null,
"height": null,
"video_codec": null,
"has_audio": null
},
"outputs": {
"clean": {
"status": "pending",
"target": "managed",
"size": null,
"width": null,
"height": null,
"duration": null,
"sha256": null,
"download_url": null,
"expires_at": null
}
},
"options": {},
"error": null,
"processing_seconds": null,
"cancel_requested": false,
"queue_position": 1
}
Felder und Aufbau wie in der API, die Werte sind Beispiele.
Endpunkte
POST /v1/media/jobs antwortet sofort mit 202 und einer ID. Den Stand holst du mit GET /v1/media/jobs/{id} oder lässt ihn dir per Webhook schicken.
| POST | /v1/media/jobs |
Auftrag anlegen: Pipeline oder Preset, Quelle und Ausgaben. |
|---|---|---|
| GET | /v1/media/jobs/{id} |
Status, Fortschritt und Ausgaben eines Auftrags, fertige Ausgaben mit download_url. |
| GET | /v1/media/jobs |
Aufträge mit deiner eigenen Kennung suchen (?reference=). |
| DELETE | /v1/media/jobs/{id} |
Einen wartenden Auftrag abbrechen oder den Abbruch eines laufenden anfordern. |
| POST | /v1/media/uploads |
Eine signierte Adresse für den Direkt-Upload einer Quelldatei. |
| GET | /v1/media/usage |
Auftragszahlen und Datenmengen in einem Zeitraum. |
Pipelines
Jede Pipeline hat feste Ausgaben und Grenzen, eigene Pipelines legst du als Team-Presets an.
-
Video
ugc_video,chat_videoundvideobis 2 GB und 10 Minuten,course_videobis 5 GB und 3 Stunden. -
Bild
ugc_image,chat_imageundimageskalieren, schneiden zu und versehen Bilder bis 50 MB auf Wunsch mit Wasserzeichen. -
Vorschaubilder und Audio
video_thumbnailerzeugt ein Vorschaubild,audio_extractzieht die Tonspur. -
Presets und Wasserzeichen
Eigene Presets über
POST /v1/media/presets, Wasserzeichen als Team-Asset überPUT /v1/media/assets/{key}.
Wo die Ergebnisse landen
-
Bei FlowData
Mit
managed: trueliegt die Ausgabe 7 Tage bereit, der Auftrag nennt einen signiertendownload_url. -
Bei dir
Mit
put_urllädt FlowData die Ausgabe direkt in deinen eigenen Speicher hoch. -
Quelle
Eine öffentliche
https-Adresse oder ein signierter Direkt-Upload überPOST /v1/media/uploads, gültig 24 Stunden.
Für den Betrieb gebaut
-
Webhooks
Ereignisse wie
job.finishedundjob.failedgehen an registrierte Endpunkte, signiert nach Standard Webhooks und bis zu 7 Mal wiederholt. -
Idempotenz
Mit dem Header
Idempotency-Keylegt ein Wiederholen innerhalb von 24 Stunden keinen zweiten Auftrag an. -
Kostenreservierung
Beim Anlegen wird der voraussichtliche Höchstbetrag reserviert, berechnet wird nach Abschluss nur, was geliefert wurde.
Screenshots zeigen die FlowData-Oberfläche mit den Beispieldaten einer fiktiven Firma.
Grenzen der Verarbeitung
Deine Dateien verarbeiten wir auf unseren eigenen Servern mit ffmpeg und ImageMagick und speichern sie in unserem Objektspeicher. An externe Dienste gehen sie nicht.
Je Schlüssel bis zu 60 neue Aufträge und 600 sonstige Anfragen pro Minute, höchstens 200 wartende Aufträge je Team.
Auftragsdaten bleiben 90 Tage erhalten, Ausgaben bei FlowData 7 Tage. Danach sind sie gelöscht.
Beim Anlegen reserviert FlowData den voraussichtlichen Höchstbetrag. Reicht das Guthaben dafür nicht, wird der Auftrag abgelehnt.
Häufige Fragen
put_url je Ausgabe lädt FlowData direkt dorthin hoch.
GET /v1/media/jobs/{id} ab oder hinterlegst einen Webhook-Endpunkt.