> 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/docs.facephi-en/sdks/backend-sdk/voice.md).

# Voice Service

**Facephi Voice Service** is a Rest API service to which audio files can be sent for processing and to obtain the result of the voice recognition process. The service offers a service to register (enroll) a new voice, and another to authenticate a voice.

The product is aimed at speaker verification and voice liveness detection. It is based on the use of a voice template, a text string that contains the biometric information of the voice. This voice template can be used to authenticate voices in the future.

Optional JWT authentication can be enabled at startup from `config.json` or through the environment variables `FACEPHI_VOICE_REST_AUTH_*`. When JWT is enabled, `GET /api/v1/version` and `GET /api/v1/health` remain public, while protected endpoints require a valid JWT. The JWT startup configuration is never exposed through `GET /api/v1/config` nor can it be modified through `POST /api/v1/config`.

The supported audio formats are:

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

The main distribution contains the following resources:

* Docker container. The container is available in the FacePhi Docker repository and is based on Ubuntu 24.04. The container includes the service and all the dependencies needed to run it.
* Online documentation. The documentation is available at the following URL: <https://doc-voice-service.facephi.dev/>
