---
title: "POST /api/v1/authentication"
method: POST
path: "/api/v1/authentication"
tags: ["Authentication"]
---

# POST /api/v1/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 body

- AuthenticationBody — Cuerpo (body) de la petición de authentication
  - `audio` string, 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.
  - `template` string, required — Buffer de la plantilla biométrica (template), obtenido de Enrollment(), cifrado y codificado en base64 RFC4648.
  - `check_liveness` boolean — Si es true, se realizará una prueba de vida (liveness)
  - `check_quality` boolean — Si es true, se realizará una comprobación de calidad
  - `liveness_threshold` number — 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_db` number — SNR mínimo en dB para que el audio se considere válido.
  - `minimum_speech_duration_ms` number — Duración mínima del audio en milisegundos para que se considere válido.
  - `minimum_speech_relative_length` number — Longitud relativa mínima del habla (longitud del habla en relación con la duración total del audio).
  - `maximum_multiple_speakers_detector_score` number — Puntuación máxima permitida del detector de múltiples hablantes.
  - `extra_data` string — Datos tokenizados para invocar al servicio Api Tracking tras la operación, codificados en base64.

## Response `200`

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

- AuthenticationResponse — Respuesta de authentication
  - `operation_result` number — Resultado de la operación.
  - `match` boolean — Indica si el audio coincide con la plantilla (template)
  - `liveness_score` number — Probabilidad de vida (liveness)
  - `matching_score` number — Probabilidad de coincidencia (matching)
  - `snr_db_detected` number — SNR en dB detectado en el audio.
  - `speech_length_ms_detected` number — Duración del habla en milisegundos detectada en el audio.
  - `speech_relative_length_detected` number — Longitud relativa del habla detectada en el audio.
  - `multiple_speakers_score_detected` number — Puntuación de múltiples hablantes detectada en el audio.
  - `tracking_status` number — Estado devuelto por el servicio Api Tracking, o -1 si no se requiere tracking.
  - `tracking_message` string — Mensaje devuelto por el servicio Api Tracking, o vacío si no se requiere tracking.

## Other responses

- `400` — Han llegado parámetros incorrectos en la petición.
- `500` — Se ha producido un error en la llamada al backend de Voice-SDK.

---

[API](https://skmtc.net/facephi/apis/selphid-sdk-rest-api.md) · [All operations](https://skmtc.net/facephi/apis/selphid-sdk-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/facephi/selphid-sdk-rest-api/revisions/acc985032f98/schema)