Ringkasan
GunakanDELETE /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 didukung
Pembatalan didukung untuk task video Seedance yang masih antre ketika provider yang dipilih untuk task tersebut mendukung pembatalan. Model yang didukung adalahseedance-1.5-pro, seedance-2.0, dan seedance-2.0-fast. Task yang sudah processing/running tidak dapat dibatalkan. Task yang selesai, gagal, kedaluwarsa, atau tidak didukung tetap dapat ditanyakan untuk rekonsiliasi status dan billing.
Parameter path
string
wajib
Async task ID yang dikembalikan oleh permintaan create atau tertanam di
poll_url.Respons
string
Identifier async task kanonis.
string
Alias identifier async task.
string
Polling URL yang disarankan untuk task. Tetap valid setelah pembatalan.
string
Status task. Task yang berhasil dibatalkan dikembalikan sebagai
failed dengan cancelled: true agar kompatibel dengan nilai status yang ada.boolean
true ketika task dibatalkan sebelum eksekusi.string
Penanda pembatalan. Nilainya
cancelled ketika pembatalan berhasil.string
Alasan pembatalan atau pesan kegagalan task.
Perilaku error
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.
Contoh
Response