SoluçõesMac8 min de leitura
VoiceInk não transcreve: descubra onde está a falha
VoiceInk não transcreve? Confira a captura do microfone, depois o Mode e o modelo e, por fim, a colagem, com os diagnósticos oficiais do VoiceInk.
Publicado pela Optimal Apps, criadora do Petal.
Nesta página
Quando o VoiceInk não transcreve, a falha está em uma de três etapas: a captura do microfone, a etapa do modelo ou a etapa da colagem. O guia oficial do VoiceInk "Transcription Failing or No Output" confere essas etapas nessa ordem. Primeiro, confirme Microfone e Acessibilidade em Ajustes do Sistema > Privacidade e Segurança e reinicie o VoiceInk. Depois, abra Audio na barra lateral do VoiceInk e confirme a entrada. Em seguida, confira se o Mode ativo tem um modelo de transcrição válido e se o modelo foi baixado em AI Models. Se o texto aparece no VoiceInk, mas não no seu app, o problema é a colagem.
Checklist de solução rápida
| Sintoma | Etapa que falha | Solução |
|---|---|---|
| O gravador não mostra nível de áudio | Captura | Selecione o microfone em Audio; confira Som > Entrada |
| Nenhum resultado após mudar uma permissão | Captura | Reinicie o VoiceInk |
| O novo microfone não aparece na lista | Captura | Clique em Refresh Microphones |
| O Mode não dá resultado | Modelo | Ative o Mode e escolha um modelo válido |
| O modelo local não devolve nada | Modelo | Baixe o modelo em AI Models; confira os arquivos .bin importados |
| O modelo na nuvem falha | Modelo | Confira a chave de API e a rede |
| O texto aparece no VoiceInk, mas não no seu app | Colagem | Siga o guia de colagem |
| O texto está errado, e não ausente | Modelo | Teste outro modelo; adicione termos ao Vocabulary |
Passo 1: Descubra em três partes por que o VoiceInk não transcreve
Faça um teste antes de mudar os ajustes.
- Abra o TextEdit e clique em um documento novo.
- Use o atalho do VoiceInk e diga uma frase clara.
- Observe o gravador enquanto fala e depois procure o resultado no histórico do VoiceInk.
Agora localize a falha:
- O nível de áudio não se move. A etapa de captura falha. Vá para o Passo 2.
- O nível se move, mas não há texto no VoiceInk. A etapa do modelo falha. Vá para o Passo 4.
- O VoiceInk mostra o texto, mas o TextEdit está vazio. A etapa da colagem falha. Vá para o Passo 6.
Passo 2: Confira as permissões
A documentação do VoiceInk lista três permissões:
- Microfone é obrigatório para gravar.
- Acessibilidade é necessária para uma colagem confiável e para usar o texto selecionado como contexto.
- Gravação de Tela só é necessária quando um Mode usa o contexto da tela.
- Abra Ajustes do Sistema > Privacidade e Segurança > Microfone e confirme que o VoiceInk está ativado.
- Abra Ajustes do Sistema > Privacidade e Segurança > Acessibilidade e confirme que o VoiceInk está ativado.
- Reinicie o VoiceInk depois de qualquer mudança. A documentação do VoiceInk diz que esse passo é necessário.
Se você compilou o VoiceInk a partir do código-fonte ou instalou um build novo, o botão pode aparecer ativado e ainda assim falhar. O macOS vincula a permissão de Acessibilidade à assinatura de código do app, e uma assinatura nova não corresponde à permissão antiga. A issue #530 do VoiceInk no GitHub traz a solução: rode tccutil reset Accessibility com.prakashjoshipax.VoiceInk no Terminal, abra o VoiceInk de novo e conceda a Acessibilidade de novo.
Para um guia geral, leia permissão de microfone no Mac.
Passo 3: Confira a entrada de áudio
- Na barra lateral do VoiceInk, abra Audio.
- Use Selected Microphone para escolher um dispositivo. Ou use Priority Order para que o VoiceInk passe por vários dispositivos quando um deles não estiver disponível.
- Se você acabou de conectar um dispositivo novo, clique em Refresh Microphones.
- Abra Ajustes do Sistema > Som > Entrada, fale e confirme que o nível de entrada se move no mesmo dispositivo.
Por que funciona: o VoiceInk grava pelo dispositivo selecionado nele. Se esse dispositivo está desconectado, em repouso ou sem som, o modelo recebe silêncio e não devolve nada.
O VoiceInk sugere o microfone embutido do Mac ou um microfone externo dedicado, em vez do microfone de um fone sem fio. Fones Bluetooth costumam mudar para um modo de baixa qualidade quando usam o microfone. Veja microfone Bluetooth e ditado no Mac.
Também existe um relato aberto (issue #916 no GitHub) em que o VoiceInk salvou áudio totalmente mudo em uma configuração e só gravou corretamente enquanto o Ditado do macOS rodava ao mesmo tempo. Se o medidor de nível se move nos ajustes de Som, mas o VoiceInk grava silêncio, cite essa issue quando reportar o problema.
Passo 4: Confira o Mode ativo
Os Modes definem qual modelo e qual saída o VoiceInk usa. Um Mode com o ajuste errado é uma causa comum de "nenhum resultado".
- Abra Modes na barra lateral.
- Confirme que o Mode que você usa está ativado.
- Confirme que ele tem um modelo de transcrição válido e que o provedor ou o modelo local está disponível.
- Confirme que o ajuste de idioma corresponde à sua fala.
- Confira o tipo de saída: Paste insere o texto, Respond mostra uma resposta no gravador e Custom Command envia o texto para o seu comando. Se a saída é Respond, nenhum texto vai para o seu app, e isso é intencional.
Passo 5: Resolva o modelo do VoiceInk que não carrega
Abra AI Models e confira o modelo que o Mode usa.
Modelos locais
- Confirme que o modelo foi baixado.
- Para um arquivo Whisper
.binimportado, confirme que o arquivo ainda existe e pode ser lido. Se você moveu ou apagou o arquivo, importe de novo. - Modelos só de streaming exigem o modo Real-time. Arquivos importados exigem um modelo que aceite processamento em lote.
- O Apple Speech exige o macOS 26 ou posterior e o recurso do idioma instalado.
- O aprimoramento VoiceInk Refine exige Apple silicon, pelo menos 16 GB de RAM e um modelo Refine baixado.
Em Macs Intel, a documentação do VoiceInk diz que a transcrição na nuvem normalmente funciona melhor, porque os modelos locais ficam lentos nesses Macs. Um modelo lento pode parecer que não dá resultado.
Provedores na nuvem
- Confirme que a chave de API está definida e que o provedor aceita transcrição.
- Para um modelo personalizado, confira o caminho do endpoint, a chave de API e o nome do modelo. O VoiceInk avisa que salvar não testa a conexão, então um erro de digitação só falha na hora da transcrição.
- Confira a rede. Na issue #1010 do GitHub, um usuário em uma rede corporativa viu um erro de transcrição. A causa era um modelo na nuvem selecionado por engano. A solução foi baixar o modelo local e defini-lo nos Modes.
Passo 6: Separe um problema de colagem
Se o VoiceInk mostra a transcrição, mas o seu app continua vazio, a transcrição funciona. A colagem falha. O guia de área de transferência do VoiceInk traz estes passos:
- Confirme que o Mode usa a saída Paste.
- Clique no campo de destino antes de gravar.
- Confirme a Acessibilidade (Passo 2).
- Abra Settings > Pasting e mude o Paste Method de Default para AppleScript.
- Se o conteúdo antigo da área de transferência for colado, aumente o Restore Delay. O padrão é de 2 segundos, e o intervalo vai de 250 ms a 5 segundos.
O guia completo está em VoiceInk não cola o texto.
Passo 7: Se o texto está errado, e não ausente
Se o VoiceInk transcreve, mas o texto tem erros:
- Teste outro modelo no Mode. A documentação do VoiceInk sugere o Parakeet V3 para ditado local rápido nos Macs compatíveis.
- Adicione correções fixas em Word Replacements e nomes importantes em Vocabulary.
- Fique mais perto do microfone e reduza o ruído de fundo.
Passo 8: Colete diagnósticos
Se nenhum dos passos funcionar, use o Diagnostics and Support do VoiceInk para coletar informações do sistema ou exportar os logs. Revise os logs antes de compartilhar e depois reporte o problema no GitHub do VoiceInk ou ao suporte dele.
Petal: um build assinado e grátis com modelos no Mac
O código-fonte do VoiceInk usa a licença GPL v3, e você pode compilá-lo de graça. O build assinado e pronto para usar é uma licença paga, com pagamento único. Se você quer um build assinado e pronto sem custo, o Petal para Mac é uma opção. Ele é grátis e de código aberto (MIT), da Optimal Apps, a editora deste site. O download no GitHub Releases é assinado com um Developer ID e se atualiza pelo Sparkle, então as permissões do macOS continuam vinculadas à mesma assinatura entre as versões.
Como o Petal lida com as mesmas três etapas:
- Captura. Escolha o dispositivo em Settings > Recording > Microphone ou mantenha Default para seguir o sistema.
- Modelo. Baixe um modelo de fala em Settings > Models. O Parakeet 110M é o modelo leve recomendado para inglês. O Parakeet 0.6B V3 cobre 25 idiomas europeus, incluindo o português, o Whisper Large V3 Turbo cobre 99 idiomas e o Apple Speech não precisa de download. Todos rodam no seu Mac. O Petal mantém a necessidade de RAM do modelo padrão abaixo de 8 GB.
- Colagem. O Petal cola no app em primeiro plano e restaura a área de transferência 700 ms depois, para que apps Electron lentos recebam o texto certo. Se a Acessibilidade estiver desativada, o Petal copia a transcrição em vez de colar.
Cada gravação e transcrição fica salva no histórico, e o Transcribe Again processa o áudio salvo de novo. A limpeza com o Petal W1 também roda no seu Mac. O Petal exige o macOS 26.2 ou posterior.
Para uma comparação lado a lado, leia Petal vs VoiceInk ou alternativa ao VoiceInk para Mac.
Resumo
- Faça um teste para descobrir qual etapa falha: captura, modelo ou colagem.
- Confirme Microfone e Acessibilidade e reinicie o VoiceInk.
- Depois de um novo build, redefina a permissão de Acessibilidade com o
tccutil. - Selecione o microfone em Audio e confirme o nível nos ajustes de Som.
- Confira se o Mode está ativado, tem um modelo válido e usa a saída Paste.
- Confirme que o modelo foi baixado ou que a chave da nuvem e a rede funcionam.
- Se o texto aparece no VoiceInk, mas não no seu app, resolva a etapa da colagem.
Perguntas
Por que o VoiceInk não transcreve nada?
A documentação do VoiceInk cita cinco causas comuns: uma permissão do macOS ausente, o microfone errado, um Mode com ajustes inesperados, um modelo local lento demais para o Mac ou o tempo da colagem no app de destino. Confira nessa ordem.
Por que o VoiceInk não mostra resultado com um modelo local?
Confirme que o modelo foi baixado em AI Models e está selecionado no Mode ativo. Para um arquivo Whisper .bin importado, confirme que o arquivo ainda existe e pode ser lido. Modelos só de streaming exigem o modo Real-time.
O VoiceInk precisa de internet?
Não com um modelo local baixado. Um provedor de transcrição na nuvem precisa de internet e de uma chave de API válida. Se a transcrição falha na rede do trabalho, confira se o Mode não usa um modelo na nuvem por engano.
Existe uma alternativa grátis e assinada ao VoiceInk?
O Petal para Mac é grátis e de código aberto, e a versão no GitHub é um build assinado. Ele roda Parakeet, Whisper, Qwen3 ASR e outros modelos de fala no seu Mac.