Você clicou em Gerar e recebeu um erro, ou o carregamento parou sem produzir áudio. Esta página cobre as causas mais comuns e como resolver cada uma. Comece pelo início e siga até o fim.
Lista de verificação rápida
Revise estes pontos primeiro. A maioria dos problemas é um destes quatro:
- Créditos esgotados
- Voz inválida ou ausente
- Texto muito longo para o modelo escolhido
- Site não conectado ao TTSWP
Cada um desses exibe uma mensagem específica no popup de erro. Leia o texto exato antes de tirar conclusões.
Causa 1: Créditos esgotados
Mensagem de erro: "Créditos insuficientes" ou "Você ficou sem créditos"
Por que acontece: Seus créditos mensais do TTSWP foram consumidos, você não tem saldo de recarga e nenhuma chave BYOK do ElevenLabs está conectada.
Opções de solução:
- Aguarde a renovação mensal (se estiver em um plano pago). Veja a data de renovação em Text to Speech - Meu Plano e Créditos.
- Compre um pacote de recarga.
- Conecte sua chave de API do ElevenLabs para créditos bônus.
- Faça upgrade do seu plano.
Causa 2: Voz inválida ou ausente
Mensagem de erro: "A voz selecionada não está mais disponível na sua conta do ElevenLabs. Escolha uma voz diferente."
Por que acontece: A voz definida como padrão foi removida da sua conta do ElevenLabs. Isso costuma ocorrer após a exclusão de uma voz clonada ou quando um ID de voz foi salvo incorretamente.
Solução:
- Acesse Text to Speech - Vozes.
- Clique em Atualizar vozes na barra superior.
- Escolha uma voz diferente da lista.
- Clique em Selecionar.
- Regere o áudio do post.
Causa 3: Texto muito longo para o modelo
Mensagem de erro: "Este texto é mais longo do que o ElevenLabs aceita para este modelo. Reduza o texto ou escolha um modelo diferente."
Por que acontece: Cada modelo do ElevenLabs tem um limite de caracteres por requisição. Flash e Turbo v2.5 permitem 40.000 caracteres, mas o Multilingual v2 aceita apenas 10.000 e o Eleven v3 apenas 3.000. Seu post é mais longo do que o modelo escolhido suporta.
Opções de solução:
- Troque para um modelo com limite maior na página de Vozes
- Divida o post em seções menores com múltiplos shortcodes
- Remova conteúdo usando a classe
no-audioou seletores CSS
Confira a tabela de limites dos modelos em Escolher uma voz.
Causa 4: Site não conectado
Sintoma: A página de Visão Geral exibe um Cartão de Conexão roxo em vez dos seus créditos.
Solução: Conecte seu site primeiro. Sem conexão, a geração sempre falha.
Causas menos comuns
Sua chave BYOK do ElevenLabs é inválida
Erro: "Falha na síntese TTS: Chave de API inválida"
Solução: Veja Conectar sua própria chave do ElevenLabs e atualize a chave.
Timeout de rede
Erro: "Falha na síntese TTS: Operação expirou"
Por que acontece: Textos muito longos ou uma conexão lenta com o ElevenLabs.
Solução:
- Tente novamente. Timeouts transitórios geralmente se resolvem na próxima tentativa.
- Se continuar acontecendo, tente um modelo mais rápido (Flash v2.5) com texto mais curto.
Problema de pagamento na assinatura
Erro: "Sua assinatura tem um pagamento com falha ou incompleto."
Por que acontece: Sua assinatura do ElevenLabs tem uma fatura em atraso. Isso se aplica apenas quando você usa BYOK com uma conta paga do ElevenLabs.
Solução: Acesse elevenlabs.io e pague a fatura.
Incompatibilidade entre voz e idioma do modelo
Erro: "O modelo X não suporta o código de idioma Y"
Por que acontece: Nem todo modelo suporta todos os idiomas. Menos comum após a versão 3.1.7, que normaliza os códigos de idioma do WordPress.
Solução: Escolha um idioma diferente na página de Vozes, ou troque para o modelo Flash v2.5, que suporta os idiomas mais populares.
Onde verificar a mensagem de erro
Quando a geração falha na lista de posts, a coluna TTS exibe um pequeno ícone de erro. Passe o mouse para ver a mensagem. Você também pode conferir Minhas Estatísticas - Atividade recente para um registro das tentativas recentes.
Se a mensagem de erro for confusa, copie-a e consulte esta página ou o Suporte.