Uma das funcionalidades mais poderosas do ZapVox é o BYOK (Bring Your Own Key) — a capacidade de usar suas próprias chaves de API para transcrição cloud com Groq ou OpenAI, desbloqueando uso 100% ilimitado e mantendo total controle sobre seus dados.

Neste tutorial, vamos mostrar passo a passo como configurar BYOK no ZapVox e aproveitar ao máximo essa feature.

O que é BYOK?

BYOK (Bring Your Own Key) significa que você fornece sua própria chave de API em vez de usar os servidores do ZapVox. Isso traz várias vantagens:

  • Uso ilimitado: Sem limites diários ou por mês. Você controla apenas pelo uso real da sua conta.
  • Privacidade total: Seus áudios vão diretamente da sua máquina para Groq ou OpenAI — o ZapVox nunca acessa seu conteúdo.
  • Criptografia de ponta a ponta: Sua chave é criptografada com AES-256-GCM e armazenada apenas no seu navegador, nunca enviada para nossos servidores.
  • Controle de custos: Você paga apenas pelos provedores (Groq é grátis até certos limites, OpenAI cobra por uso).

Por que escolher BYOK?

Existem três cenários principais onde BYOK é ideal:

✓ Quando usar BYOK
  • Volume alto: Se você transcreve dezenas de áudios por dia, o custo do Groq (que é barato) é muito menor que uma assinatura Pro.
  • Privacidade em primeiro lugar: Seus áudios nunca passam pelos servidores do ZapVox — vão direto para Groq/OpenAI.
  • Modelos específicos: Quer usar GPT-4o ou Whisper Large do OpenAI? Apenas com sua chave você consegue.
  • Teste antes de comprometer: Groq oferece 10.000 requisições grátis por mês — perfeito para testar.

Passo 1: Obter uma chave da Groq (Recomendado - Grátis)

Groq é a opção recomendada: oferece transcrição Whisper completamente grátis até 10.000 requisições por mês, é muito rápido, e você pode testar sem pagar nada.

Como obter chave Groq:

  1. Visite console.groq.com
  2. Faça login com sua conta Google ou crie uma nova
  3. No dashboard, clique em "API Keys" (chaves de API)
  4. Clique em "Create API Key" (criar chave de API)
  5. Dê um nome descritivo, tipo "ZapVox" ou "Transcrição WhatsApp"
  6. Copie a chave gerada — guarde em um lugar seguro. Você não consegue ver novamente depois!

Pronto! Você tem uma chave Groq funcionando. O plano gratuito oferece:

  • 10.000 requisições por mês (o suficiente para ~150 transcrições de áudios curtos)
  • Modelos: Whisper (transcrição) e outros LLMs
  • Velocidade: Ultra-rápido (geralmente <1s por áudio)

Passo 2: Obter uma chave da OpenAI (Opcional - Pago)

Se você prefere usar OpenAI (que tem modelos mais avançados como GPT-4o, ou o Whisper Large), siga este processo:

Como obter chave OpenAI:

  1. Visite platform.openai.com
  2. Faça login ou crie uma conta OpenAI
  3. No menu esquerdo, clique em "API keys"
  4. Clique em "Create new secret key" (criar nova chave secreta)
  5. Escolha um nome para identificar (ex: "ZapVox Chrome Extension")
  6. Copie a chave — guarde com segurança, você só vê uma vez!
  7. Configure um billing limit (limite de despesas) para evitar surpresas de custos

Custo OpenAI: Você paga por uso real. Whisper custa aproximadamente US$ 0,006 por minuto de áudio (cerca de R$ 0,03). 10 áudios de 1 min/dia ficam em torno de R$ 9/mês. A Groq tem nível gratuito generoso (30 req/min) — recomendamos começar pela Groq antes de usar OpenAI.

Passo 3: Configurar BYOK no ZapVox

Agora que você tem sua chave, vamos adicionar ao ZapVox:

  1. Abra o ZapVox no seu navegador (clique no ícone da extensão)
  2. Clique em "⚙️ Configurações" (engrenagem)
  3. Vá para a aba "API Keys" ou "Chaves de API"
  4. Selecione o provedor: "Groq" ou "OpenAI"
  5. Cole sua chave no campo "Sua chave de API"
  6. Clique em "Salvar"

