Asenkron işler
Görevi İptal Et
Model desteklediğinde kuyruktaki bir asenkron görevi iptal edin
Genel Bakış
Henüz çalışmaya başlamamış bir asenkron görevi iptal etmek için DELETE /v1/tasks/{id} kullanın. Oluşturma yanıtından veya döndürülen poll_url içinden aynı görev kimliğini (task ID) kullanın.
Desteklenen Görevler
İptal işlemi, görev desteklediği durumlarda seedance-2.0, seedance-2.0-fast veya seedance-2.5 kullanan kuyruktaki Seedance görevleri için kullanılabilir. Hali hazırda çalışmakta olan veya terminal durumuna ulaşmış bir görev iptal edilemez. İptal edilen bir görev için ücret alınmaz. Genel görev kaydı tutulduğu sürece durum sorgulanabilir kalır.
Volc uyumlu Seedance uç noktası aracılığıyla oluşturulan bir görevi iptal etmek için bkz: Görevi İptal Et (Volc Uyumlu).
Yol Parametreleri
Oluşturma isteği tarafından döndürülen veya poll_url içine gömülü olan asenkron görev kimliği.
Yanıt
Kanonik asenkron görev tanımlayıcısı.
Asenkron görev tanımlayıcı takma adı.
Görev için durum URL'si. İptal işleminden sonra geçerliliğini korur. id ile GET /v1/tasks/{id} sorgusu yapın.
Görev durumu. Başarıyla iptal edilen bir görev, mevcut durum değerleriyle uyumluluk için cancelled: true ile birlikte failed olarak döndürülür.
Görev yürütülmeden önce iptal edildiğinde true değerini alır.
İptal işareti. İptal başarılı olduğunda değer cancelled olur.
İptal nedeni veya görev başarısızlık mesajı.
Hata Davranışı
| HTTP | Kod | Anlamı |
|---|---|---|
400 | missing_task_id, invalid_task_id | Görev kimliği eksik veya geçerli bir görev kimliği değil |
400 | unsupported_task_cancel | Görev türü veya modeli iptal işlemini desteklemiyor |
403 | task_not_owned | Görev, bu API anahtarının çalışma alanına ait değil |
404 | async_task_not_found | Görev süresi dolmuş veya mevcut değil |
409 | task_not_cancellable | Görev halihazırda işleniyor, tamamlandı veya başka bir nedenle artık iptal edilemez. current_status mevcut durumunu verir |
503 | async_task_owner_unavailable | Görev şu anda okunamıyor. Yeniden deneyin |
İstek
curl -X DELETE "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Yanıt
{
"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"
}Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Yol parametreleri
id / task_id tarafından döndürülen veya poll_url içine gömülü olan asenkron görev kimliği
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json
application/json