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 ou Google).
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 ou Google, 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
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. Todos os modelos ficam liberados nesse período.
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
Com a sua própria chave ativa, 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.