Skip to main content
الوظيفة الرئيسية لواجهة برمجة تطبيقات مهام كلينغ هي استعلام حالة تنفيذ المهمة من خلال إدخال معرف المهمة الذي تم إنشاؤه بواسطة واجهة برمجة تطبيقات إنشاء مقاطع فيديو كلينغ. ستتناول هذه الوثيقة تفاصيل تكامل واجهة برمجة تطبيقات مهام كلينغ، لمساعدتك على دمجها بسهولة والاستفادة الكاملة من القوة الكبيرة لهذه الواجهة. من خلال واجهة برمجة تطبيقات مهام كلينغ، يمكنك بسهولة استعلام حالة تنفيذ المهام من واجهة برمجة تطبيقات إنشاء مقاطع فيديو كلينغ.

عملية التقديم

لاستخدام واجهة برمجة تطبيقات إنشاء مقاطع فيديو كلينغ، يجب أولاً الذهاب إلى وحدة التحكم في سحابة Ace Data للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية. إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم إرجاعك تلقائيًا إلى الصفحة الحالية. يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة. عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربته مجانًا؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في وحدة التحكم.
📘 الوثائق الكاملة: واجهة برمجة تطبيقات إنشاء مقاطع فيديو كلينغ →

مثال على الطلب

يمكن استخدام واجهة برمجة تطبيقات مهام كلينغ لاستعلام نتائج واجهة برمجة تطبيقات إنشاء مقاطع فيديو كلينغ. لمزيد من المعلومات حول كيفية استخدام واجهة برمجة تطبيقات إنشاء مقاطع فيديو كلينغ، يرجى الرجوع إلى الوثيقة واجهة برمجة تطبيقات إنشاء مقاطع فيديو كلينغ. سنأخذ مثالاً على معرف المهمة الذي تم إرجاعه من خدمة واجهة برمجة تطبيقات إنشاء مقاطع فيديو كلينغ، لنوضح كيفية استخدام هذه الواجهة. لنفترض أن لدينا معرف مهمة: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0، وسنوضح كيفية تمرير معرف المهمة.

مثال على المهمة

إعداد رأس الطلب وجسم الطلب

رؤوس الطلب تشمل:
  • accept: تحديد استلام نتائج الاستجابة بتنسيق JSON، هنا يتم ملؤه بـ application/json.
  • authorization: مفتاح استدعاء واجهة برمجة التطبيقات، يمكن اختياره مباشرة بعد التقديم.
جسم الطلب يشمل:
  • id: معرف المهمة المرفوعة.
  • action: طريقة تنفيذ العملية على المهمة.
الإعداد كما هو موضح في الصورة أدناه:

مثال على الكود

يمكن ملاحظة أنه تم إنشاء أكواد بلغات مختلفة تلقائيًا على الجانب الأيمن، كما هو موضح في الصورة:

بعض أمثلة الكود كما يلي:

CURL

بايثون

مثال على الاستجابة

بعد نجاح الطلب، ستقوم واجهة برمجة التطبيقات بإرجاع تفاصيل مهمة الفيديو هنا. على سبيل المثال:
تتضمن النتيجة عدة حقول، حيث يمثل حقل request جسم الطلب عند بدء المهمة، بينما يمثل حقل response جسم الاستجابة الذي تم إرجاعه بعد إكمال المهمة. توضيح الحقول كما يلي.
  • id: معرف المهمة التي تم إنشاؤها لهذا الفيديو، يستخدم لتحديد هذه المهمة بشكل فريد.
  • request: استعلام معلومات الطلب في مهمة الفيديو.
  • response: استعلام معلومات الاستجابة في مهمة الفيديو.
  • created_at: وقت إنشاء المهمة، طابع زمني Unix (ثوانٍ، عائم).
  • started_at: وقت بدء تنفيذ المهمة، طابع زمني Unix (ثوانٍ، عائم).
  • finished_at: وقت إكمال المهمة، طابع زمني Unix (ثوانٍ، عائم). لا يتم إرجاع هذا الحقل إذا لم تكتمل المهمة.
  • elapsed: الوقت المستغرق لتنفيذ المهمة، بوحدة الثواني (عائم، يحتفظ بـ 3 أرقام عشرية). لا يتم إرجاع هذا الحقل إذا لم تكتمل المهمة.

عمليات الاستعلام الجماعي

هذا مخصص لاستعلام تفاصيل مهام الفيديو لعدة معرفات مهام، وما يميزها هو أنه يجب اختيار action كـ retrieve_batch. جسم الطلب يشمل:
  • ids: مصفوفة معرفات المهام المرفوعة.
  • action: طريقة تنفيذ العملية على المهمة.
الإعداد كما هو موضح في الصورة أدناه:

مثال على الكود

يمكن ملاحظة أنه تم إنشاء أكواد بلغات مختلفة تلقائيًا على الجانب الأيمن، كما هو موضح في الصورة:

بعض أمثلة الكود كما يلي:

مثال على الاستجابة

بعد نجاح الطلب، ستقوم واجهة برمجة التطبيقات بإرجاع تفاصيل جميع مهام الفيديو الجماعية. على سبيل المثال:
返回结果一共有多个字段,其中items是包含了批量视频任务的具体详情信息,每个视频任务的具体信息与上文的字段一样,字段信息如下。
  • items,批量视频任务的所有具体详情信息。它 هو مصفوفة، كل عنصر في المصفوفة له نفس تنسيق نتيجة الاستعلام عن مهمة واحدة كما هو مذكور أعلاه.
  • count، عدد مهام الفيديو التي تم استعلامها بشكل جماعي.

CURL

错误处理

في حالة استدعاء API وواجهت خطأ، ستقوم API بإرجاع رمز الخطأ والمعلومات ذات الصلة. على سبيل المثال:
  • 400 token_mismatched:طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 400 api_not_implemented:طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 401 invalid_token:غير مصرح به، رمز التفويض غير صالح أو مفقود.
  • 429 too_many_requests:عدد كبير جدًا من الطلبات، لقد تجاوزت الحد الأقصى لمعدل الطلبات.
  • 500 api_error:خطأ داخلي في الخادم، حدث خطأ ما على الخادم.

错误响应示例

结论

من خلال هذه الوثيقة، لقد فهمت كيفية استخدام واجهة برمجة تطبيقات Kling Tasks لاستعلام عن تفاصيل مهمة فيديو واحدة أو جماعية. نأمل أن تساعدك هذه الوثيقة في التوصيل واستخدام هذه الواجهة بشكل أفضل. إذا كان لديك أي استفسارات، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.