المهام غير المتزامنة
إلغاء مهمة
إلغاء مهمة غير متزامنة (async task) موجودة في قائمة الانتظار عندما يدعم النموذج الخاص بها الإلغاء
نظرة عامة
استخدم DELETE /v1/tasks/{id} لإلغاء مهمة غير متزامنة لم تبدأ في التنفيذ بعد. استخدم نفس معرف المهمة (task ID) من استجابة الإنشاء أو من poll_url المُعاد.
المهام المدعومة
يتوفر الإلغاء لمهام Seedance الموجودة في قائمة الانتظار باستخدام seedance-2.0 أو seedance-2.5 أو seedance-2.5 عندما تدعم تلك المهمة الإلغاء. لا يمكن إلغاء مهمة قيد التشغيل بالفعل أو في حالة نهائية. لا يتم فرض رسوم على المهمة الملغاة. تظل الحالة قابلة للاستعلام طالما يتم الاحتفاظ بسجل المهمة العام الخاص بها.
لإلغاء مهمة تم إنشاؤها من خلال نقطة نهاية Seedance المتوافقة مع Volc، راجع إلغاء مهمة (متوافقة مع Volc).
معاملات المسار (Path Parameters)
معرف المهمة غير المتزامنة الذي تم إرجاعه بواسطة طلب الإنشاء أو المضمن في poll_url.
الاستجابة
المعرف الأساسي للمهمة غير المتزامنة.
الاسم المستعار لمعرف المهمة غير المتزامنة.
رابط حالة المهمة. يظل صالحاً بعد الإلغاء. قم بإجراء استعلام GET /v1/tasks/{id} باستخدام id.
حالة المهمة. يتم إرجاع المهمة التي تم إلغاؤها بنجاح كـ failed مع cancelled: true للتوافق مع قيم الحالة الحالية.
تكون true عندما يتم إلغاء المهمة قبل التنفيذ.
مؤشر الإلغاء. تكون القيمة cancelled عند نجاح الإلغاء.
سبب الإلغاء أو رسالة فشل المهمة.
سلوك الخطأ
| HTTP | Code | المعنى |
|---|---|---|
400 | missing_task_id, invalid_task_id | معرف المهمة مفقود أو ليس معرف مهمة صالحاً |
400 | unsupported_task_cancel | نوع المهمة أو النموذج لا يدعم الإلغاء |
403 | task_not_owned | المهمة لا تنتمي إلى مساحة العمل الخاصة بمفتاح API هذا |
404 | async_task_not_found | انتهت صلاحية المهمة أو أنها غير متاحة |
409 | task_not_cancellable | المهمة قيد المعالجة بالفعل، أو انتهت، أو لم تعد قابلة للإلغاء. توضح current_status حالتها |
503 | async_task_owner_unavailable | لا يمكن قراءة المهمة في الوقت الحالي. حاول مرة أخرى |
الطلب
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"
}التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
معرف المهمة غير المتزامنة الذي يتم إرجاعه بواسطة id / task_id، أو المضمن في poll_url
الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json
application/json