Conecte sua própria chave ElevenLabs (BYOK)

6 min read

Use sua própria chave de API do ElevenLabs e os créditos da sua conta ElevenLabs se somam aos seus créditos do TTSWP. Contas gratuitas do ElevenLabs oferecem 10.000 caracteres por mês sem custo. Planos pagos oferecem mais. Veja como conectar em menos de dois minutos.

Por que conectar sua própria chave

  • Créditos bônus mensais gratuitos - contas gratuitas do ElevenLabs incluem 10.000 caracteres por mês sem custo
  • Controle de gastos - você pode definir um limite mensal por chave no ElevenLabs para que o TTSWP nunca ultrapasse o que você quer gastar na plataforma
  • Continuidade automática - quando seus créditos do TTSWP acabam, a geração continua sem interrupção

Seus créditos do ElevenLabs são usados somente após seus saldos mensais e de recarga do TTSWP estarem zerados.

Pro Lite: BYOK como sua fonte principal de créditos

Se você já paga o ElevenLabs e quer todos os recursos Pro sem pagar duas vezes por créditos, o plano Pro Lite foi feito para você. Custa $29 por ano, desbloqueia todos os recursos Pro (Speech-to-Text, clonagem de voz, rodapé fixo, forma de onda, SSML, narração WooCommerce) e usa sua chave ElevenLabs como única fonte de geração.

Diferenças principais em relação ao BYOK em um plano pago:

  • Sem créditos TTSWP - cada caractere é cobrado da sua conta ElevenLabs
  • Áudio fica no seu servidor WordPress - sem S3 ou CloudFront gerenciados pelo TTSWP
  • Cobrança anual apenas - sem opção mensal
  • Chave válida é obrigatória - se sua chave estiver ausente, revogada ou sem saldo, a geração para

Escolha o Pro Lite se você já investe no ElevenLabs e quer recursos premium do WordPress a um custo anual fixo. Escolha um plano Pro regular se quiser créditos TTSWP incluídos mais a opção de usar sua própria chave como overflow.

Leia a página de Planos e preços para a comparação completa entre Pro e Pro Lite, ou acesse diretamente os preços para assinar.

Crie uma conta no ElevenLabs

  1. Acesse elevenlabs.io.
  2. Cadastre-se com seu e-mail.
  3. Confirme seu endereço de e-mail.

O plano gratuito é suficiente para começar. Você recebe 10.000 caracteres por mês sem custo. Faça upgrade depois se precisar de mais.

Encontre sua chave de API

  1. Faça login em elevenlabs.io.
  2. Vá ao ícone do seu perfil (canto superior direito) e clique em API Keys.
  3. Clique em Create New Key.
  4. Dê um nome como "TTSWP".
  5. Defina as permissões com no mínimo Text to Speech.
  6. Opcional, mas recomendado: defina um limite mensal de créditos para a chave (por exemplo, 10.000). Isso limita o que a chave pode gastar.
  7. Clique em Create e copie a chave. Ela começa com sk_.

Mantenha a chave em segredo. Não a cole em locais públicos.

Adicione a chave ao TTSWP

  1. Acesse app.ttswp.com/settings.
  2. Role até ElevenLabs BYOK.
  3. Cole sua chave de API no campo ElevenLabs API key.
  4. (Opcional) Insira seu limite mensal por chave no campo Monthly character limit (por exemplo, 10000). Esse é o número que você definiu no ElevenLabs.
  5. Clique em Save key.

O TTSWP valida a chave fazendo uma chamada de teste. Se a chave for válida, um marcador verde aparece na sua página de Visão Geral no WordPress.

Como o bônus é exibido

Na página de Visão Geral no WordPress, veja o card de Estatísticas Rápidas. Quando sua chave está conectada e válida, você vê:

[ElevenLabs connected]  Free tier    0 / 10,000 ElevenLabs credits per month | Resets Oct 5, 2026

Os números vêm do ElevenLabs em tempo real. A data de renovação é o seu ciclo de cobrança no ElevenLabs.

Como os créditos são usados quando o BYOK está ativo

Ordem de uso durante a geração:

  1. Créditos mensais do TTSWP do seu plano
  2. Créditos de recarga do TTSWP, se houver
  3. Sua conta ElevenLabs via sua chave BYOK

Você não escolhe a ordem. O plugin gerencia isso automaticamente.

Removendo a chave

Acesse app.ttswp.com/settings e clique no botão Remove ao lado da chave mascarada. Sua página de Visão Geral volta a exibir o aviso de Dica! incentivando o uso do BYOK.

Quando sua chave para de funcionar

Se o ElevenLabs rejeitar sua chave (revogada, regenerada ou sem permissão de TTS), a página de Visão Geral mostra:

[ElevenLabs key invalid]  Update it on app.ttswp.com.   Update key →

Para corrigir:

  1. Acesse app.ttswp.com/settings.
  2. Clique em Remove para apagar a chave antiga.
  3. Crie uma nova chave em elevenlabs.io.
  4. Cole a nova chave e clique em Save.

Limite mensal por chave

Se você definir um limite mensal de caracteres na sua chave do ElevenLabs, o ElevenLabs aplica esse limite. O TTSWP não vê esse limite pela API, então você precisa inseri-lo manualmente no campo "Monthly character limit" em app.ttswp.com.

Quando definido, sua página de Visão Geral mostra o limite correto por chave em vez do limite geral da sua conta.

Permissões necessárias na chave

A permissão mínima é Text to Speech. Se você usa transcrição Speech-to-Text no TTSWP (recurso PRO), ative também a permissão Speech to Text na chave.

Chaves com outras permissões (Voice Cloning, History etc.) funcionam bem, mas não são obrigatórias.

Perguntas comuns

O BYOK funciona no plano gratuito? Sim. Conecte uma chave e você recebe seus créditos de boas-vindas mais seus créditos do ElevenLabs.

Pago ao TTSWP quando minha chave ElevenLabs é usada? Não. A geração que cai para sua conta ElevenLabs não gera custo extra no TTSWP.

Posso usar uma chave em vários sites? Sim. Conecte a mesma chave em cada site. O uso de cada site conta contra o mesmo limite mensal do ElevenLabs.

E se minha conta ElevenLabs tiver assinatura mensal paga? O fluxo é o mesmo - o TTSWP lê o limite mensal que o ElevenLabs reporta para sua chave.

Qual a diferença entre BYOK no plano gratuito e o Pro Lite? No plano gratuito, o BYOK é opcional - ele soma aos seus 10.000 créditos de boas-vindas e você usa a biblioteca de vozes padrão. O Pro Lite ($29/ano) exige uma chave, mas desbloqueia todos os recursos Pro (vozes premium, Speech-to-Text, clonagem de voz, SSML, rodapé fixo). Escolha o Pro Lite quando quiser todos os recursos Pro e já pagar o ElevenLabs; escolha Gratuito + BYOK quando precisar apenas do básico com overflow.

Posso migrar de um plano Pro para o Pro Lite depois? Sim, pelo seu painel de cobrança. Os downgrades entram em vigor na próxima data de cobrança, então você mantém seus créditos atuais até lá.

Páginas relacionadas