Pular para o conteúdo
Petal

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.

  1. Abra o TextEdit e clique em um documento novo.
  2. Use o atalho do VoiceInk e diga uma frase clara.
  3. 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.
  1. Abra Ajustes do Sistema > Privacidade e Segurança > Microfone e confirme que o VoiceInk está ativado.
  2. Abra Ajustes do Sistema > Privacidade e Segurança > Acessibilidade e confirme que o VoiceInk está ativado.
  3. 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

  1. Na barra lateral do VoiceInk, abra Audio.
  2. 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.
  3. Se você acabou de conectar um dispositivo novo, clique em Refresh Microphones.
  4. 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".

  1. Abra Modes na barra lateral.
  2. Confirme que o Mode que você usa está ativado.
  3. Confirme que ele tem um modelo de transcrição válido e que o provedor ou o modelo local está disponível.
  4. Confirme que o ajuste de idioma corresponde à sua fala.
  5. 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 .bin importado, 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:

  1. Confirme que o Mode usa a saída Paste.
  2. Clique no campo de destino antes de gravar.
  3. Confirme a Acessibilidade (Passo 2).
  4. Abra Settings > Pasting e mude o Paste Method de Default para AppleScript.
  5. 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

  1. Faça um teste para descobrir qual etapa falha: captura, modelo ou colagem.
  2. Confirme Microfone e Acessibilidade e reinicie o VoiceInk.
  3. Depois de um novo build, redefina a permissão de Acessibilidade com o tccutil.
  4. Selecione o microfone em Audio e confirme o nível nos ajustes de Som.
  5. Confira se o Mode está ativado, tem um modelo válido e usa a saída Paste.
  6. Confirme que o modelo foi baixado ou que a chave da nuvem e a rede funcionam.
  7. 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.

SoluçõesMac

Ditado do Mac no idioma errado: como resolver

Ditado do Mac no idioma errado? Adicione o idioma em Teclado > Ditado, troque o idioma ao ditar, confira a fonte de entrada e conclua o download.

SoluçõesMac

Spokenly não funciona no Mac: como resolver

Spokenly não funciona no Mac? Corrija Microfone e Acessibilidade, o atalho, o download de modelos locais, o Local-only mode e falhas na colagem.