Como usar sua própria chave de IA
Nível: Avançado
Tempo de leitura: 6 min
Plano necessário: Todos os planos
O que significa usar a sua própria chave
Em vez de usar as chaves de IA da Wevi para acessar os modelos, você usa a sua própria chave, criada direto no provedor (Anthropic, OpenAI, Google ou OpenRouter).
Quando você usa a sua própria chave, as chamadas de IA vão da Wevi direto para o provedor com ela. A Wevi não armazena suas chaves: elas são criptografadas e usadas apenas no momento da chamada.
Por que a Wevi separa o custo de IA (e por que isso é bom para você)
Essa é uma escolha de transparência. Em vez de embutir o custo de IA no preço da plataforma e cobrar mais caro de todo mundo para compensar, a Wevi separa as duas coisas: você paga a plataforma para a Wevi e paga a IA diretamente ao provedor, pelo que de fato usar.
Na prática, isso é bom para você:
- A plataforma fica mais barata. O preço não carrega uma margem de IA "por garantia" para cobrir os maiores consumidores.
- Você paga só o seu consumo. Um cliente menor não banca o custo de IA gerado por uma conta grande. Cada um paga o que usa, sem subsidiar o uso dos outros.
- Você escolhe qual IA usar. Anthropic, OpenAI, Google ou dezenas de modelos via OpenRouter, e troca quando quiser, sem ficar preso a uma decisão da plataforma.
- Transparência real. Você acompanha o gasto direto no painel do provedor, sem caixa-preta.
Por que usar a sua própria chave
Controle de custo
Com a sua própria chave, 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. Usar a sua própria chave 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ê.
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
OpenRouter (DeepSeek, Kimi, GLM, Qwen, Llama, Mistral, Grok):
- Acesse openrouter.ai e crie uma conta
- Em Credits, adicione créditos à sua conta (a OpenRouter é pré-paga)
- Vá em Keys e clique em "Create Key"
- Copie a chave (começa com
sk-or-...)
A OpenRouter dá acesso a modelos de vários laboratórios com uma única chave. Um detalhe: a base de conhecimento gera os vetores de busca pela OpenAI, então agentes com base de conhecimento precisam também de uma chave OpenAI ativa, mesmo respondendo com um modelo da OpenRouter.
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.
Uma chave 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)
E durante o trial?
No período de teste, a Wevi disponibiliza as chaves de IA para você experimentar a plataforma sem configurar nada. Os modelos da Anthropic, OpenAI e Google ficam liberados nesse período. Os modelos via OpenRouter são a exceção: eles só funcionam com a sua própria chave, mesmo durante o trial.
Quando o trial termina, para os agentes continuarem respondendo você precisa configurar a sua própria chave do provedor em Minha conta → Integrações de IA. Sem uma chave ativa, as chamadas de IA deixam de funcionar fora do trial.
O custo de IA é pago diretamente ao provedor, pelo que você usar. A Wevi não embute esse custo no valor do plano: você paga a plataforma para a Wevi e paga a inferência para o provedor. Isso dá visibilidade real do seu consumo e evita que um cliente subsidie o uso de outro.
Monitorando o uso
A Wevi conta os tokens de cada resposta e mostra o custo estimado em três lugares: embaixo de cada resposta do agente no Inbox, no total da conversa e no card de consumo do mês em Configurações → Uso. Os detalhes estão em quanto cada conversa gasta de IA.
Esse número é uma estimativa muito próxima, calculada com o preço público de cada modelo. A fatura oficial continua sendo a do painel do provedor, que é onde entram descontos por volume e créditos pré-pagos.