Sign in
latestOpenAPI 3.0.02026-08-1077206128.1 KB

acc985032f98

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.

post/api/v1/authentication

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.