> 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-pt-br/sdks/backend-sdk/voice.md).

# Voice Service

**Serviço de Voz Facephi** é um serviço API Rest ao qual podem ser enviados arquivos de áudio para processamento e para obter o resultado do processo de reconhecimento de voz. O serviço oferece um serviço para registrar (enroll) uma nova voz e outro para autenticar uma voz.

O produto é voltado para a verificação de falante (speaker verification) e para a detecção de vida em voz (voice liveness detection). Baseia-se no uso de um template de voz (voice template), uma cadeia de texto que contém a informação biométrica da voz. Esse template de voz pode ser usado para autenticar as vozes no futuro.

A autenticação JWT opcional pode ser habilitada na inicialização a partir de `config.json` ou por meio das variáveis de ambiente `FACEPHI_VOICE_REST_AUTH_*`. Quando o JWT está habilitado, `GET /api/v1/version` e `GET /api/v1/health` permanecem públicos, enquanto os endpoints protegidos exigem um JWT válido. A configuração de inicialização do JWT nunca é exposta por meio de `GET /api/v1/config` nem pode ser modificada por meio de `POST /api/v1/config`.

Os formatos de áudio suportados são:

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

A distribuição principal contém os seguintes recursos:

* Contêiner Docker. O contêiner está disponível no repositório Docker da FacePhi e é baseado em Ubuntu 24.04. O contêiner inclui o serviço e todas as dependências necessárias para executá-lo.
* Documentação on-line. A documentação está disponível no seguinte URL: <https://doc-voice-service.facephi.dev/>