API de análise de voz
A API da Vocametrix leva para a sua aplicação as medidas acústicas da voz usadas na fonoaudiologia: AVQI, ABI, CPP, jitter, shimmer, HNR, DSI, CSID, GNE, H1-H2, formantes, relação S/Z e mais. As medidas principais são calculadas com o Praat 6.4.60 e as mesmas configurações do site da Vocametrix, então seus valores coincidem com os que os clínicos veem lá.
Ler a documentação da API →Duas chamadas
Envie uma gravação para obter um identificador de arquivo e depois peça uma medida sobre esse identificador. Cada chamada leva sua chave no cabeçalho X-API-Key. Os arquivos podem ter até 50 MB.
# 1. Upload a sustained vowel
curl -X POST https://platform.vocametrix.com/api/assignFileId \
-H "X-API-Key: $VOCAMETRIX_API_KEY" -F "audio=@vowel_a.wav"
# {"fileId": "..."}
# 2. Compute jitter and shimmer on it
curl "https://platform.vocametrix.com/api/jitter-shimmer?svFileId=$FILE_ID" \
-H "X-API-Key: $VOCAMETRIX_API_KEY"Medidas disponíveis
A maioria das medidas usa uma vogal sustentada (svFileId): calculate-cpp, jitter-shimmer, calculate-hnr-multiband (com idade e sexo opcionais), calculate-gne, calculate-h1-h2, calculate-dsi, calculate-formant-statistics, calculate-voice-dynamics e calculate-spectral-advanced. calculate-avqi (versões 02.03 e 03.01) e calculate-abi usam também fala encadeada (csFileId), e calculate-csid apenas fala encadeada. POST /api/voice-assessment faz uma avaliação combinada a partir de uma vogal e de uma amostra de fala em uma única chamada.
Como as medidas são calculadas
A página de métodos detalha os comandos do Praat, as configurações e as referências publicadas por trás de cada medida. A resposta de jitter-shimmer informa também a qualidade da gravação, para descartar uma tomada curta ou ruidosa demais antes de confiar nos valores.
Preços
Você paga os segundos de áudio que cada chamada analisa, 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 e assistentes
Clientes oficiais encapsulam essas chamadas: npm install vocametrix para JavaScript e TypeScript, pip install vocametrix para Python. As medidas também estão disponíveis para o Claude e outros assistentes pelo servidor MCP da Vocametrix.
Veja também
Pontue a pronúncia em relação a um texto de referência com a mesma chave, ou use as medidas sem código no site.
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.
Preciso instalar o Praat?
Não. O Praat roda no servidor da Vocametrix; você só envia áudio e lê JSON.
A assinatura do site inclui a API?
Não. A assinatura do site e os pacotes de créditos da API são produtos separados.