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, liberando os recursos de IA sem os limites diários do ZapVox (o consumo passa a correr pela cota da sua própria chave) 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.

⚠️ Aviso importante (leia antes de começar): este material tem caráter meramente informativo. A Groq e a OpenAI são provedores terceiros e independentes — o ZapVox não é integrado comercialmente a eles, não recebe comissão e não possui qualquer conflito de interesse na indicação. As condições, cotas gratuitas, preços, termos e políticas desses provedores são definidos exclusivamente por eles e podem mudar a qualquer momento — cabe a você conhecê-los e acompanhá-los nos sites oficiais antes de usar. O ZapVox não se responsabiliza, direta ou indiretamente, por custos, cobranças, limites, indisponibilidade, alterações de política ou mau uso de chaves de API junto a esses provedores.

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:

  • Sem a cota do ZapVox: não há limite diário nosso — o que vale é a cota (e a cobrança) da sua própria chave no provedor.
  • 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: a Groq oferece uma camada gratuita generosa (consulte os limites vigentes no site dela) — perfeito para testar.

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

Groq é a opção recomendada: oferece transcrição Whisper com camada gratuita (limites definidos pela própria Groq — confira os valores vigentes em console.groq.com), é muito rápida, 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:

  • Camada gratuita com limites definidos pela Groq (historicamente suficiente para uso diário intenso — confira os valores vigentes)
  • 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 (confira os limites vigentes no site da Groq) — 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:

  • ✓ Recursos de IA pela sua chave (transcrição, tradução, resumo e sentimento): sem os limites diários do ZapVox — a cota é a da sua chave no provedor
  • ✗ Marca d'água do ZapVox: continua presente
  • ✗ Recursos de plano (agendamento além de 3/dia, lembretes, glossário, busca, exportar, resumo do chat inteiro): continuam exclusivos do Pro

Pro + BYOK:

  • ✓ Recursos de IA pela sua chave: sem os limites diários do ZapVox (cota da sua chave no provedor)
  • ✓ Todos os recursos de plano do Pro (agendamento em alto volume, lembretes, glossário, busca, exportar, resumo do chat)
  • ✓ Sem marca d'água

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. A camada gratuita cobre a maioria dos casos (confira os limites vigentes no site dela).
  • 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 do WhatsApp sem consumir a cota do ZapVox
  • ✓ 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!