Pontue o som que o aluno acabou de errar.
Escolas de idiomas precisam que o aluno fale todos os dias. Um professor não senta com cada aluno em cada fonema. A API devolve uma nota por som, por palavra e por frase para o próximo treino ficar óbvio.
O problema na sala de idiomas
Uma nota na frase inteira
A lição de fala volta como passou/não passou ou um selo vago de sotaque. O aluno não sabe qual som corrigir, então a próxima tentativa é um chute.
Avaliadores humanos não acompanham o ritmo diário
Dois professores não marcam a mesma gravação do mesmo jeito. Também não escutam cada treino diário de uma turma inteira.
Transcrição não é retorno
Fala-para-texto escreve o que foi dito. Não diz ao aluno o quão perto cada som ficou da frase-alvo.
O que a API devolve
Uma nota em cada som
Notas de fone, palavra e frase na escala 0–100. Pinte isso na interface da lição. A repetição é a mesma frase, não uma nova.
Comparável de uma tentativa para a outra
O mesmo enunciado, pontuado do mesmo jeito, é o que torna o hábito diário de fala possível. O número precisa significar a mesma coisa amanhã.
O resto da lição fica no mesmo produto
Uma chave para pronúncia, fala-para-texto e síntese. O curso não cria uma segunda pilha de áudio só para enviar o exercício.
Execute: pontue a pronúncia
Isto é uma chamada de pronúncia, não um rótulo de texto. Envie um clipe curto da frase-alvo e leia as notas nesta página.
- Hello90
- world82
- overall86
{
"overallScore": 86,
"sentenceScore": 84,
"decodedTranscript": "Hello world",
"words": [
{ "word": "Hello", "score": 90 },
{ "word": "world", "score": 82 }
]
}Resposta de exemplo de POST /v1/pronunciation/assess/base64. Rode a mesma chamada abaixo com o seu áudio.
Faça sua primeira chamada agora
Uma primeira chamada com pontuação. As notas por palavra e por fonema aparecem nesta página.
O áudio de exemplo da frase de referência já está carregado. Rode a chamada ou troque o arquivo.
POST /v1/pronunciation/assess/base64{
"audio": "<base64-wav>",
"text": "Hello world"
}O áudio de exemplo está carregado. Você pode trocá-lo pela sua gravação da frase de referência.
Preparando sua chave de API…
Resultado de exemplo
Hello world
Pontuação por fonema
Todos os fonemas da frase
curl -X POST https://api.brainiall.com/v1/pronunciation/assess/base64 \
-H "Authorization: Bearer $BRAINIALL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio":"<base64-wav>","text":"Hello world"}'{
"name": "Brainiall first call",
"baseUrl": "https://api.brainiall.com",
"authorization": "Bearer $BRAINIALL_API_KEY",
"requests": [
{
"id": "pronunciation",
"method": "POST",
"path": "/v1/pronunciation/assess/base64",
"url": "https://api.brainiall.com/v1/pronunciation/assess/base64",
"body": {
"audio": "UklGRmQBAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YUABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==",
"text": "Hello world"
}
},
{
"id": "tts",
"method": "POST",
"path": "/v1/tts/synthesize",
"url": "https://api.brainiall.com/v1/tts/synthesize",
"body": {
"text": "Hello, welcome.",
"voice": "brainiall-aria"
}
},
{
"id": "nlp",
"method": "POST",
"path": "/v1/nlp/toxicity",
"url": "https://api.brainiall.com/v1/nlp/toxicity",
"body": {
"text": "This product is absolutely amazing"
}
}
]
}O mesmo pedido, pronto para colar fora deste navegador. Troque o marcador pela sua chave — a chave nunca é exibida aqui.
O que muda para o aluno
Ele vê o som que falhou
Uma nota baixa em um fonema é um treino. Um X vermelho na frase inteira não é.
Ele repete no mesmo dia
O curso tenta formar um hábito de fala. O laço é: dizer, ver o som, dizer de novo.
O professor vê a turma, não cada arquivo
Os sons que a turma continua errando aparecem sem reouvir cada gravação.
O número, com a fonte
PCC de fone 0.682 (premium) vs 0.555 entre avaliadores humanos Publicado na página do produto de pronúncia, com o conjunto de teste e a linha de concordância humana.
Pontue o seu próprio áudio
Crie uma chave e rode a mesma chamada de pronúncia. A tela seguinte é este trabalho, não um endpoint genérico de rótulo.
A tela seguinte é o mesmo trabalho: uma chave, depois esta chamada.