الانتقال إلى المحتوى الرئيسي
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
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

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

  • ابدأ بـ 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
مطلوب