Przejdź do głównej treści
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
      }
    ]
  }
}
Użyj tego endpointu, aby zidentyfikować twarze w źródłowym wideo przed uruchomieniem dalszego workflow synchronizacji ruchu warg.

Co zwraca ten endpoint

  • session_id, który grupuje bieżący wynik wykrywania twarzy
  • Tablicę face_data zawierającą co najmniej jedną wykrytą twarz
  • Metadane dla każdej twarzy, takie jak face_id, obraz podglądu i zakres czasu

Kiedy go używać

  • Zanim zbudujesz żądanie lip-sync dla wideo z wieloma osobami widocznymi na ekranie
  • Gdy musisz wybrać konkretną twarz zamiast polegać na automatycznym wyborze
  • Gdy chcesz sprawdzić pokrycie twarzy w podglądzie przed rozpoczęciem bardziej kosztownego zadania
Pełne informacje o parametrach znajdziesz w oficjalnej dokumentacji Kling.

Autoryzacje

Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Treść

application/json
video_url
string
domyślnie:example
wymagane

Public URL of the video to analyze for face identification.

Odpowiedź

200 - application/json

OK

code
integer
wymagane
message
string
wymagane
request_id
string
wymagane
data
object
wymagane