Ana içeriğe atla

​
Genel bakış

Henüz çalışmaya başlamamış bir asenkron görevi iptal etmek için DELETE /v1/tasks/{id} kullanın. create yanıtındaki görev ID’sini veya poll_url içindeki aynı ID’yi kullanın.

​
Desteklenen görevler

İptal, görev için seçilen sağlayıcı iptali desteklediğinde kuyruktaki Seedance video görevleri için desteklenir. Desteklenen modeller seedance-1.5-pro, seedance-2.0 ve seedance-2.0-fasttır. Zaten processing/running durumundaki görevler iptal edilemez. Tamamlanan, başarısız, süresi dolan veya desteklenmeyen görevler durum ve faturalama mutabakatı için sorgulanabilir kalır.

​
Yol parametreleri

​
id
string
gerekli
create isteği tarafından döndürülen veya poll_url içinde bulunan asenkron görev ID’si.

​
Yanıt

​
id
string
Kanonik asenkron görev tanımlayıcısı.
​
task_id
string
Asenkron görev tanımlayıcısı takma adı.
​
poll_url
string
Görev için tercih edilen polling URL’si. İptalden sonra da geçerlidir.
​
status
string
Görev durumu. Başarıyla iptal edilen görev, mevcut durum değerleriyle uyumluluk için failed ve cancelled: true olarak döner.
​
cancelled
boolean
Görev yürütülmeden önce iptal edildiyse true.
​
cancellation_status
string
İptal işareti. İptal başarılı olduğunda değer cancelled olur.
​
error
string
İptal nedeni veya görev hata mesajı.

​
Hata davranışı

400 unsupported_task_cancel, görev türü, sağlayıcı veya modelin iptali desteklemediği anlamına gelir. 409 task_not_cancellable, görevin zaten işlendiği, terminal durumda olduğu veya artık iptal edilemediği anlamına gelir. 403, API key’in göreve erişemediği anlamına gelir.

​
Örnek

curl -X DELETE "https://api.tokenlab.sh/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"
}