Passer au contenu principal
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
      }
    ]
  }
}
Utilisez cet endpoint pour identifier les visages dans une vidéo source avant d’exécuter un workflow de synchronisation labiale en aval.

​
Ce que cette route renvoie

  • Un session_id qui regroupe le résultat actuel de détection des visages
  • Un tableau face_data contenant un ou plusieurs visages détectés
  • Des métadonnées par visage telles que face_id, l’image d’aperçu et la plage temporelle

​
Quand l’utiliser

  • Avant de créer une requête lip-sync pour une vidéo avec plusieurs personnes à l’écran
  • Lorsque vous devez choisir un visage spécifique au lieu de vous fier à la sélection automatique
  • Lorsque vous souhaitez prévisualiser la couverture des visages avant de lancer une tâche plus coûteuse
Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json
​
video_url
string
défaut:example
requis

Public URL of the video to analyze for face identification.

Réponse

200 - application/json

OK

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