Zum Hauptinhalt springen
idempotencyKey ist ein optionaler String, den Sie bei einer Einreichung setzen. Senden Sie denselben Schlüssel erneut, erhalten Sie den Task, den die erste Einreichung erstellt hat; es wird keine neue Arbeit eingereiht und keine neue Credit-Reservierung angelegt.
Ohne Schlüssel gibt es keine Deduplizierung: Jede Einreichung erzeugt einen neuen Task. Setzen Sie einen Schlüssel bei allem, was ein Cronjob oder ein wiederholender Worker doppelt senden könnte.
Leiten Sie den Schlüssel aus der Arbeitseinheit ab, nicht aus dem Versuch. Ein Schlüssel wie "{jobId}:{promptId}:{engine}" ergibt bei jeder Wiederholung dieser Arbeit denselben Wert.

Wie jeder Endpunkt einen wiederholten Schlüssel behandelt

Der Einzel-Endpunkt behält die Semantik der expliziten Erstellung: Sie wollten einen Task erstellen, der bereits existiert, also erhalten Sie einen Konflikt. Die Fehlerantwort trägt die id des bestehenden Tasks in error.details.taskId, sodass ein Einreichen ohne Antwort über diese id abgefragt werden kann.
Der Batch mit 500 Tasks wertet Duplikate als Erfolg, sodass ein Worker nach einem Neustart einen ganzen Job erneut senden kann, ohne dass der Batch an den bereits eingereichten Einträgen scheitert.

Standort-Raster

Der idempotencyKey des Rasters wird zu seiner id (fehlt er, wird eine UUID erzeugt). Der Task-Schlüssel jedes Punkts ist <grid id>:r<row>c<col>. Senden Sie dasselbe Raster erneut unter dieser id, werden die bestehenden Punkte zurückgegeben und nur die fehlenden angenommen. Senden Sie ein Raster mit anderem Mittelpunkt, anderer Größe oder anderem Radius unter derselben id, scheitern die Punkte mit abweichenden Koordinaten mit RESOURCE_ALREADY_EXISTS; verwenden Sie für ein neues Raster einen neuen Schlüssel.

Geltungsbereich und Länge

Schlüssel gelten pro Konto: Ein anderes Konto kann denselben String verwenden, ohne mit Ihrem zu kollidieren. Ein UUID-Format ist nicht erforderlich.

Ergebnisse den Einreichungen zuordnen

Wenn Sie keinen Schlüssel gesendet haben, wird idempotencyKey im Task-Objekt weggelassen statt als null zurückgegeben.

Lebensdauer des Schlüssels

Ein Schlüssel bleibt mindestens 30 Tage nach der Anfrage reserviert, auch nachdem der Task abgeschlossen oder fehlgeschlagen ist und nachdem das 24-stündige Polling-Fenster abgelaufen ist. Ein 404 beim Polling gibt den Schlüssel nicht frei. Verwenden Sie für Übertragungswiederholungen einer Einreichung denselben Schlüssel und für einen separaten Lauf derselben Arbeit einen neuen Schlüssel (zum Beispiel mit dem Suffix :r1).

Nächste Schritte

Batches und Raster

Die drei Massen-Endpunkte im Vergleich.

Fehler

Alle Fehlercodes für Anfragen.