Skip to main content
POST
cURL
استخدم نقطة النهاية هذه لإنشاء مهمة مزامنة شفاه متقدمة بعد أن تكون قد حدّدت الوجوه بالفعل في فيديو المصدر.

قبل استدعائها

  • ابدأ بـ Lip-Sync للحصول على session_id وقيم face_id المتاحة
  • أنشئ إدخالًا واحدًا أو أكثر من face_choose لربط كل وجه بمقطع صوتي
  • استخدم audio_id للصوت الناتج من مهمة سابقة، أو sound_file لملف صوتي مستضاف
  • أرسل حقول التوقيت بالمللي ثانية. على سبيل المثال، sound_start_time: "0" وsound_end_time: "2000" يحددان أول ثانيتين.
  • تأكد من أن طول المقطع الصوتي المقصوص لا يقل عن 2000 ms ولا يتجاوز مدة الصوت المصدر
  • اضبط callback_url أو external_task_id فقط عندما تحتاج إلى تسليم عبر webhook أو إلى معرّف تتبع خاص بك

تدفق المهمة

1

حدّد الوجوه أولًا

شغّل Lip-Sync على فيديو المصدر واحتفظ بقيمة session_id المُعادة بالإضافة إلى قيم face_id المستهدفة.
2

أنشئ مهمة مزامنة الشفاه المتقدمة

أرسل session_id ومصفوفة face_choose عبر نقطة النهاية هذه.
3

تتبّع المهمة المُنشأة

احفظ معرّف المهمة المُعاد للتحقق من الحالة واسترجاع النتيجة النهائية.
للاطلاع على المرجع الكامل للمعلمات، راجع وثائق Kling الرسمية.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
session_id
string
مطلوب

Session id returned by identify-face.

face_choose
object[]
مطلوب

One or more face/audio mappings to synthesize.

Minimum array length: 1
callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

الاستجابة

200 - application/json

Task accepted.

code
integer
مطلوب
message
string
مطلوب
data
object
مطلوب