> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/sdks/backend-sdk/voice/changelog.md).

# Changelog

## \[3.4.0]

* Se añade FacephiActivationLoad para gestionar y activar la licencia.

## \[3.3.0]

* Se añaden funciones para mejorar la carga de la licencia a partir de los metadatos de cryptlex.
* Se mejora el proceso de registro de la licencia durante la inicialización de Docker.

## \[3.2.1]

* Mejoras menores en la licencia.

## \[3.2.0]

* Nuevo endpoint GET `/api/v1/config` para obtener la configuración actual del servicio.
* Nuevo endpoint POST `/api/v1/config` para actualizar la configuración del servicio sin reiniciarlo.

## \[3.0.1]

* Se corrige un problema de licencia para garantizar el cumplimiento normativo y el correcto funcionamiento de Voice Service.

## \[3.0.0]

* Se introduce el nuevo algoritmo de verificación, que ofrece un rendimiento mejorado respecto a versiones anteriores. El algoritmo anterior sigue disponible por motivos de compatibilidad.
* Se mejora la precisión del algoritmo de detección de vida frente a clonación de voz (voice clone liveness).
* Se mejora la precisión del algoritmo de detección de vida frente a ataques de repetición (presentation/replay attack).
* Se corrige el error `TOO_NOISY` que reportaba el SNR Computer en archivos con silencios prolongados.
* Se actualiza el backend de OpenVINO de la versión 2023.0 a la 2024.4.

## \[2.9.0]

* Se actualiza la versión de la imagen Docker a Ubuntu 24.04.
* El número de hilos (threads) en la configuración del servicio es 1 por defecto.
* Se añade un nuevo algoritmo de verificación con mayor precisión.
* Se mejora la precisión de los algoritmos de verificación y detección de vida en escenarios con ruido. La puntuación de verificación puede diferir ligeramente respecto a la versión anterior, pero las plantillas de voz siguen siendo compatibles.
* El umbral recomendado para la comprobación de calidad de longitud relativa del habla, en los casos de uso de verificación y detección de vida, ahora es 0 (se permite cualquier longitud relativa de habla).
* Se actualiza el algoritmo de estimación de SNR. Los valores estimados pueden diferir de los de la versión anterior del producto, pero la precisión global del algoritmo se mantiene igual.

## \[2.8.0]

* Nueva propiedad `check_quality` en los endpoints de `enrollment` y `authentication` para habilitar o deshabilitar la comprobación de calidad.
* Nueva propiedad `check_liveness` en el endpoint de `authentication` para habilitar o deshabilitar la comprobación de vida (liveness).

## \[2.7.2]

* Mejoras en la comprobación de salud (health check) del servicio.
* Mejoras en la gestión de licencias.

## \[2.7.1]

* Mejoras de concurrencia en la decodificación base64.
* Algunas mejoras menores en el código.

## \[2.7.0]

* Algunas refactorizaciones y mejoras de rendimiento.
* Mejoras de concurrencia.
* Mejoras en la comprobación de salud (health check) del servicio.
* Nuevas comprobaciones sobre la disponibilidad de la licencia.

## \[2.6.0]

* Nuevos parámetros de Quality Check:
  * `minimum_speech_relative_length`: longitud mínima requerida del habla en relación con la duración total del audio.
  * `maximum_multiple_speakers_detector_score`: número máximo de hablantes simultáneos.
* Nuevos campos de respuesta con los valores detectados por el Quality Check:
  * `snr_db_detected`: relación señal-ruido (Signal-to-Noise Ratio) detectada.
  * `speech_length_ms_detected`: longitud del habla detectada.
  * `speech_relative_length_detected`: longitud relativa del habla detectada.
  * `multiple_speakers_score_detected`: puntuación de múltiples hablantes detectada.

## \[2.5.0]

* Soporte para nuevos formatos de audio: AAC, PCM ulaw y mulaw, WMA, MP4, FLAC, ALAC y AIFF.
* Soporte para audios con una frecuencia de muestreo inferior a 16 kHz.
* Se integran eventos de tracking para la autenticación.

## \[2.4.0]

* Se actualiza `voice-sdk` a la v2.4.0.
* Multithreading en el proceso de enrollment.
* Se exponen al usuario las excepciones de bajo nivel.

## \[2.3.1]

* Se actualiza `voice-sdk` a la v2.3.1.
* Se mejoran los mensajes de excepción y error.

## \[2.3.0]

* Se actualiza `voice-sdk` a la v2.3.0.
* Se actualiza `facephi-rest-manager` a la v2.4.2.
* Se añade soporte para el formato de audio AAC.
* Nuevo parámetro de configuración `client_max_body_size` para limitar el tamaño máximo del cuerpo de la petición.

## \[2.2.3]

* Se actualiza `voice-sdk` a la v2.2.3.
* Se añade el campo `operation_result` al resultado de Authentication y Enrollment.
* Se añade el campo `liveness_score` al resultado de Authentication y Enrollment.
* Se añade el campo `matching_score` al resultado de Enrollment.
* Se añade el campo `template_type` al resultado de Enrollment.
* Se renombra el campo `probability` del resultado de Authentication a `matching_score`.
* Se corrige el campo `template` en el resultado de Enrollment. El campo `template` estará vacío si la respuesta no es válida.
* Se corrige el campo `template` cuando se pasaban varios audios a Enrollment pero no se alcanzaba el número mínimo de audios necesario para generar un patrón text-independent.

## \[2.2.2]

* Se actualiza `voice-sdk` a la v2.2.2.
* Se actualiza `facephi-rest-manager` a la v2.4.0.

## \[2.2.0]

* Se añade soporte para `voice-sdk` v2.2.0.
* Los endpoints aceptan audios cifrados y no cifrados.
* La comprobación de calidad puede modularse en la petición, con los nuevos parámetros `minimum_snr_db` y `minimum_speech_duration_ms`.

## \[2.1.0]

* Se actualiza facephi-rest-manager a la versión 2.1.3.

## \[2.0.0]

* Se añade soporte para `voice-sdk` v2.0.0, con audios y plantillas cifrados.
* Refactorización de la implementación de la API REST.
* Nuevo formato de mensaje para los errores de Bad Request e Internal Server Error.

## \[1.3.1]

* Se incluye el código de estado HTTP en la respuesta JSON de error.
* Todos los endpoints pasan a estar en minúsculas.
* Se mejora la gestión y los mensajes de excepciones.
* Se añaden excepciones para los errores de voice-sdk.
* Nuevo endpoint api/v1/version.
* Nuevo endpoint api/v1/health.

## \[1.3.0]

* Nuevo sistema de licencias.
