> 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.md).

# Voice Service

**Facephi Voice Service** es un servicio API REST al que se pueden enviar archivos de audio para su procesamiento y obtener el resultado del proceso de reconocimiento de voz. El servicio ofrece un servicio para registrar (enroll) una nueva voz, y otro para autenticar una voz.

El producto está orientado a la verificación de hablante (speaker verification) y a la detección de vida en voz (voice liveness detection). Se basa en el uso de una plantilla de voz (voice template), una cadena de texto que contiene la información biométrica de la voz. Esta plantilla de voz puede utilizarse para autenticar las voces en el futuro.

La autenticación JWT opcional puede habilitarse en el arranque desde `config.json` o mediante las variables de entorno `FACEPHI_VOICE_REST_AUTH_*`. Cuando el JWT está habilitado, `GET /api/v1/version` y `GET /api/v1/health` siguen siendo públicos, mientras que los endpoints protegidos requieren un JWT válido. La configuración de arranque del JWT nunca se expone mediante `GET /api/v1/config` ni puede modificarse mediante `POST /api/v1/config`.

Los formatos de audio soportados son:

* WAV
* MP3
* Opus/OGG
* AAC
* WMA
* PCM ulaw y mulaw
* FLAC
* ALAC (mov)
* MP4
* AIFF

La distribución principal contiene los siguientes recursos:

* Contenedor Docker. El contenedor está disponible en el repositorio Docker de FacePhi y está basado en Ubuntu 24.04. El contenedor incluye el servicio y todas las dependencias necesarias para ejecutarlo.
* Documentación en línea. La documentación está disponible en la siguiente URL: <https://doc-voice-service.facephi.dev/>
