Batalkan task

RingkasanCopy Anchor Link

Gunakan DELETE /v1/tasks/{id} untuk membatalkan task asinkron yang belum mulai berjalan. Gunakan task ID yang sama dari respons create atau dari poll_url.

Task yang didukungCopy Anchor Link

Task Seedance dalam antrean dengan seedance-1.5-pro, seedance-2.0, seedance-2.0-fast, atau seedance-2.5 dapat dibatalkan jika task mendukungnya. Task yang sudah berjalan atau berstatus akhir tidak dapat dibatalkan. Status dapat ditanyakan selama catatan task publik masih disimpan.

Parameter pathCopy Anchor Link

ResponsCopy Anchor Link

Perilaku errorCopy Anchor Link

400 unsupported_task_cancel berarti tipe task, provider, atau model tidak mendukung pembatalan. 409 task_not_cancellable berarti task sudah diproses, sudah terminal, atau tidak lagi dapat dibatalkan. 403 berarti API key tidak dapat mengakses task.

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