Problemas Comuns

Nada é transcrito

• Abra Settings → Permissions (Configurações → Permissões). Microphone Access aparece marcado como Required; se não estiver concedido, clique em Grant Access.
• Verifique o dispositivo de entrada em Settings → General → Microphone e clique em Change para escolher outro.
• Verifique o motor em Settings → Transcription. Com Local Model (On-Device), o modelo selecionado precisa estar marcado como Downloaded; com um provedor BYOK, a chave de API precisa estar salva.
• Aumente Microphone sensitivity em Settings → System (Sistema) e use o botão Test — ele grava três segundos e reproduz com o ganho atual.

O atalho não faz nada

• Confirme que o Speakly está rodando: o ícone está na barra de menu / bandeja e o menu abre.
• No macOS, conceda Accessibility Access em Settings → Permissions. A própria janela do atalho avisa: "Make sure to grant Accessibility permissions if prompted."
• Troque a combinação se outro aplicativo já a usa: Settings → General → Keyboard shortcut → View, depois Change Shortcut na janela Keyboard Shortcut. Pressione as teclas desejadas — a dica diz "Press keys to add them, press again to remove" — e então Done.
• Se o Speakly responder Could not set that shortcut. Try a different combination., a combinação não está disponível; escolha outra.

Qualidade ruim de transcrição

• Fale em volume constante e reduza o ruído de fundo.
• Tente um modelo maior em Settings → Transcription — por exemplo large-v3 em vez de um turbo quantizado.
• Adicione nomes e termos técnicos na página Dictionary da barra lateral. Veja Dicionário Personalizado.
• Se o problema é maiúsculas e pontuação, e não as palavras, isso é Style, não precisão — veja Estilo de Escrita.

FAQ ou flashcards falham em vídeo longo

Antes isso terminava sempre na mesma frase, qualquer que fosse a causa: "Failed to generate content. Please try again." Agora a mensagem traz o erro do próprio provedor e o tamanho que o causou, no formato <provedor>: <mensagem do provedor> (sent <n> characters) — um limite de taxa e uma chave inválida deixaram de ter a mesma aparência.

• Transcrições longas são divididas a cada 16.000 caracteres, em fim de frase, processadas uma parte após a outra e depois unidas. A sequência é intencional: partes enviadas de uma vez disputariam o mesmo limite por minuto.
• Uma requisição barrada por limite de taxa não é mais tratada como falha. Com a Groq, o Speakly espera o tempo que a própria Groq informa na resposta e tenta de novo, no máximo duas vezes e nunca esperando mais de 65 segundos por vez.
• Uma requisição recusada por ser grande demais não é repetida — esperar não faz uma única requisição caber num limite por minuto que ela já excede. Isso se resolve dividindo, e a divisão agora é automática.
• Se ainda falhar, o texto que aparece é do provedor, não do Speakly. Leia antes de tentar de novo: ele diz o limite e o tamanho.