Saltar al contenido 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
      }
    ]
  }
}
Usa este endpoint para identificar rostros en un video de origen antes de ejecutar un flujo de trabajo posterior de sincronización labial.

​
Qué devuelve esta ruta

  • Un session_id que agrupa el resultado actual de detección de rostros
  • Un arreglo face_data con uno o más rostros detectados
  • Metadatos por rostro, como face_id, imagen de vista previa y rango de tiempo

​
Cuándo usarlo

  • Antes de crear una solicitud de sincronización labial para un video con varias personas en pantalla
  • Cuando necesitas elegir un rostro específico en lugar de depender de la selección automática
  • Cuando quieres previsualizar la cobertura del rostro antes de iniciar una tarea más costosa
Para consultar la referencia completa de parámetros, revisa la documentación oficial de Kling.

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
​
video_url
string
predeterminado:example
requerido

Public URL of the video to analyze for face identification.

Respuesta

200 - application/json

OK

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