v1

latestOpenAPI 3.1.02026-07-224941145.6 KB

Identify Face

Analyze a video and detect all human faces in it. Returns a session_id and a face_list that are required for the subsequent lip sync generation step.

This is a synchronous call — the result is returned immediately, not as an async task.

post/kling/v1/videos/identify-face

Request body

video_urlstring

Public URL of the video to analyze. The video must contain at least one clearly visible human face. Required if video_id is not provided.

video_idstring

ID of a video previously generated by Kling (e.g. from a text-to-video or image-to-video task result). Required if video_url is not provided.

Example request

{
  "video_url": "https://example.com/person-speaking.mp4",
  "video_id": "860260754053148756"
}

Response

Face detection successful

codeinteger

messagestring

Example response

{
  "message": "SUCCEED",
  "data": {
    "session_id": "abc123-session-id",
    "face_list": [
      {
        "face_id": "face_001",
        "face_rect": {
          "x": 120,
          "y": 80,
          "width": 200,
          "height": 250
        }
      }
    ]
  }
}