Skip to main content

واجهة برمجة تطبيقات Dreamina Tasks والتكامل والاستخدام

تُستخدم واجهة برمجة تطبيقات Dreamina Tasks للاستعلام عن نتائج تنفيذ مهام فيديوهات الشخصيات الرقمية التي تم إنشاؤها بواسطة واجهة برمجة تطبيقات Dreamina Video Generation. عند تمرير callback_url أو async: true في واجهة التوليد، ستعيد الواجهة على الفور task_id، يمكنك من خلال هذه الواجهة الاستعلام عن حالة المهمة وعنوان الفيديو النهائي باستخدام task_id أو trace_id. هذه الواجهة مجانية.

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

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

معلمات الطلب

رؤوس الطلب
  • accept: تحديد استلام استجابة بتنسيق JSON، املأ بـ application/json.
  • authorization: مفتاح استدعاء API، بالتنسيق Bearer {token}.
  • content-type: املأ بـ application/json.
جسم الطلب
عند الاستعلام عن مهمة فردية، يجب تقديم إما id أو trace_id.

استعلام عن مهمة فردية

CURL

بايثون

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

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

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

قم بتعيين action إلى retrieve_batch، ومرر مصفوفة ids:
في نتيجة الإرجاع، items هو مصفوفة تفاصيل المهام الجماعية (كل عنصر يتوافق مع تنسيق نتيجة الاستعلام الفردي)، وcount هو عدد المهام التي تم إرجاعها في هذه المرة.

معالجة الأخطاء

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

مثال على استجابة الخطأ

الخاتمة

من خلال هذه الوثيقة، أصبحت على دراية بكيفية استخدام واجهة برمجة تطبيقات Dreamina Tasks للاستعلام عن نتائج مهام فيديوهات الشخصيات الرقمية الفردية أو الجماعية. بالاشتراك مع واجهة التوليد باستخدام callback_url / async في وضع غير المتزامن، يمكنك تحقيق سحب مستقر. إذا كان لديك أي استفسارات، لا تتردد في الاتصال بفريق الدعم الفني لدينا.