Neben dem Starten von Aufträgen bietet die Medienverarbeitung ein paar Endpunkte, mit denen deine Anwendung den Überblick behält: Monatszahlen abrufen, Aufträge zu einer eigenen Kennung wiederfinden, einen Auftrag abbrechen und prüfen, ob die Medienverarbeitung gerade normal läuft.
Verbrauch eines Zeitraums abfragen
GET /v1/media/usage liefert die Zahlen deines Teams für einen Zeitraum. Ohne Angaben gilt der laufende Monat bis heute. Mit from und to im Format JJJJ-MM-TT wählst du einen eigenen Zeitraum, beide Tage zählen mit.
curl "https://api.flowdata.one/v1/media/usage?from=2026-10-01&to=2026-10-31" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
{
"from": "2026-10-01",
"to": "2026-10-31",
"jobs": 148,
"failed": 3,
"processing_seconds": 9412.6,
"input_bytes": 31845120384,
"by_pipeline": {"chat_video": 92, "chat_image": 41, "course_video": 15}
}
Die Zahlen im Beispiel sind erfunden.
- jobs: Anzahl der Aufträge, die im Zeitraum angelegt wurden.
- failed: davon fehlgeschlagen.
- processing_seconds: gesamte Rechenzeit in Sekunden.
- input_bytes: Größe aller Eingabedateien zusammen in Byte.
- by_pipeline: Anzahl der Aufträge je Pipeline.
Die Zahlen beschreiben Aufträge, keine Beträge. Was dich die Aufträge gekostet haben, siehst du in FlowData unter Abrechnung, siehe Wie funktioniert die Abrechnung in FlowData?.
Liegt from nach to oder stimmt das Datumsformat nicht, kommt HTTP 422 mit dem Code validation_failed zurück.
Aufträge zu deiner Kennung finden
Gibst du beim Start eines Auftrags eine reference mit, etwa eine Bestell- oder Produktnummer, findest du alle Aufträge dazu wieder:
curl "https://api.flowdata.one/v1/media/jobs?reference=order:4711" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
Die Antwort enthält unter data die bis zu 20 neuesten Aufträge mit genau dieser Kennung, der neueste zuerst. Jeder Eintrag hat dieselbe Form wie bei GET /v1/media/jobs/{id}. Ohne reference oder mit mehr als 191 Zeichen antwortet die API mit HTTP 422. Eine Liste aller Aufträge ohne Kennung gibt es per API nicht, die findest du in FlowData unter Aufträge. Dort kannst du auch nach deiner Kennung suchen.
Einen Auftrag abfragen oder abbrechen
GET /v1/media/jobs/{id}liefert einen Auftrag deines Teams. Aufträge anderer Teams und unbekannte Kennungen beantwortet die API mit HTTP 404.DELETE /v1/media/jobs/{id}bricht einen wartenden Auftrag sofort ab und fordert bei einem laufenden den Abbruch an. Die Antwort ist der Auftrag mit seinem neuen Stand.
Was beim Abbrechen genau passiert, steht in Wie verfolge ich den Status meiner Medienaufträge?.
Prüfen, ob die Medienverarbeitung läuft
GET /v1/media/health braucht keinen Schlüssel. Du kannst ihn zum Beispiel in dein Monitoring einbinden:
curl "https://api.flowdata.one/v1/media/health"
{"status":"ok","queue":{"pending":2,"processing":1},"version":"1.0.0"}
- status:
ok, wenn alles normal läuft.degradedheißt, die Medienverarbeitung ist eingeschränkt, etwa während einer angekündigten Wartung oder wenn die Bildverarbeitung gerade nicht zur Verfügung steht. Beidownwerden gerade keine Aufträge verarbeitet. - queue.pending, queue.processing: wartende und laufende Aufträge auf der ganzen Plattform, nicht nur in deinem Team. Eine lange Warteschlange erklärt, warum ein Auftrag später startet.
- version: die Version der Medienverarbeitung.
Gut zu wissen
- Die Endpunkte mit Schlüssel zählen wie alle Anfragen der Medienverarbeitung zu deren Anfragelimit von 600 Anfragen pro Minute je Schlüssel. Frag den Stand eines Auftrags deshalb nicht im Sekundentakt ab. Bequemer sind Webhooks, die sich von selbst melden, siehe Wie richte ich Webhooks für die Medienverarbeitung ein?.
- Alle Fehler der Medienverarbeitung haben die Form
{"error":{"code":"...","message":"...","details":{...},"type":"..."}}.