Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

Ü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 derzeit für wartende Volcengine-Seedance-Video-Tasks mit seedance-1.5-pro, seedance-2.0 oder seedance-2.0-fast unterstützt. 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, anstatt Upstream-Datensätze zu löschen.

Pfadparameter

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

Antwort

id
string
Kanonischer asynchroner Task-Bezeichner.
task_id
string
Alias des asynchronen Task-Bezeichners.
poll_url
string
Bevorzugte Polling-URL für den Task. Sie bleibt nach dem Abbruch gültig.
status
string
Task-Status. Ein erfolgreich abgebrochener Task wird aus Kompatibilitätsgründen als failed mit cancelled: true zurückgegeben.
cancelled
boolean
true, wenn der Task vor der Ausführung abgebrochen wurde.
cancellation_status
string
Abbruchmarker. Der Wert ist cancelled, wenn der Abbruch erfolgreich war.
error
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

curl -X DELETE "https://api.lemondata.cc/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "failed",
  "cancelled": true,
  "cancellation_status": "cancelled",
  "error": "Task cancelled before execution"
}