الانتقال إلى المحتوى الرئيسي
POST
/
kling
/
v1
/
videos
/
advanced-lip-sync
Create an advanced Kling lip-sync task
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/advanced-lip-sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "806556222048190514",
  "face_choose": [
    {
      "face_id": "0",
      "sound_file": "https://cdn1.suno.ai/e5c97078-3260-4354-a3a6-1d7249262a48.mp3",
      "sound_start_time": "1200",
      "sound_end_time": "5000",
      "sound_insert_time": "0"
    }
  ]
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
استخدم نقطة النهاية هذه لإنشاء مهمة مزامنة شفاه متقدمة بعد أن تكون قد حدّدت الوجوه بالفعل في فيديو المصدر.

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

  • ابدأ بـ Lip-Sync للحصول على session_id وقيم face_id المتاحة
  • أنشئ إدخالًا واحدًا أو أكثر من face_choose لربط كل وجه بمقطع صوتي
  • تأكد من أن حقول التوقيت توضّح كيفية محاذاة الصوت داخل الفيديو

​
تدفق المهمة

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
افتراضي:806556222048190514
مطلوب

Session id returned by the face identification (lip-sync) endpoint.

​
face_choose
object[]
مطلوب

Face-to-audio mappings. Each entry connects a detected face to an audio segment for lip-sync.

الاستجابة

200 - application/json

Task accepted.

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