· reAPI Team
fal-API-Status: COMPLETED, aber kein Ergebnis
Verstehe den fal-API-Status, wenn COMPLETED kein Ergebnis liefert. Prüfe Ergebnisantworten, Fehler, Ausgabefelder und Webhooks, bevor du eine Generierungsanfrage wiederholst.

Bei COMPLETED solltest du nicht aufhören zu lesen. In der Queue-API von fal bedeutet der Status, dass die Anfrage beendet ist, einschließlich fehlgeschlagener oder abgebrochener Anfragen. Er sagt nicht aus, dass ein verwendbares Bild oder Video erzeugt wurde.[1]
Der nächste Aufruf geht an den Ergebnis-Endpunkt der ursprünglichen Anfrage. Diese Antwort enthält den HTTP-Status und den Antworttext des Modells.[2] Wenn deine App die Fortschrittsanzeige grün färbt, aber keine Datei findet, gehe diesem Ergebnis nach, bevor du eine weitere Generierung absendest. Möglicherweise fehlt ein Abrufschritt, du liest das falsche JSON-Objekt oder es liegt ein tatsächlicher Modellfehler vor.
Der Status zeigt dir, wann du das Ergebnis abrufen solltest
Der Queue-Status von fal durchläuft IN_QUEUE, IN_PROGRESS und COMPLETED. Sobald er COMPLETED erreicht, lies das Ergebnis. Felder wie metrics.inference_time und alle verfügbaren Fehlerinformationen liefern nützlichen Kontext, ersetzen aber nicht die Modellantwort.[1]
Diese Trennung ist auch in fals eigenen API-Beispielen sichtbar: Anfrage absenden, ihren Status abrufen, dann ihr Ergebnis holen und das Output Schema des Modells nachschlagen. fal.queue.status() und fal.queue.result() im JavaScript-Client führen unterschiedliche Operationen aus. In Python folgt auf den abgeschlossenen Status handler.get().[3][4]
Sieh dir die Variable an, die deine Anwendung an die Bildkomponente übergibt. Enthält sie den Queue-Status, hast du das benötigte Objekt noch nicht erreicht. Rufe zuerst das Ergebnis ab. Enthält sie den Ergebnis-Wrapper des JavaScript-SDK, lies dessen Eigenschaft data, bevor du das Ausgabeschema des Modells anwendest.[3] images durch Ausprobieren in image zu ändern, ist weniger hilfreich, als zu prüfen, welche Antwort tatsächlich vorliegt.
Hier ist die Aufrufmethode entscheidend. subscribe() übernimmt das Absenden und Warten in der Queue, während submit() die Kontrolle zurückgibt, damit deine Anwendung den Lebenszyklus verwalten kann. Ein direkter Aufruf mit run() verwendet die Queue nicht.[4] Ein Beispiel für eine bestimmte Methode kann deshalb einen Warte- oder Entpackschritt enthalten, den dein Code noch benötigt oder bereits ausgeführt hat.
Verwende die URLs aus der ursprünglichen Übermittlung
Speichere request_id, status_url und response_url, wenn die Übermittlung erfolgreich ist. fals Queue-Leitfaden empfiehlt, die zurückgegebenen URLs zu verwenden. Falls du Abfrage-URLs selbst zusammenstellst, unterscheidet der Leitfaden zwischen dem owner/app-Pfad und dem vollständigen Modell-Endpunktpfad zum Absenden der Arbeit.[3] Wenn du jedes Modellsuffix an eine Anfrage-Statusroute anhängst, kann die Abfrage am falschen Ort landen.
Bei einem Worker, der neu starten könnte, speichere diese Werte außerhalb des Prozesses, bevor du wartest. Dein lokaler Job kann dann dieselbe Anfrage weiter abfragen. Das ist eine Empfehlung für das Anwendungsdesign: Eine Wiederholungsschaltfläche sollte die ursprüngliche Übermittlung nicht rekonstruieren müssen, nur um festzustellen, ob deren Ergebnis existiert.
Das folgende JavaScript liest eine gespeicherte Anfrage von deinem Server. Die URLs müssen aus der vertrauenswürdigen fal-Übermittlungsantwort dieses Servers stammen, nicht aus beliebigen Browsereingaben: Die Anfrage hängt deine API-Zugangsdaten an.
async function inspectFalRequest(saved, key) {
async function read(url) {
const response = await fetch(url, {
headers: { Authorization: `Key ${key}` },
redirect: "error",
});
const raw = await response.text();
let body;
try {
body = JSON.parse(raw);
} catch {
body = raw;
}
return { http: response.status, ok: response.ok, body };
}
const state = await read(saved.status_url);
const lifecycle = state.body?.status;
if (!state.ok || !["IN_QUEUE", "IN_PROGRESS", "COMPLETED"].includes(lifecycle)) {
return { stage: "status-read-error", ...state };
}
if (lifecycle !== "COMPLETED") {
return { stage: "pending", ...state };
}
const result = await read(saved.response_url);
return { stage: "result", ...result };
}Die Hilfsfunktion behält eine Antwort, die kein JSON ist, bewusst als Text bei. Andernfalls könnte ein fehlgeschlagener JSON-Parsevorgang den hilfreichen Fehler durch eine weitere Ausnahme ersetzen. Ein Verbindungsfehler wird weiterhin an den Aufrufer geworfen; behalte die gespeicherte Anfrage, damit der nächste Wiederherstellungsschritt denselben Job untersuchen kann. Die Funktion führt keinen Generierungs-POST aus.
Ihr Flag ok ist das HTTP-Ergebnis des Lesezugriffs, keine Aussage darüber, ob dein Produkt ein verwendbares Asset hat. Du musst weiterhin den Antworttext prüfen. Ebenso bedeutet status-read-error, dass diese Abfrage den Queue-Status nicht feststellen konnte. Es bedeutet nicht, dass die entfernte Generierung fehlgeschlagen ist.
Prüfe in Python neben dem Aufruf von handler.get() auch die umgebende Ausnahmebehandlung. Ein pauschaler Handler, der bei jeder Ausnahme None zurückgibt, hinterlässt im nächsten Teil deiner App einen leeren Wert ohne Erklärung. Bewahre die Ausnahmeinformationen zur Diagnose auf und gib der Anwendung einen eigenen Fehlerpfad. Derselbe leere Wert darf nicht für eine noch ausstehende Anfrage, eine abgelehnte Eingabe und eine erfolgreich erzeugte, aber noch nicht heruntergeladene Datei stehen.
Beim JavaScript-Debugging kann eine um vertrauliche Daten bereinigte Aufzeichnung der Antwortfeldnamen einen falschen Objektpfad aufdecken. Halte Zugangsdaten und private Eingabeinhalte aus gemeinsam genutzten Logs heraus. Sobald der Pfad feststeht, validiere die erforderlichen Felder, bevor du das Ergebnis an deine Bild- oder Videokomponente übergibst.
Ist die Authentifizierung das Problem, prüfe das Konto, das die Aufgabe erstellt hat. fal-Schlüssel werden im Bereich Keys des Dashboards erstellt und gehören zum ausgewählten Konto. Bewahre die Zugangsdaten auf deinem Server auf, üblicherweise in FAL_KEY; direkte Anfragen verwenden Authorization: Key ....[5] Ein Schlüssel unter einem anderen Konto verschiebt eine bestehende Anfrage nicht in dieses Konto. Setze keinen funktionierenden Schlüssel in Browsercode ein, um das Debugging zu erleichtern.
Lies den Fehler dort, wo er aufgetreten ist
Eine Ergebnisantwort kann erklären, warum eine abgeschlossene Anfrage keine Medien hat. fal dokumentiert folgende Ergebnisstatus:[2]
| Ergebnisantwort | Was du prüfen solltest |
|---|---|
400, Anfrage läuft noch | Kehre zur gespeicherten Status-URL zurück und beobachte diese Anfrage weiter |
401 | Zugangsdaten, Header und Konto der Abfrage |
404 | Anfrage-ID, Abfrage-URL, Konto und geltende Aufbewahrungsregeln |
422 | Den zurückgegebenen Validierungs- oder Modellfehler |
499 | Den aufgezeichneten Abbruch |
500 oder ein anderer Serverfehler | Den tatsächlichen Antworttext und die Anfrage-ID |
Fasse die letzte Zeile nicht als Verbindungstimeout zusammen. Erhältst du vom Ergebnis-Endpunkt einen Modellfehler, hast du eine Antwort, die du prüfen kannst. Erreichst du den Endpunkt nicht, fehlt dir diese Antwort. Die Entscheidungen zur Wiederherstellung unterscheiden sich.
Zum Beispiel ist no_media_generated ein dokumentierter 422-Modellfehler: Die Generierung endete, ohne die erwarteten Medien zu erzeugen. fal kennzeichnet ihn als nicht wiederholbar.[6] Das ist eine konkrete Diagnose, wenn der zurückgegebene Fehler dies aussagt. Eine leere Bildkomponente reicht nicht aus, um diese Diagnose selbst zu stellen.
Behalte die Fehlerstruktur bei. Anfragefehler können einen String detail und einen error_type enthalten; Modellvalidierungsfehler können ein Array detail mit typisierten Einträgen enthalten. fal weist außerdem darauf hin, dass einige Endpunkte das neuere Modellfehlerformat noch nicht übernommen haben.[6][7] Ein Parser, der für jeden Fehler dieselbe Struktur erwartet, kann die Nachricht verbergen, die du am dringendsten brauchst.
Meldet das Ergebnis einen Dateieingabefehler, prüfe auch die Quelldatei. Eine URL, die in deinem angemeldeten Browser funktioniert, ist für den Dienst möglicherweise nicht öffentlich abrufbar. fals Dateileitfaden verlangt zugängliche Eingabe-URLs und weist darauf hin, dass Hosts Anfragen blockieren oder deren Rate begrenzen können.[8] Prüfe diese Bedingung, bevor du den Ausgabeparser änderst; ein fehlgeschlagener Eingabeabruf und ein falsches Ausgabefeld treten in unterschiedlichen Phasen auf.
„API-Aufruf fehlgeschlagen“ in einer App ist daher ein Ausgangspunkt für die Untersuchung, keine Erklärung. Zeichne auf, welcher Aufruf fehlgeschlagen ist, und behalte seinen Status und Antworttext. Wenn du beurteilst, ob der Fehler Credits hätte kosten dürfen, nutze den Abrechnungsleitfaden für fehlgeschlagene Anfragen, nachdem du das tatsächliche Anfrageergebnis festgestellt hast.
Auch eine erfolgreiche JSON-Antwort braucht eine Medienprüfung
Öffne das Output Schema für genau den Endpunkt, an den du die Anfrage gesendet hast. Ausgewählte Bildmodelle geben ein Array images zurück, während andere Modelle andere Strukturen verwenden. Einige bieten sync_mode, womit Medien als Data-URI zurückgegeben und die Ausgabe aus dem Anfrageverlauf ausgelassen werden können.[8] Das sind modellspezifische Details. Ein generischer Handler, der in jedem Ergebnis eine herunterladbare video.url erwartet, deckt sie nicht ab.
Nehmen wir stattdessen an, die Modellantwort enthält die erwartete Ausgabe-URL, aber dein Speicher-Upload ist fehlgeschlagen. Das ist ein hypothetischer Wiederherstellungsfall. Behalte die URL und die ursprüngliche Anfrage-ID, wiederhole den Dateiübertragungsschritt, solange die Datei verfügbar bleibt, und prüfe, ob sich die gespeicherten Bytes lesen lassen. Eine erneute Generierung würde eine neue Operation erzeugen, ohne zu erklären, was mit der ursprünglichen Datei passiert ist.
Auch bei einer API-Migration ist hier eine explizite Feldzuordnung nötig. Gewöhnliche reAPI-Medienaufgaben liefern ihren fachlichen Status und ihre Medienarrays in einer Aufgabenantwort mit output.image_urls oder output.video_urls. Die Aufgabenreferenz und die Fehlerreferenz unterscheiden ein fehlendes Medienergebnis von einem Fehler beim Speichern der erzeugten Datei.[9][10] Auch dort reicht HTTP 200 nicht aus: Lies den Aufgabenstatus und validiere, was deine Anwendung benötigt. Ein Anbieterwechsel beseitigt den Dateiverarbeitungsschritt nicht.
Webhooks bringen ein weiteres zu unterscheidendes Objekt mit
fal-Webhook-Status verwenden OK und ERROR anstelle der Queue-Lebenszykluswerte. Eine OK-Benachrichtigung kann payload: null und payload_error enthalten, wenn sich das Ergebnis nicht als JSON darstellen lässt. Die Dokumentation verweist dich zur Wiederherstellung auf das Queue-Ergebnis zurück.[11]
Wenn dein Workflow von Webhooks gesteuert wird, prüfe die gesamte Benachrichtigung, bevor du entscheidest, dass kein Ergebnis vorliegt. Ein Parser für das Queue-Feld status sollte nicht unverändert für Status und Payload des Webhooks wiederverwendet werden. Ordne die Benachrichtigung der bestehenden Anfrage zu und rufe dann das Ergebnis ab, falls ihre Felder dies verlangen.
Für lange Jobs empfiehlt fal Queue-Status und Webhooks, statt einen blockierenden Aufruf unbegrenzt offen zu halten.[3] Behalte auch dann eine Abfrageroute in deinem eigenen Workflow, wenn Rückrufe der normale Weg sind. Eine verpasste Benachrichtigung sollte dir eine ID zur Untersuchung lassen, statt eine neue Generierung zu erzwingen, damit der Workflow weitergeht.
Speichere abgeschlossene Ergebnisse zeitnah. Die Verfügbarkeit von Queue-Ergebnissen, die Speicherung von Payloads im Anfrageverlauf und die Aufbewahrung von Mediendateien sind getrennte Themen; Ergebnisgröße und Speichereinstellungen können sie unterschiedlich beeinflussen.[2][11][12] Wenn du die Datei später brauchst, kopiere sie in einen von dir kontrollierten Speicher und halte fest, ob die Kopie erfolgreich war. Eine gespeicherte URL allein ist kein Archiv.
Wann du nach einer Störung suchen solltest
Lässt sich das ursprüngliche Ergebnis nicht abrufen, vergleiche Fehlerzeit und betroffenen Dienst mit fals offizieller Statusseite und dem Störungsverlauf. Die Seite unterscheidet Komponenten. Sieh dir deshalb den für deine Anfrage relevanten Teil an, statt jede Meldung als Erklärung für jeden Fehler zu betrachten.[13] Dieser Artikel gibt keine Live-Bewertung der Verfügbarkeit ab.
Ein abgeschlossener Status ohne angezeigte Datei belegt für sich allein nicht, dass fal ausgefallen ist. Ebenso beweist das Fehlen einer Statusmeldung nicht, dass dein Code falsch ist. Die nächsten hilfreichen Belege bleiben die ursprüngliche Ergebnisantwort: ihr HTTP-Code, Antworttext, Endpunkt und ihre Anfrage-ID. Sobald du diese hast, kannst du entscheiden, ob du den Abruf reparierst, eine Eingabe korrigierst, eine Datei wiederherstellst oder einen ungelösten Dienstfehler eskalierst.
Quellen
- fal. Anfragestatus abrufen. Queue-API-Referenz. Abgerufen am 15. November 2026.
- fal. Anfrageergebnis abrufen. Queue-API-Referenz. Abgerufen am 15. November 2026.
- fal. Queue. Inferenzleitfaden für Modell-APIs. Abgerufen am 15. November 2026.
- fal. Inferenzmethoden: So rufst du fal-Modelle auf. Abgerufen am 15. November 2026.
- fal. Deinen API-Schlüssel abrufen. Abgerufen am 15. November 2026.
- fal. Modellfehler. Einschließlich des Eintrags
no_media_generated. Abgerufen am 15. November 2026. - fal. Anfragefehler. Leitfaden für Modell-APIs. Abgerufen am 15. November 2026.
- fal. FLUX.1 [dev] API. Abschnitte Files und Schema. Abgerufen am 15. November 2026.
- reAPI. Aufgaben. reapi.ai/docs/api/tasks. Abgerufen am 15. November 2026.
- reAPI. Fehler. reapi.ai/docs/api/errors. Abgerufen am 15. November 2026.
- fal. Webhooks. Inferenzleitfaden für Modell-APIs. Abgerufen am 15. November 2026.
- fal. Datenaufbewahrung. Leitfaden für Modell-APIs. Abgerufen am 15. November 2026.
- fal. fal-Status. Oberfläche der offiziellen Statusseite am 15. November 2026 geprüft; hier wird keine Verfügbarkeitsbewertung abgegeben.