Skip to main content
POST
/
kling
/
v1
/
videos
/
identify-face
cURL
curl https://api.cometapi.com/kling/v1/videos/identify-face \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "video_url": "https://your-video-host/source.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

  • 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