Como funciona o BYOK (Bring Your Own Key)
Nível: Avançado
Tempo de leitura: 6 min
Plano necessário: Todos os planos
O que é BYOK
BYOK significa Bring Your Own Key (trazer sua própria chave). Em vez de usar as chaves de API da Wevi para acessar os modelos de IA, você fornece sua própria chave diretamente do provedor (Anthropic, OpenAI ou Google).
Quando você usa BYOK, as chamadas de IA vão da Wevi direto para o provedor com a sua chave. A Wevi não armazena suas chaves: elas são criptografadas e usadas apenas no momento da chamada.
Por que usar BYOK
Controle de custo
Com BYOK, você paga o provedor diretamente, pelos preços do seu contrato. Isso é especialmente vantajoso se:
- Você já tem créditos pré-pagos com OpenAI ou Anthropic
- Seu volume é alto e você negociou tarifas corporativas
- Você quer visibilidade detalhada do gasto por token no painel do provedor
Compliance e privacidade
Algumas empresas têm políticas internas que exigem que chamadas de IA passem por suas próprias contas corporativas, não por contas de terceiros. BYOK resolve isso.
Limites e quotas próprias
Com sua própria chave, você controla os limites de uso, monitora diretamente no dashboard do provedor e recebe alertas de custo configurados por você.
Transparência de preços (e uma escolha da Wevi)
BYOK é também uma decisão estratégica da Wevi: em vez de embutir o custo de IA no valor do plano e cobrar mais caro para compensar, preferimos separar os dois. Você paga a Wevi pela plataforma e paga o provedor de IA diretamente pelo que usar. Cada cliente tem visibilidade real do próprio consumo, sem subsidiar o uso dos outros. Achamos isso mais justo e mais transparente.
Como configurar
Passo 1: Obtenha a chave de API do provedor
Anthropic (Claude):
- Acesse console.anthropic.com
- Vá em API Keys
- Clique em "Create Key"
- Copie a chave (começa com
sk-ant-...)
OpenAI (GPT):
- Acesse platform.openai.com
- Vá em API Keys
- Clique em "Create new secret key"
- Copie a chave (começa com
sk-...)
Google (Gemini):
- Acesse aistudio.google.com
- Vá em Get API Key
- Crie ou selecione um projeto
- Copie a chave
Passo 2: Configure na Wevi
- No painel da Wevi, acesse Minha conta → Integrações de IA
- Clique em "Adicionar chave"
- Selecione o provedor
- Cole a chave
- Clique em "Salvar"
A chave é criptografada antes de ser armazenada. Ela não fica visível após salvar; só pode ser substituída.
Passo 3: Use nos agentes
Após salvar a chave, o provedor correspondente aparece automaticamente na lista de modelos de todos os agentes da organização. Não é necessária nenhuma configuração adicional por agente.
BYOK por cliente (Programa de Parceiros e Whitelabel)
Com acesso a múltiplas organizações (via Programa de Parceiros ou Wevi Whitelabel), você pode configurar uma chave de API diferente para cada cliente. Isso significa que:
- Cada cliente paga seus próprios custos de IA diretamente para o provedor
- Você gerencia os agentes, mas os custos de inference ficam na conta do cliente
- Total separação de responsabilidades
Para configurar: acesse a organização do cliente e repita o processo acima com a chave daquele cliente.
Segurança das chaves
A Wevi utiliza criptografia AES-256 para armazenar as chaves. Elas são decriptografadas apenas no momento da chamada e nunca aparecem em logs, respostas de API ou interfaces de usuário.
Boas práticas que recomendamos:
- Crie uma chave específica para a Wevi; não use a mesma chave em múltiplos sistemas
- Configure alertas de gasto no provedor para evitar surpresas
- Defina limites de uso mensais diretamente no painel do provedor
- Rotacione as chaves periodicamente (a cada 90 dias é uma boa prática)
O que acontece sem BYOK
Sem BYOK, a Wevi usa chaves próprias e inclui o custo de IA no valor do plano. Os custos de inference são estimados com base no uso típico; se você usar muito acima da média, a Wevi pode entrar em contato para discutir ajuste de plano.
Para a maioria dos casos de uso padrão (atendimento ao cliente, FAQs, agendamentos), o plano Pro cobre os custos confortavelmente. BYOK é mais relevante para empresas com volume muito alto ou com requisitos de compliance específicos.
Monitorando o uso
Com BYOK ativo, você monitora o custo diretamente no dashboard do provedor. A Wevi também exibe um relatório de uso aproximado em Organização → Analytics → Uso de IA, mas os números exatos devem ser consultados no provedor.