Cadastro de voz

Serviço que gera um modelo de voz a partir dos áudios da captura e devolve o resultado da validação de cada áudio.

Endpoint

POST /biometric/voice/enrollment

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de consumer no formato Bearer <token>. Ver Autenticação.
consumer-id	string	Sim	Identificador do consumer.

Corpo da solicitação

Content-Type: application/json

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
audios	array	Sim	Áudios da captura, em Base64, na ordem de gravação.

Exemplo de solicitação

{
  "audios": ["<base64 audio 1>", "<base64 audio 2>", "<base64 audio 3>"]
}

Respostas

200 Sucesso

Parâmetros de resposta

Parâmetro	Tipo	Descrição
consumerId	string	Identificador do consumer que realizou a chamada.
transactionId	string	Identificador da transação.
timestamp	string	Carimbo de data e hora da resposta no formato ISO 8601.
message	string	Campo descritivo do resultado da execução do serviço.
operationResult	integer	Código de resultado da execução do serviço.
template	string	Modelo de voz resultante.
templateType	string	Tipo de modelo gerado.
validateAudiosResult	array	Resultado por áudio. Ver Resultado por áudio.

Resultado por áudio

Parâmetro	Tipo	Descrição
audio_position	integer	Posição do áudio na solicitação.
result_code	integer	Código de resultado do áudio.
matching_score	number	Pontuação de correspondência do áudio.
snr_db_detected	number	Relação sinal-ruído detectada, em decibéis.
speech_length_ms_detected	integer	Duração da fala detectada, em milissegundos.
speech_relative_length_detected	number	Proporção da fala em relação à duração total.
multiple_speakers_score_detected	number	Pontuação de detecção de vários falantes.

Outras respostas

Código	Descrição
400	Campo obrigatório ausente ou áudio em formato não suportado.
401	Token ausente, inválido ou expirado.
403	O consumer não está provisionado com o serviço VOICE_ENROLLMENT.

O corpo de uma resposta de erro tem o formato descrito em MIDAPI v2.