Annuler une tâche

AperçuCopy Anchor Link

Utilisez DELETE /v1/tasks/{id} pour annuler une tâche asynchrone qui n’a pas encore commencé à s’exécuter. Utilisez le même ID de tâche que celui de la réponse create ou celui inclus dans poll_url.

Tâches prises en chargeCopy Anchor Link

Les tâches Seedance en attente utilisant seedance-1.5-pro, seedance-2.0, seedance-2.0-fast ou seedance-2.5 peuvent être annulées si elles le permettent. Les tâches en cours ou dans un état final ne peuvent pas être annulées. Le statut reste consultable tant que leur enregistrement public est conservé.

Paramètres de cheminCopy Anchor Link

RéponseCopy Anchor Link

Comportement des erreursCopy Anchor Link

400 unsupported_task_cancel signifie que le type de tâche, le fournisseur ou le modèle ne prend pas en charge l’annulation. 409 task_not_cancellable signifie que la tâche est déjà en cours de traitement, terminale ou n’est plus annulable. 403 signifie que la clé API ne peut pas accéder à cette tâche.

ExempleCopy Anchor Link

curl -X DELETE "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

{
  "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"
}

{  "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"}