الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
نظرة عامة

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

​
المهام المدعومة

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

​
معلمات المسار

​
id
string
مطلوب
معرف المهمة غير المتزامنة الذي أرجعته طلب create أو الموجود في poll_url.

​
الاستجابة

​
id
string
المعرف القياسي للمهمة غير المتزامنة.
​
task_id
string
اسم مستعار لمعرف المهمة غير المتزامنة.
​
poll_url
string
رابط polling المفضل للمهمة. يبقى صالحًا بعد الإلغاء.
​
status
string
حالة المهمة. يتم إرجاع المهمة الملغاة بنجاح كـ failed مع cancelled: true للحفاظ على التوافق مع قيم الحالة الحالية.
​
cancelled
boolean
true عندما يتم إلغاء المهمة قبل التنفيذ.
​
cancellation_status
string
مؤشر الإلغاء. تكون القيمة cancelled عند نجاح الإلغاء.
​
error
string
سبب الإلغاء أو رسالة فشل المهمة.

​
سلوك الأخطاء

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

​
مثال

curl -X DELETE "https://api.lemondata.cc/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
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"
}