Skip to main content
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
      }
    ]
  }
}
Use this endpoint to identify faces in a source video before you run a downstream lip-sync workflow.

​
What this route returns

  • A session_id that groups the current face-detection result
  • A face_data array with one or more detected faces
  • Per-face metadata such as face_id, preview image, and time range

​
When to use it

  • Before you build a lip-sync request for a video with multiple people on screen
  • When you need to choose a specific face instead of relying on auto-selection
  • When you want to preview face coverage before starting a more expensive task
For the complete parameter reference, see the official Kling documentation.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
video_url
string
default:example
required

Public URL of the video to analyze for face identification.

Response

200 - application/json

OK

​
code
integer
required
​
message
string
required
​
request_id
string
required
​
data
object
required