Skip to main content
Es gibt keinen synchronen Endpunkt. Eine KI-Engine abzufragen dauert Sekunden bis Minuten, daher wird jede Anfrage zu einem dauerhaft gespeicherten Task in der Warteschlange, den Sie später abholen.

​
Lebenszyklus

​
Status

​
status
Angenommen und dauerhaft gespeichert. Wartet auf einen Worker.
​
status
Ein Worker hält eine Lease auf den Task und steuert die Engine.
​
status
Endzustand. Das Feld response ist befüllt.
​
status
Endzustand. Das Feld error enthält den Grund.
Ein Task mit vorübergehendem Fehler (Engine-Timeout, temporärer Fehler) kehrt zu QUEUED zurück und wird erneut versucht. Erst wenn alle Versuche aufgebraucht sind, landet er in FAILED. Übergänge PROCESSING → QUEUED sind also normal und kein Anlass für einen Alarm.

​
Priorität

priority bleibt aus Kompatibilitätsgründen erhalten und wird in den Task-Metadaten zurückgegeben. Erlaubt sind 1 bis 10, Standard ist 1, und Werte außerhalb des Bereichs werden in den Bereich gezogen statt abgelehnt.
Die Ausführungsreihenfolge ist weder durch Priorität noch durch Einreichzeit oder Konto garantiert. Bei abhängiger Arbeit warten Sie, bis der vorherige Task abgeschlossen ist, bevor Sie den nächsten einreichen. Die Parallelitätsgrenzen des Tarifs gelten für wartende und laufende Tasks.

​
Aufbewahrung

Abgeschlossene Tasks sind 24 Stunden nach Abschluss über öffentliches Polling verfügbar. Danach liefert GET /v1/async/task/{id} 404 NOT_FOUND, dieselbe Antwort wie für eine id, die nie existiert hat. Der zugrunde liegende Datensatz wird dauerhaft aufbewahrt; der Ablauf begrenzt öffentliches Polling und manuelles erneutes Senden von Webhooks, nicht die Speicherung. Automatische Webhook-Wiederholungen laufen davon unabhängig weiter. Wenn Sie auf Polling statt auf Webhooks setzen, holen Sie die Ergebnisse deutlich innerhalb dieses Zeitraums ab.

​
Webhook oder Polling

Bevorzugen Sie Webhooks. Polling ist der Weg zur Wiederherstellung. Ein robuster Client macht beides: Er nutzt den Webhook als schnellen Weg und gleicht per Polling alles ab, wovon er vor Ende des Aufbewahrungsfensters nichts gehört hat.