Skip to main content
POST
cURL
Usa este endpoint para identificar rostros en un video de origen antes de ejecutar un flujo de trabajo posterior de lip-sync.

Qué devuelve esta ruta

  • Un session_id que agrupa el resultado actual de detección de rostros
  • Un array 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

  • Envía exactamente una fuente: video_id para un video de Kling completado, o video_url para un MP4 o MOV alojado
  • Antes de crear una solicitud de lip-sync para un video con varias personas en pantalla
  • Cuando necesites elegir un rostro específico en lugar de depender de la selección automática
  • Cuando quieras previsualizar la cobertura del rostro antes de iniciar una tarea más costosa
Para la referencia completa de parámetros, consulta la documentación oficial de Kling.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
video_id
string
requerido

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.

Respuesta

200 - application/json

OK

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