إلغاء المهمة

نظرة عامةCopy Anchor Link

استخدم DELETE /v1/tasks/{id} لإلغاء مهمة غير متزامنة لم تبدأ التنفيذ بعد. استخدم نفس معرف المهمة من استجابة create أو المعرف الموجود في poll_url.

المهام المدعومةCopy Anchor Link

يمكن إلغاء مهام Seedance المنتظرة التي تستخدم seedance-1.5-pro أو seedance-2.0 أو seedance-2.0-fast أو seedance-2.5 عندما تدعم المهمة الإلغاء. لا يمكن إلغاء مهمة بدأت التنفيذ أو وصلت إلى حالة نهائية. تبقى الحالة قابلة للاستعلام ما دام سجل المهمة العام محفوظًا.

معلمات المسارCopy Anchor Link

الاستجابةCopy Anchor Link

سلوك الأخطاءCopy Anchor Link

400 unsupported_task_cancel يعني أن نوع المهمة أو الموفر أو النموذج لا يدعم الإلغاء. 409 task_not_cancellable يعني أن المهمة قيد المعالجة بالفعل أو في حالة نهائية أو لم تعد قابلة للإلغاء. 403 يعني أن مفتاح API لا يمكنه الوصول إلى المهمة.

مثالCopy 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"}