Skip to main content
POST
cURL
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

  • Send exactly one source: video_id for a completed Kling video, or video_url for a hosted MP4 or MOV
  • 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_id
string
required

Kling video id from a completed task. Send either video_id or video_url.

video_url
string

Public MP4 or MOV URL. Send either video_id or video_url.

Response

200 - application/json

OK

code
integer
required
message
string
required
request_id
string
required
data
object
required
Last modified on June 25, 2026