Asenkron işler

Görevi İptal Et

Model desteklediğinde kuyruktaki bir asenkron görevi iptal edin

DELETE
/v1/tasks/{id}

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

idstringpathzorunlu

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

idstring

Kanonik asenkron görev tanımlayıcısı.

task_idstring

Asenkron görev tanımlayıcı takma adı.

poll_urlstring

Görev için durum URL'si. İptal işleminden sonra geçerliliğini korur. id ile GET /v1/tasks/{id} sorgusu yapın.

statusstring

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.

cancelledboolean

Görev yürütülmeden önce iptal edildiğinde true değerini alır.

cancellation_statusstring

İptal işareti. İptal başarılı olduğunda değer cancelled olur.

errorstring

İptal nedeni veya görev başarısızlık mesajı.

Hata Davranışı

HTTPKodAnlamı
400missing_task_id, invalid_task_idGörev kimliği eksik veya geçerli bir görev kimliği değil
400unsupported_task_cancelGörev türü veya modeli iptal işlemini desteklemiyor
403task_not_ownedGörev, bu API anahtarının çalışma alanına ait değil
404async_task_not_foundGörev süresi dolmuş veya mevcut değil
409task_not_cancellableGörev halihazırda işleniyor, tamamlandı veya başka bir nedenle artık iptal edilemez. current_status mevcut durumunu verir
503async_task_owner_unavailableGörev şu anda okunamıyor. Yeniden deneyin

Örnek

İstek

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

Yanıt

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

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

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*string

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