FAfacephi
Authentication

POST /api/v1/authentication

Este endpoint se utiliza para autenticar una voz. Recibe un archivo de audio y una plantilla de voz, y devuelve un valor booleano que indica si la voz pertenece a la misma persona que la de la plantilla de voz, así como una probabilidad que indica la similitud entre ambas voces.

Request

Request body

audiostring required

Buffer de audio en bruto en formato WAV, OPUS/OGG, MP3 o AAC, codificado en base64 RFC4648. El audio puede estar cifrado o no.

templatestring required

Buffer de la plantilla biométrica (template), obtenido de Enrollment(), cifrado y codificado en base64 RFC4648.

check_livenessboolean

Si es true, se realizará una prueba de vida (liveness)

check_qualityboolean

Si es true, se realizará una comprobación de calidad

liveness_thresholdnumber

Umbral para la detección de vida (liveness). Si la probabilidad de vida es inferior a este valor, el audio se considera inválido.

minimum_snr_dbnumber

SNR mínimo en dB para que el audio se considere válido.

minimum_speech_duration_msnumber

Duración mínima del audio en milisegundos para que se considere válido.

minimum_speech_relative_lengthnumber

Longitud relativa mínima del habla (longitud del habla en relación con la duración total del audio).

maximum_multiple_speakers_detector_scorenumber

Puntuación máxima permitida del detector de múltiples hablantes.

extra_datastring

Datos tokenizados para invocar al servicio Api Tracking tras la operación, codificados en base64.

Response

El resultado de la autenticación. Los campos *_detected solo están presentes cuando falla la comprobación de calidad del audio.

operation_resultnumber

Resultado de la operación.

matchboolean

Indica si el audio coincide con la plantilla (template)

liveness_scorenumber

Probabilidad de vida (liveness)

matching_scorenumber

Probabilidad de coincidencia (matching)

snr_db_detectednumber

SNR en dB detectado en el audio.

speech_length_ms_detectednumber

Duración del habla en milisegundos detectada en el audio.

speech_relative_length_detectednumber

Longitud relativa del habla detectada en el audio.

multiple_speakers_score_detectednumber

Puntuación de múltiples hablantes detectada en el audio.

tracking_statusnumber

Estado devuelto por el servicio Api Tracking, o -1 si no se requiere tracking.

tracking_messagestring

Mensaje devuelto por el servicio Api Tracking, o vacío si no se requiere tracking.

Changes

No recorded changes to this operation across all 1 revision of this API.