API de avaliação de pronúncia
Envie uma gravação e o texto que a pessoa deveria dizer; receba a qualidade da pronúncia de cada palavra e de cada fonema. A API usa a avaliação de pronúncia do Azure AI Speech no nível do fonema, com prosódia e detecção de desvios do texto ativadas: sem assinatura do Azure para gerenciar, sem conversão de áudio e sem dividir gravações longas.
Ler a documentação da API →Três chamadas
Peça uma URL de envio, envie o arquivo WAV para ela e depois peça a avaliação. Cada chamada leva sua chave no cabeçalho X-API-Key. O áudio é apagado depois de pontuado.
# 1. Ask for an upload URL
curl -X POST https://platform.vocametrix.com/api/get-blob-url \
-H "X-API-Key: $VOCAMETRIX_API_KEY"
# {"uploadURL": "...", "blobURL": "..."}
# 2. Upload the recording
curl -X PUT "$UPLOAD_URL" -H "x-ms-blob-type: BlockBlob" --data-binary @reading.wav
# 3. Score it against the reference text
curl -X POST https://platform.vocametrix.com/api/pronunciation-assessment \
-H "X-API-Key: $VOCAMETRIX_API_KEY" -H "Content-Type: application/json" \
-d "{\"blobURL\": \"$BLOB_URL\", \"referenceText\": \"The weather is nice today\", \"locale\": \"en-US\"}"O que a API devolve
Pontuações de 0 a 100 para precisão (proximidade dos fonemas com um falante nativo), fluência (pausas entre palavras), completude (parte do texto de referência pronunciada) e uma pontuação geral de pronúncia, com o mesmo detalhe por palavra e por fonema. Cada palavra traz também um tipo de erro: omissão, inserção, pronúncia incorreta, pausa inesperada, pausa ausente ou entonação monótona. A resposta segue o formato JSON do Azure.
Idiomas e duração das gravações
O campo locale aceita qualquer idioma suportado pela avaliação de pronúncia do Azure, por exemplo pt-BR, pt-PT, en-US, fr-FR, es-ES ou de-DE. A pontuação de prosódia (acento, entonação, ritmo) só existe em en-US. Gravações com mais de 30 segundos são pontuadas por segmentos; a resposta traz então as pontuações gerais e uma por palavra, sem o detalhe por fonema.
Preços
Você paga os segundos de áudio enviados, sem arredondamento. Os créditos são vendidos em pacotes avulsos, não por assinatura: Developer Pack 40min por 5 EUR e Developer Pack 400min por 15 EUR. Criar a conta é gratuito, mas a API não tem plano gratuito: a primeira chamada já exige um pacote.
SDKs
Clientes oficiais encapsulam essas chamadas: npm install vocametrix para JavaScript e TypeScript, pip install vocametrix para Python.
Medir também a voz
A mesma chave dá acesso às medidas acústicas da voz: AVQI, CPP, jitter, shimmer, HNR e outras.
Perguntas frequentes
Existe plano gratuito?
Não. A conta é gratuita e o site inclui um teste de 7 dias, mas as chamadas à API são pagas com um pacote de créditos desde a primeira.
Onde encontro minha chave de API?
Na sua página de perfil, depois de entrar na Vocametrix.
A gravação fica armazenada?
Não. O arquivo enviado é apagado assim que a avaliação é devolvida.