الانتقال إلى المحتوى الرئيسي
POST
/
kling
/
v1
/
videos
/
identify-face
Lip-Sync
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/identify-face \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "https://replicate.delivery/xezq/lZfr3rskBEVLDCytear4lUo92fOpAcoblFWzk6e06WEnC3PTB/tmpny051d_c.mp4"
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "session_id": "<string>",
    "face_data": [
      {
        "face_id": "<string>",
        "face_image": "<string>",
        "start_time": 123,
        "end_time": 123
      }
    ]
  }
}
استخدم هذا الـ endpoint لتحديد الوجوه في فيديو المصدر قبل تشغيل سير عمل لاحق لمزامنة حركة الشفاه.

ما الذي يعيده هذا المسار

  • session_id يجمع نتيجة اكتشاف الوجوه الحالية
  • مصفوفة face_data تحتوي على وجه واحد أو أكثر تم اكتشافه
  • بيانات وصفية لكل وجه مثل face_id، وصورة المعاينة، والنطاق الزمني

متى تستخدمه

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

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
video_url
string
افتراضي:example
مطلوب

Public URL of the video to analyze for face identification.

الاستجابة

200 - application/json

OK

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