مزامنة الشفاه

تجمع وظائف مزامنة الشفاه بين مقطع فيديو مصدر ومسار صوتي في فيديو نتيجة متزامن. نقطة النهاية غير متزامنة لأن معالجة الفيديو قد تستغرق وقتًا أطول من طلب HTTP العادي.

إنشاء وظيفة

POST /api/open/v1/media/lip-sync/jobs
Authorization: Bearer KITTA_API_KEY
Content-Type: application/json

طلب

{
  "videoUrl": "https://example.com/video.mp4",
  "audioUrl": "https://example.com/audio.mp3"
}

يجب أن يكون كلا عنواني URL قابلين للوصول بواسطة خدمة API. استخدم عناوين URL الموقعة قصيرة العمر للوسائط الخاصة، واحتفظ بها صالحة لفترة كافية حتى يتمكن العامل من تنزيل الملفات.

curl https://kittaai.com/api/open/v1/media/lip-sync/jobs \
  -H "Authorization: Bearer KITTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"videoUrl":"https://example.com/video.mp4","audioUrl":"https://example.com/audio.mp3"}'

إجابة

{
  "success": true,
  "message": "Job created",
  "data": {
    "id": "job_123",
    "status": "queued"
  }
}

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

قائمة الوظائف

GET /api/open/v1/media/lip-sync/jobs?page=1&limit=20&status=completed
Authorization: Bearer KITTA_API_KEY

تتضمن المرشحات المدعومة page، وlimit، وstatus. استخدم القائمة لاسترداد المكتب الخلفي وتاريخ المشروع، وليس كحلقة استقصاء عالية التردد.

احصل على وظيفة

GET /api/open/v1/media/lip-sync/jobs/{jobId}
Authorization: Bearer KITTA_API_KEY

تتضمن المهام المكتملة بيانات تعريف النتائج في data. تتضمن المهام الفاشلة رمز خطأ أو رسالة. احتفظ بحالات المحطة الطرفية غير قابلة للتغيير في قاعدة البيانات الخاصة بك حتى لا يؤدي الاستقصاء المتكرر إلى إعادة كتابة سجلات النتائج التاريخية.

الفواتير والائتمانات

عادةً ما يتم تحصيل رسوم عمل مزامنة الشفاه حسب المهمة المقبولة أو مدة المعالجة الكاملة. تحقق من صحة طول الفيديو وطول الصوت قبل الإرسال، وتجنب إنشاء مهمة ثانية تلقائيًا عند انتهاء مهلة طلب الاستقصاء.

إذا كان بإمكان المستخدمين تشغيل العديد من المهام، فقم بفرض حدود قائمة الانتظار والتزامن الخاصة بك. استخدم الملف الشخصي لاكتشاف الرصيد المنخفض قبل قبول الدفعات باهظة الثمن.

أخطاء