Skip to main content
POST
cURL
Utilisez ce endpoint pour identifier les visages dans une vidéo source avant d’exécuter un workflow de lip-sync 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

  • Envoyez exactement une seule source : video_id pour une vidéo Kling terminée, ou video_url pour un MP4 ou MOV hébergé
  • Avant de créer une requête de 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 démarrer 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_id
string
requis

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.

Réponse

200 - application/json

OK

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