Reconocimiento facial para sincronización labial

Primer paso de la sincronización labial (`kling-lip-sync`): reconoce los rostros de los medios y obtiene el ID de sesión y los ID de rostro.

POST/v1/kling/faces

Endpoint síncrono, se factura por llamada. El resultado incluye un ID de sesión y los ID de rostro, válidos 24 horas; en el segundo paso póngalos en extra.session_id y extra.face_choose (exactamente un elemento, con face_id y sound_file) de Enviar una tarea de video; el flujo completo está en Sincronización labial.

El cuerpo solo acepta el array videos; cada elemento lleva url o file_id, no ambos, con las mismas reglas que en Localizadores de medios.

Reconocimiento facial para sincronización labial

curl https://api.hop-base.com/v1/kling/faces \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "file_id": "source-video-file-id"
      }
    ]
  }'

200application/json

Devuelve JSON con un ID de sesión e IDs de rostro, válidos durante 24 horas.

Encabezados

Authorization:obligatoriostring

Bearer sk-…: una clave de API creada en la consola; su grupo debe incluir el modelo solicitado

Parámetros del cuerpoJSON

videos:obligatorioarray of object

Medios en los que reconocer rostros; al menos un elemento

Elementos≥ 1

Respuesta

200JSON con el resultado del reconocimiento, con ID de sesión e ID de rostro (válidos 24 horas)

application/json Resultado del reconocimiento facial

Errores

400Solicitud no válida; no se factura. Mensajes originales: request body does not match the JSON contract: …: JSON no válido, campos fuera de la tabla o un segundo valor JSON después del cuerpo videos is required and must contain at least one item videos[<índice>] must provide exactly one of url or file_id videos[<índice>].url must be a publicly accessible absolute http(s) URL

401Falta la clave, la clave no es válida o ha caducado (missing_api_key / invalid_api_key / api_key_expired)

Reconocimiento facial para sincronización labial

Encabezados

Parámetros del cuerpoJSON

Respuesta

Errores

Páginas relacionadas