Skip to main content

Überblick

Verwenden Sie DELETE /v1/tasks/{id}, um einen asynchronen Task abzubrechen, der noch nicht gestartet wurde. Verwenden Sie dieselbe Task-ID aus der Create-Antwort oder aus der zurückgegebenen poll_url.

Unterstützte Tasks

Der Abbruch wird für wartende Seedance-Video-Tasks unterstützt, wenn der für diesen Task ausgewählte Provider den Abbruch unterstützt. Unterstützte Modelle sind seedance-1.5-pro, seedance-2.0 und seedance-2.0-fast. Tasks, die bereits processing/running sind, können nicht abgebrochen werden. Abgeschlossene, fehlgeschlagene, abgelaufene oder nicht unterstützte Tasks bleiben für Status- und Abrechnungsabgleich abfragbar.

Pfadparameter

string
erforderlich
Die asynchrone Task-ID aus der Create-Anfrage oder aus der poll_url.

Antwort

string
Kanonischer asynchroner Task-Bezeichner.
string
Alias des asynchronen Task-Bezeichners.
string
Bevorzugte Polling-URL für den Task. Sie bleibt nach dem Abbruch gültig.
string
Task-Status. Ein erfolgreich abgebrochener Task wird aus Kompatibilitätsgründen als failed mit cancelled: true zurückgegeben.
boolean
true, wenn der Task vor der Ausführung abgebrochen wurde.
string
Abbruchmarker. Der Wert ist cancelled, wenn der Abbruch erfolgreich war.
string
Abbruchgrund oder Fehlermeldung des Tasks.

Fehlerverhalten

400 unsupported_task_cancel bedeutet, dass Task-Typ, Provider oder Modell keinen Abbruch unterstützt. 409 task_not_cancellable bedeutet, dass der Task bereits verarbeitet wird, terminal ist oder nicht mehr abbrechbar ist. 403 bedeutet, dass der API key keinen Zugriff auf den Task hat.

Beispiel

Response