Video abbrechen

Brechen Sie eine laufende Videogenerierungsaufgabe ab. Eine Aufgabe kann nur abgebrochen werden, solange sie noch läuft — sobald sie einen terminalen Zustand erreicht (completed, failed, cancelled, expired), kann sie nicht mehr abgebrochen werden.


DELETE https://api.ofox.ai/v1/videos/{id}

Der Abbruch hängt vom Upstream-Anbieter ab. Ofox akzeptiert eine Abbruchanfrage nur, wenn der Upstream-Anbieter Unterbrechung tatsächlich unterstützt — es meldet niemals einen Scheinerfolg, indem es die Aufgabe lokal als abgebrochen markiert, während die Generierung upstream weiterläuft. Anbieter, die einen laufenden Job nicht unterbrechen können, geben 400 cancel_not_supported zurück.

Anfrage

Terminal


curl -X DELETE https://api.ofox.ai/v1/videos/9bcf3c60-7db2-4e1a-a1b2-c3d4e5f60718 \
  -H "Authorization: Bearer $OFOX_API_KEY"

Antwort

Ein erfolgreicher Abbruch gibt 204 No Content mit leerem Body zurück.


HTTP/1.1 204 No Content

Nach einem erfolgreichen Abbruch wird der status der Aufgabe zu cancelled. Polling von GET /v1/videos/{id} gibt dann den terminalen Zustand cancelled zurück; wenn Sie eine callback_url registriert haben, erhalten Sie außerdem einen video.generation.cancelled-Webhook.

Abbruchverhalten

Ob ein Abbruch akzeptiert wird, hängt vom aktuellen Zustand der Aufgabe und davon ab, ob der Upstream-Anbieter Unterbrechung unterstützt:

Aufgabenstatus	Verhalten	Antwort
`pending` (noch nicht upstream eingereicht)	Lokal abgebrochen	`204`
`queued` / `in_progress`, Anbieter unterstützt Unterbrechung	Upstream-Abbruch wird aufgerufen, dann wird die Aufgabe bei Erfolg als abgebrochen markiert	`204`
`queued` / `in_progress`, Anbieter unterstützt keine Unterbrechung	Abgelehnt (kein Scheinerfolg)	`400 cancel_not_supported`
Bereits in einem terminalen Zustand	Abgelehnt	`400 cancel_failed`
Nicht gefunden / gehört nicht zu Ihrem Key	Einheitliche Antwort (verhindert Offenlegung der Existenz)	`404 not_found`

Eine nicht existierende Aufgabe und eine Aufgabe, die einem anderen API Key gehört, geben dasselbe 404 not_found zurück; die Antwort verrät also nie, ob eine bestimmte Aufgaben-ID existiert.

Fehler

HTTP	code	Bedeutung
`400`	`cancel_not_supported`	Der Upstream-Anbieter unterstützt das Unterbrechen eines laufenden Jobs nicht
`400`	`cancel_failed`	Die Aufgabe befindet sich bereits in einem terminalen Zustand und kann nicht abgebrochen werden
`404`	`not_found`	Die Aufgabe existiert nicht oder gehört nicht zu Ihrem API Key

Fehler verwenden das gemeinsame Fehlerobjekt:


{
  "error": {
    "code": "cancel_not_supported",
    "message": "The upstream provider for this task does not support cancellation."
  }
}

Die vollständige Fehlerreferenz enthält alle Codes. DELETE unterliegt nicht der Polling-Ratenbegrenzung, die für GET gilt — Details finden Sie unter Videostatus abrufen.