Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt

Use this file to discover all available pages before exploring further.

Model ID 
kling-identify-face

​
Kling Identify Face

Detects every distinct human face that appears in a source video and returns:
  • A session_id that uniquely identifies this analysis pass
  • A face_data array describing each detected face (face_id, face_image, start_time, end_time in milliseconds)

​
Typical Workflow

  1. Submit a video via kling-identify-face and inspect the returned face_data to pick which face(s) to lip-sync.
  2. Submit a follow-up kling-lip-sync request using the returned session_id plus a face_choose array referencing the desired face_ids.
This is a synchronous endpoint, the result is returned in the outcome.data field of the SubmitRequest response, no callback polling required.

​
Video Requirements

​
API Usage

Submit a generation task via the GMI request queue. Polling and full parameter docs are in the API reference.

​
Submit request

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer $GMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-identify-face",
    "payload": {
      "prompt": "your prompt here"
    }
  }'
The response includes a request_id. Poll the status endpoint until the video is ready, then download from the returned URL. 
curl "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/<request_id>" \
  -H "Authorization: Bearer $GMI_API_KEY"