BYOK explicado: use suas próprias chaves e economize

Toda plataforma de IA cobra uma margem. Você paga a ela, ela paga o provedor, e a diferença é a margem dela. É assim que o negócio funciona. Nós fazemos o mesmo — nossa chave da plataforma roteia suas requisições pelas nossas contas com Anthropic, OpenAI, Google e o resto, e adicionamos uma pequena margem para cobrir infraestrutura e manter as luzes acesas.

Mas aqui está a coisa: alguns de vocês são usuários pesados. Fazem milhares de chamadas de API por dia. Nesse volume, até uma margem pequena se acumula rápido. Então construímos o BYOK.

O que o BYOK realmente faz

BYOK — Bring Your Own Key — te permite conectar suas próprias chaves de API de provedores diretamente ao seu workspace do Zubnet. Quando você faz uma requisição para um modelo daquele provedor, nós roteamos a requisição usando a sua chave em vez da nossa.

A margem? Zero. Você paga o provedor diretamente nas tarifas publicadas. Não tiramos parte em requisições BYOK.

Todo o resto fica igual. Mesma API unificada. Mesma interface. Mesmo streaming, mesmo tratamento de erros, mesma troca de modelo. A única diferença é qual cartão de crédito é cobrado pelo compute.

Como configurar

Leva uns dois minutos:

1. Vá para as configurações do seu workspace em zubnet.com

2. Encontre a seção “Chaves de API” ou “BYOK”

3. Selecione um provedor (ex., Anthropic)

4. Cole sua chave de API daquele provedor

5. Salve

Isso é tudo. A partir daí, qualquer requisição que você fizer para um modelo da Anthropic vai pela sua chave. Sem mudanças de código. Sem configuração no seu app. O roteamento acontece no server-side, automaticamente.

Sua chave é criptografada em repouso.

Armazenamos chaves BYOK usando criptografia AES-256. São descriptografadas apenas no momento da chamada de API, usadas e descartadas da memória. Nunca as logamos, nunca as mostramos depois da configuração inicial, e nunca as usamos para nada além de rotear suas requisições específicas.

BYOK + chave da plataforma: coexistem

Você não tem que escolher um ou outro para toda sua conta. BYOK funciona por provedor. Se você adiciona uma chave da Anthropic mas não uma da OpenAI:

• Modelos Anthropic (Claude) → sua chave, margem zero
• Modelos OpenAI (GPT-4.1) → chave da plataforma, preço padrão
• Modelos Google (Gemini) → chave da plataforma, preço padrão
• Qualquer outro provedor → chave da plataforma, preço padrão

Misture e combine. Use BYOK para os provedores que você mais usa, e chaves da plataforma para todo o resto.

Regra de prioridade: quando uma chave BYOK está configurada para um provedor, ela sempre tem prioridade. Se você quer mudar temporariamente para a chave da plataforma, delete ou desabilite a chave BYOK nas configurações.

Quando o BYOK te economiza dinheiro

A matemática é direta. Nossa margem em requisições com chave da plataforma cobre custos de infraestrutura — roteamento, proxies de streaming, logging, balanceamento de carga, CDN para assets gerados e a engenharia para manter 367 modelos rodando simultaneamente. Para a maioria dos usuários, esse custo é negligível.

Mas se você é um usuário de alto volume, os números mudam:

Exemplo: uso pesado de Claude Sonnet

Digamos que você gaste 500 $/mês em Claude Sonnet pela nossa chave da plataforma. Nossa margem pode adicionar 50-75 $ a isso. Com BYOK, você paga diretamente à Anthropic 500 $ e ao Zubnet 0 $ por essas requisições específicas. A 50 $/mês em gasto de IA? A margem é só alguns dólares. Provavelmente não vale a pena gerenciar uma chave de API separada. A 5 000 $/mês num único provedor? BYOK é óbvio.

Quando a chave da plataforma é na verdade mais barata

Isso surpreende as pessoas, mas existem cenários reais em que usar nossa chave te custa menos:

Tarifas negociadas por volume. Nós negociamos descontos por volume com provedores que usuários individuais não conseguem obter. Para alguns provedores, nosso custo por token é mais baixo que a tarifa de API publicada. Se sua chave BYOK paga preço de lista e nossa chave da plataforma paga uma tarifa negociada, a margem pode ser menor que o desconto.

Uso de baixo volume. Se você gasta 20 $/mês em cinco provedores, a margem adiciona talvez 2-4 $ no total. Gerenciar cinco chaves de API separadas, cinco relacionamentos de cobrança separados e cinco dashboards de uso separados não vale 3 $ de economia.

Créditos do plano gratuito. Alguns dos nossos planos incluem um crédito mensal que cobre certa quantidade de uso com chave da plataforma. Requisições BYOK não contam contra esses créditos porque contornam nossa cobrança completamente.

Provedores suportados

BYOK está disponível para 25+ provedores, incluindo todos os principais:

• Anthropic — modelos Claude
• OpenAI — modelos GPT, DALL-E, Whisper
• Google — modelos Gemini, Imagen
• Mistral — Mistral Large, Codestral
• Cohere — Command R+
• Perplexity — modelos Sonar
• DeepSeek — DeepSeek R1, V3
• Together.ai — hospedagem de modelos open-source
• Groq — inferência ultrarrápida
• Fireworks — modelos open-source otimizados
• Replicate — modelos de imagem e vídeo
• ElevenLabs — síntese de voz
• Stability AI — Stable Diffusion, Stable Audio
• Black Forest Labs — modelos de imagem FLUX
• Kling — geração de vídeo
• Runway — vídeo Gen-4
• Suno — geração musical
• Tripo — geração de modelos 3D
• E mais sendo adicionados regularmente

Se um provedor que você precisa não está na lista, nos avise. Adicionar suporte BYOK para um novo provedor é geralmente simples se já integramos a API dele.

Transparência: o que você vê

Uma coisa em que acreditamos é transparência. Seja usando BYOK ou a chave da plataforma, seu dashboard de uso mostra:

• Qual modelo foi usado para cada requisição
• Quantos tokens foram consumidos
• Se a requisição usou sua chave BYOK ou a da plataforma
• O custo na tarifa publicada do provedor (pra você poder comparar)

Sem cobranças escondidas. Sem surpresas. Se você está pagando margem, pode ver exatamente quanto. Se está em BYOK, pode verificar que a margem é efetivamente zero.

Perguntas comuns

E se minha chave BYOK ficar sem créditos?

A requisição falha com o erro do provedor (geralmente 402 ou 429). Não fazemos fallback automático para a chave da plataforma — isso te surpreenderia com cobranças inesperadas. Se sua chave BYOK tem problemas, você vai ver a mensagem de erro do provedor na resposta.

Posso usar BYOK e ainda assim ter os recursos do Zubnet?

Sim, todos. Histórico de conversa, streaming, API unificada, troca de modelo, interface web — tudo funciona identicamente. BYOK só muda quem paga o provedor pelo compute.

Minha chave é compartilhada com alguém?

Não. Sua chave BYOK é usada exclusivamente para as requisições do seu workspace. Nunca é agrupada, nunca compartilhada, nunca usada para qualquer outro propósito.

A conclusão: BYOK existe porque achamos que você deveria ter a escolha. Use nossa chave da plataforma por conveniência. Use suas próprias chaves para economizar em escala. Misture as duas pro melhor dos dois mundos. Sem lock-in, sem jogos — só opções honestas.

BYOK está disponível em todos os planos pagos. Configure nas suas configurações de workspace em menos de dois minutos.