Vocabulário e substituições no superwhisper: ensine as suas palavras sem piorar o resultado
Por Ryleigh Newman · Publicado em
O superwhisper oferece duas ferramentas para as palavras que ele erra, e elas funcionam de jeitos opostos. As palavras de vocabulário são dicas enviadas junto com o seu áudio, para o modelo ter mais chance de ouvir um nome ou um termo. As substituições rodam depois que o texto já existe e trocam um trecho por outro, exatamente como você definiu. Usar a ferramenta errada, ou dicas demais, é um motivo comum de o superwhisper piorar em vez de melhorar.
Eu criei o YapToText, um app de ditado diferente para o Mac, por isso leia o que digo sobre o superwhisper com isso em mente. Todo fato sobre o superwhisper aqui vem da documentação dele, lida em 10 de outubro de 2026.
Download gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.
Este guia em outros idiomas: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Nesta página: 12 seções
As duas ferramentas lado a lado
Da documentação do superwhisper, Vocabulary, lida em 10 de outubro de 2026.
| Palavras de vocabulário | Substituições | |
|---|---|---|
| Quando atua | Antes da transcrição, enviadas com o seu áudio como dicas | Depois da transcrição, sobre o texto pronto |
| O que faz | Aumenta a chance de o modelo reconhecer uma palavra | Troca um trecho por outro, sem IA |
| Garantido | Não. Dá um empurrão no modelo, e o efeito varia de modelo para modelo | Sim. O mesmo resultado sempre, seja qual for o modelo |
| Bom para | Nomes, siglas, nomes de empresas, jargão, palavras de outros idiomas | Erros que voltam sempre, símbolos, endereços de e-mail, frases que você expande |
| Risco | Uma lista longa pode confundir o modelo e mudar a pontuação | Pouco. A busca ignora maiúsculas |
Mantenha a lista de vocabulário curta
A documentação é direta sobre isso. Palavras de vocabulário demais podem confundir o modelo de transcrição, palavras em outros idiomas podem prejudicar a precisão e a detecção automática de idioma, e o vocabulário influencia a pontuação e a formatação, não só a ortografia. O conselho deles é manter a lista curta e usar substituições para as correções que precisam ser sempre iguais.
Se o superwhisper passou a acrescentar palavras ou a repetir texto depois que você adicionou muito vocabulário, a página sobre palavras acrescentadas e repetidas trata desse caso.
Como as substituições se comportam
- Maiúsculas não importam na busca. Uma substituição para todo também pega ToDo, TODO e Todo.
- Maiúsculas importam no resultado. O texto sai exatamente como você digitou na substituição.
- Uma palavra errada, várias grafias. Se uma palavra é ouvida de vários jeitos, adicione uma substituição para cada um e aponte todas para a grafia certa.
- Independentes do modelo. Elas valem do mesmo jeito, seja qual for o modelo de voz que transcreveu o texto.
Símbolos e endereços de e-mail
Os modelos de voz são ajustados para a fala, então um arroba ou uma barra raramente saem como símbolo. A documentação sugere um conjunto de substituições para isso:
Da documentação do superwhisper, Vocabulary, lida em 10 de outubro de 2026. A documentação lista também o traço.
| Diga | Resultado |
|---|---|
| at sign (arroba) | @ |
| dot com (ponto com) | .com |
| dot net | .net |
| dot org | .org |
| hashtag (cerquilha) | # |
| slash (barra) | / |
| underscore (sublinhado) | _ |
Esses são os termos em inglês que alguém fala, e você define as suas próprias frases. Para os endereços que você usa muito, adicione cada um como uma substituição, por exemplo uma frase como my work email (o meu e-mail de trabalho) que vira o endereço. Para um endereço avulso, diga nome, at sign, domínio, dot com, e deixe as substituições de símbolos fazerem o resto.
Onde encontrá-las
As duas ficam em Settings, Vocabulary no app para Mac, na mesma lista. Clique no ícone de lixeira ao lado de um item para removê-lo. No terminal, a CLI do superwhisper tem superwhisper vocab para as palavras de vocabulário e superwhisper snippets para as substituições, que a documentação da CLI descreve como os mesmos pares From e To do app.
Vai mudar para um Mac novo? O vocabulário vai junto com o resto dos seus ajustes, como explica a página do backup, e a página da CLI trata dos outros comandos.
Um truque de vocabulário para a detecção de idioma
Quando o idioma está em Automático e o ditado continua saindo em inglês, a documentação do superwhisper sugere adicionar uma frase no seu idioma à lista de vocabulário como dica, ou definir um idioma fixo. A dica age pelo modelo, então o efeito varia de modelo para modelo. A página sobre como mudar o idioma traz os passos.
Como o YapToText faz o mesmo trabalho
superwhisper, da documentação dele, lida em 10 de outubro de 2026. YapToText, dos próprios ajustes.
| superwhisper | YapToText | |
|---|---|---|
| Dicas para o modelo de voz | Palavras de vocabulário | As palavras do seu dicionário preparam o modelo Whisper |
| Trocas fixas depois | Substituições | Substitutions, com as opções Whole word e Case |
| Mais de uma lista | Não descrito na documentação | Vários dicionários, e cada um pode ser desativado sem ser apagado |
| Aprender com você | Não descrito na documentação | Corrija a mesma palavra duas vezes e ele pergunta se quer fixar a correção |
| Por tarefa | Não descrito na documentação | Cada modo pode usar todos os dicionários ativados, ou escolher alguns |
O YapToText também sugere correções a partir dos seus ditados, no Mac, e o caminho mais rápido é selecionar a grafia certa em qualquer lugar, pressionar a tecla do Quick Edit e dizer add this to my dictionary (adicione isto ao meu dicionário). A página de ajuda dos dicionários trata disso, e o guia de vocabulário personalizado compara as opções em um Mac.
Download gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.
Resumindo
- Um nome que ele nunca ouve direito. Adicione como palavra de vocabulário.
- Uma palavra que ele sempre escreve errado. Adicione uma substituição, uma para cada grafia errada.
- Símbolos e e-mails. Substituições, como at sign e dot com.
- O resultado piorou. Reduza a lista de vocabulário.
- Terminal. superwhisper vocab e superwhisper snippets.
Se o superwhisper mudar o funcionamento disso, abra uma issue no GitHub (em inglês) e eu atualizo esta página. Eu leio todas.
Download gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.
Guias
Mais guias, em inglês
Fontes
- https://superwhisper.com/docs/get-started/interface-vocabulary (consultado em 10 de outubro de 2026)
- https://superwhisper.com/docs/get-started/cli (consultado em 10 de outubro de 2026)
- https://superwhisper.com/docs/common-issues/language-detection (consultado em 10 de outubro de 2026)
- https://github.com/ryleighnewman/YapToText (consultado em 10 de outubro de 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consultado em 10 de outubro de 2026)
Perguntas
Qual é a diferença entre vocabulário e substituições no superwhisper?
As palavras de vocabulário são dicas enviadas com o seu áudio para o modelo reconhecer um termo. As substituições rodam depois da transcrição e trocam o texto exatamente como você definiu.
Por que o superwhisper piorou depois que adicionei vocabulário?
A documentação dele diz que palavras de vocabulário demais podem confundir o modelo e afetar a pontuação e a detecção de idioma. Mantenha a lista curta e use substituições para as correções fixas.
As substituições do superwhisper diferenciam maiúsculas de minúsculas?
A busca não diferencia, então todo também encontra TODO. O resultado usa exatamente as maiúsculas que você digitou na substituição.
Como ditar um endereço de e-mail no superwhisper?
Adicione substituições como at sign para @ e dot com para .com, ou adicione um endereço inteiro como uma substituição própria.
Dá para editar o vocabulário do superwhisper pelo terminal?
Sim. A CLI do superwhisper tem vocab para as palavras de vocabulário e snippets para as substituições.