نظرة عامة
استخدمDELETE /v1/tasks/{id} لإلغاء مهمة غير متزامنة لم تبدأ التنفيذ بعد. استخدم نفس معرف المهمة من استجابة create أو المعرف الموجود في poll_url.
المهام المدعومة
يتوفر الإلغاء لمهام فيديو Seedance الموجودة في قائمة الانتظار عندما يدعم المزوّد المحدد لتلك المهمة الإلغاء. النماذج المدعومة هيseedance-1.5-pro وseedance-2.0 وseedance-2.0-fast. لا يمكن إلغاء المهام التي أصبحت في حالة processing/running. تبقى المهام المكتملة أو الفاشلة أو المنتهية أو غير المدعومة قابلة للاستعلام لأغراض الحالة وتسوية الفوترة.
معلمات المسار
string
مطلوب
معرف المهمة غير المتزامنة الذي أرجعته طلب create أو الموجود في
poll_url.الاستجابة
string
المعرف القياسي للمهمة غير المتزامنة.
string
اسم مستعار لمعرف المهمة غير المتزامنة.
string
رابط polling المفضل للمهمة. يبقى صالحًا بعد الإلغاء.
string
حالة المهمة. يتم إرجاع المهمة الملغاة بنجاح كـ
failed مع cancelled: true للحفاظ على التوافق مع قيم الحالة الحالية.boolean
true عندما يتم إلغاء المهمة قبل التنفيذ.string
مؤشر الإلغاء. تكون القيمة
cancelled عند نجاح الإلغاء.string
سبب الإلغاء أو رسالة فشل المهمة.
سلوك الأخطاء
400 unsupported_task_cancel يعني أن نوع المهمة أو الموفر أو النموذج لا يدعم الإلغاء. 409 task_not_cancellable يعني أن المهمة قيد المعالجة بالفعل أو في حالة نهائية أو لم تعد قابلة للإلغاء. 403 يعني أن مفتاح API لا يمكنه الوصول إلى المهمة.
مثال
Response