Jeder Medienauftrag läuft im Hintergrund durch mehrere Schritte. In FlowData siehst du jederzeit, wo ein Auftrag steht, welche Ausgaben schon fertig sind und warum ein Auftrag gegebenenfalls fehlgeschlagen ist. Die Detailansicht aktualisiert sich bei laufenden Aufträgen von selbst.
Die Auftragsliste
Öffne links unter Medienverarbeitung den Punkt Aufträge. Die Liste Medienaufträge zeigt alle Aufträge deines Teams mit Pipeline, Status, Zeitpunkt der Anlage und Rechenzeit. Unter der Referenz steht jeweils die Auftrags-ID.

So findest du einen bestimmten Auftrag:
- Gib im Suchfeld deine Referenz oder die Auftrags-ID ein.
- Filtere über Alle Status oder Alle Pipelines.
- Grenze über Angelegt ab und Angelegt bis den Zeitraum ein.
- Filter zurücksetzen zeigt wieder alle Aufträge.
Mit dem Augen-Symbol rechts öffnest du die Details.
Die Status im Überblick
| Status | Wert in der API | Bedeutung |
|---|---|---|
| In Warteschlange | queued |
Der Auftrag ist angenommen und wartet auf einen freien Platz. |
| Lädt herunter | downloading |
FlowData holt die Eingabedatei. |
| In Bearbeitung | processing |
Die Datei wird umgerechnet. |
| Lädt hoch | uploading |
Die Ergebnisse werden an ihr Ziel übertragen. |
| Fertig | finished |
Alle Ausgaben sind erzeugt und hochgeladen. |
| Fehlgeschlagen | failed |
Der Auftrag wurde mit einem Fehler beendet. |
| Abgebrochen | cancelled |
Der Auftrag wurde abgebrochen, bevor er gestartet ist. |
Kursvideos und Tonspuren laufen in einer eigenen, langen Warteschlange. Dort kann In Warteschlange auch einmal länger dauern.
Die Detailansicht
Oben stehen Referenz, Status und Auftrags-ID. Darunter findest du:
- Überblick: Pipeline, Team-Preset, Priorität, Quelle, Wasserzeichen, wohin die Rückmeldung geht, die Rechenzeit und deine Metadaten
- Eingabe: Größe, Dateityp, Abmessungen, Dauer, Codec und ob eine Tonspur vorhanden ist. HDR-Videos rechnet FlowData automatisch auf normale Farben (SDR) um.
- Verlauf: wann der Auftrag angelegt, gestartet und beendet wurde
- Ausgaben: jede Ausgabe mit Status (Ausstehend, Hochgeladen oder Fehlgeschlagen), Größe und Abmessungen
- Webhook-Zustellungen: die Rückmeldungen an deinen Server
Fehler verstehen
Bei einem fehlgeschlagenen Auftrag steht oben ein roter Kasten Fehler mit dem Fehlercode, einer Erklärung, der Phase, in der es passiert ist, und dem Hinweis erneuter Versuch sinnvoll oder erneuter Versuch nicht sinnvoll.
| Code | Bedeutung | Was du tun kannst |
|---|---|---|
input_not_found |
Die Eingabedatei ist abgelaufen, gelöscht oder gesperrt. | Neuen Link erzeugen und neuen Auftrag anlegen. |
input_download_failed |
Die Datei ließ sich vorübergehend nicht laden. | Erneut versuchen. |
input_too_large |
Größe, Dauer oder Abmessungen liegen über dem Limit. | Datei verkleinern oder eine Pipeline für lange Videos wählen. |
input_unreadable |
Die Datei ist beschädigt oder wird nicht unterstützt. | Datei prüfen oder neu exportieren. |
input_no_video_stream, input_no_audio_stream |
Die erwartete Spur fehlt. | Passende Datei oder Pipeline verwenden. |
processing_failed |
Umrechnung oder Qualitätsprüfung ist fehlgeschlagen. | Datei prüfen, bei Bedarf den Support fragen. |
output_upload_failed |
Das Ergebnis ließ sich nicht an deine Upload-Adresse übertragen. | Erneut versuchen, Speicher prüfen. |
output_url_expired |
Deine put_url ist abgelaufen oder wurde abgelehnt. |
Länger gültige Adresse verwenden. |
timeout |
Die maximale Verarbeitungszeit wurde überschritten. | Erneut versuchen, bei sehr großen Dateien eine Pipeline für lange Videos wählen. |
insufficient_quota, spend_limit_exceeded |
Guthaben, Kreditrahmen oder ein Ausgabenlimit hat für die tatsächliche Länge nicht gereicht. | Guthaben aufladen oder Limit anpassen. |
forbidden |
Der Schlüssel wurde während der Verarbeitung deaktiviert. | Gültigen Schlüssel verwenden. |
cancelled |
Der Auftrag wurde während der Verarbeitung abgebrochen. | Bei Bedarf neu anlegen. |
internal_error |
Ein Fehler auf unserer Seite. | Erneut versuchen. |
Einen fehlgeschlagenen Auftrag kannst du nicht neu starten. Lege stattdessen einen neuen Auftrag an, und nimm dafür einen neuen Idempotency-Key. Mit dem alten bekommst du innerhalb von 24 Stunden nur den fehlgeschlagenen Auftrag zurück.
Ausgaben, die schon hochgeladen waren, bleiben erhalten und werden berechnet, auch wenn der Auftrag insgesamt fehlgeschlagen ist.
Einen Auftrag abbrechen
Solange ein Auftrag nicht abgeschlossen ist, siehst du oben rechts Auftrag abbrechen. Ein wartender Auftrag wird sofort beendet, das reservierte Guthaben wird freigegeben, und es gibt keine Rückmeldung an deinen Server. Ein laufender Auftrag stoppt innerhalb weniger Sekunden, steht danach auf Fehlgeschlagen mit dem Code cancelled und meldet job.failed.
Über die API geht das mit DELETE https://api.flowdata.one/v1/media/jobs/{id}. Ein bereits beendeter Auftrag lässt sich nicht mehr abbrechen, die API antwortet dann mit 409 conflict.
Gut zu wissen
- Auftragsdaten werden 90 Tage aufbewahrt, bei uns gespeicherte Ausgaben 7 Tage. Wie du sie herunterlädst, steht in Wie lade ich die Ergebnisse eines Medienauftrags herunter?.
- Ist eine Webhook-Zustellung fehlgeschlagen, siehst du in der Zeile den HTTP-Status und den Nächster Versuch. Mit dem Pfeil-Symbol Erneut senden stößt du die Zustellung von Hand neu an.