Uma notificação de confirmação deve aparecer. Sua chave é criptografada imediatamente com AES-256-GCM e armazenada apenas no seu navegador, localmente.

⚠️ Aviso de Segurança

Sua chave de API é muito sensível. Como fica armazenada no seu navegador (em chrome.storage.local):

  • ✓ A chave é criptografada com AES-256-GCM (padrão da indústria)
  • ⚠️ Se alguém tiver acesso físico ao seu PC, pode potencialmente acessar a chave
  • ⚠️ Nunca compartilhe sua chave com ninguém
  • ✓ Se suspeitar que a chave foi comprometida, regenere-a no console da Groq/OpenAI

BYOK no Plano Free vs Pro

Dependendo do seu plano, BYOK desbloqueia recursos diferentes:

Free + BYOK:

  • ✓ Transcrição cloud com sua chave: ilimitada
  • ✓ Tradução: desbloqueada
  • ✗ Marca d'água do ZapVox: continua presente
  • ✗ Resumo e tópicos: ainda limitados a 3/dia

Pro + BYOK:

  • ✓ Transcrição cloud: ilimitada
  • ✓ Tradução: ilimitada
  • ✓ Resumo e tópicos: ilimitados
  • ✓ Sem marca d'água
  • ✓ Modelos avançados (GPT-4o, etc.)

Como o BYOK funciona internamente?

Para você entender como suas chaves são protegidas:

  1. Você entra a chave: Digite no popup do ZapVox
  2. Criptografia imediata: A chave é criptografada com PBKDF2 (derivação) + AES-256-GCM antes de sair do popup
  3. Armazenamento local: A chave criptografada fica apenas em chrome.storage.local — nunca sai do seu navegador
  4. Uso transparente: Quando você transcreve, o ZapVox descriptografa a chave em memória, chama a API (Groq/OpenAI), e a chave nunca é transmitida para os servidores do ZapVox
  5. Limpeza: A chave em memória é limpa após cada uso

Resultado: Seus áudios e sua chave ficam sempre sob seu controle. O ZapVox apenas orquestra o processamento.

Dicas e Boas Práticas

1. Monitore seu uso Groq/OpenAI

Tanto Groq quanto OpenAI oferecem dashboards para ver seu uso. Verifique regularmente para evitar surpresas de custos (no caso OpenAI) ou excesso de cota.

2. Rotação de chaves

Se você usar uma máquina compartilhada, considere regenerar sua chave periodicamente. Leva 2 minutos para gerar uma nova no console Groq/OpenAI e atualizar no ZapVox.

3. Limite de despesas (OpenAI)

No OpenAI, sempre defina um billing limit (limite de faturamento). Isso garante que mesmo se algo der errado, você não vai pagar mais que o limite escolhido.

4. Escolha entre Groq e OpenAI

  • Groq: Comece com Groq. É grátis, rápido, e 10.000 requisições mensais cobrem a maioria dos casos.
  • OpenAI: Use apenas se precisar de modelos mais avançados ou volume muito alto.

Troubleshooting

Mensagem: "Chave de API inválida"

Verifique se:

  • A chave foi copiada inteira (sem espaços extras)
  • Você copiou do console correto (Groq vs OpenAI)
  • A chave não foi regenerada no console (chaves antigas param de funcionar)

Transcrição falha com "Rate limit exceeded"

Significa que você atingiu o limite da sua conta:

  • Groq: Espere até o próximo mês (limite é mensal)
  • OpenAI: Aumente seu billing limit ou espere reinicializar (geralmente diário)

A chave desapareceu após atualizar o navegador

Isso pode acontecer em alguns casos raros. Simplesmente adicione a chave novamente. Se persistir, tente limpar cache/cookies ou use outro navegador.

Próximos passos

Agora que você configurou BYOK, você pode:

  • ✓ Transcrever áudios de WhatsApp ilimitadamente
  • ✓ Traduzir para qualquer idioma (Free) ou desbloquear resumos (Pro)
  • ✓ Monitorar seu uso no console Groq/OpenAI
  • ✓ Compartilhar suas experiências — como está funcionando?

Tem dúvidas sobre BYOK? Comente abaixo, envie uma mensagem no suporte dentro da extensão, ou responda este post. Estamos sempre prontos para ajudar!