Vai al contenuto principale
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
      }
    ]
  }
}
Usa questo endpoint per identificare i volti in un video sorgente prima di eseguire un flusso di lavoro lip-sync a valle.

​
Cosa restituisce questa route

  • Un session_id che raggruppa il risultato corrente del rilevamento dei volti
  • Un array face_data con uno o più volti rilevati
  • Metadati per volto come face_id, immagine di anteprima e intervallo temporale

​
Quando usarlo

  • Prima di creare una richiesta lip-sync per un video con più persone sullo schermo
  • Quando devi scegliere un volto specifico invece di affidarti alla selezione automatica
  • Quando vuoi visualizzare in anteprima la copertura del volto prima di avviare un’attività più costosa
Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
​
video_url
string
predefinito:example
obbligatorio

Public URL of the video to analyze for face identification.

Risposta

200 - application/json

OK

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