Módulo 3 · Sua ferramenta

IA dentro do app: chave de API, custo por uso e onde a chave nunca fica

Aula 8 de 12 Aula de 10 min Atualizado em 30 de outubro de 2026
Progresso no curso67%

Nesta aula

Colocar IA dentro do app é fácil. Colocar sem vazar a chave que paga a conta é o que importa.

Até agora você usou a IA para construir. Agora o app vai usar a IA por dentro: um botão que resume um e-mail, classifica uma mensagem ou sugere uma resposta. Para isso ele precisa de uma chave de API.

Chat e API: dois jeitos de pagar

No chat, você paga uma assinatura e conversa. Na API, é o seu programa que conversa com a IA, e você paga pelo que usa, medido em tokens (pedaços de texto). O app manda o pedido junto com uma chave, a senha da sua conta. São contas separadas.

Confira os preços atuais na página oficial do provedor.

Exemplo real

Um escritório contábil recebe dezenas de e-mails longos por dia. Um botão "resumir e listar o que o cliente pede" economiza minutos em cada um. Com modelo pequeno e limite mensal, o custo ficou baixo e previsível.

A regra sem exceção

Tudo o que está em HTML, CSS ou JavaScript de um site é baixado por cada visitante. Qualquer pessoa abre o código-fonte e lê. Se a chave estiver lá, qualquer um a copia e gasta por você. Por isso, a chave vive do lado que o visitante não vê.

JeitoOnde fica a chave
Uso local (esta aula)Variável de ambiente do seu computador, fora da pasta
PublicadoNuma função do servidor da hospedagem
Modelo local (Ollama)Não existe chave nem custo por uso

Cuidado

Se a IA sugerir um arquivo .env na pasta do projeto, só aceite se o .gitignore já o excluir (aula 9). Na dúvida, use a variável de ambiente do sistema.

O pedido

Você pede duas coisas: a página com o botão e um servidor pequeno que guarda a chave. O pedido manda a chave vir da variável de ambiente e termina com uma auditoria: a IA confirma que a chave não está em nenhum arquivo. Depois, faça a sua: abra os arquivos e busque um pedaço da chave com Ctrl + F.

O texto que o app envia sai do seu computador e vai para os servidores do provedor. Mande o mínimo, troque CPF e conta por marcadores e leia a política de dados do provedor.

Coisa de profissional

Nem toda tarefa precisa de resposta na hora. Resumir mil e-mails da semana, por exemplo, pode esperar. A documentação oficial da Anthropic descreve uma API de lotes (Message Batches) que reduz o custo em 50%, e diz que a maioria dos lotes termina em menos de uma hora. A troca é simples: você abre mão da resposta imediata. Antes de pagar caro por um botão que fica clicado o dia todo, pergunte: isso precisa ser agora?

Prática · 10 min

  1. No site do provedor, defina o limite mensal e crie a chave. Guarde no gerenciador de senhas.
  2. Abra a ferramenta numa pasta nova e cole o pedido abaixo. Siga as instruções para definir a variável de ambiente e iniciar o servidor.
  3. Teste com três textos inventados e depois audite os arquivos procurando a chave.
Crie um index.html com uma caixa de texto e um botão "resumir", e um servidor local pequeno que recebe o texto, chama a API do Claude e devolve um resumo em 3 linhas. A chave deve vir da variável de ambiente ANTHROPIC_API_KEY e NUNCA pode aparecer em arquivo desta pasta. Use o modelo mais econômico que sirva. Limite o texto a 4000 caracteres e mostre erro claro se faltar a chave. Depois, explique como rodar e liste os arquivos para provar que a chave não está neles.
Entregável: o botão "resumir" funcionando, a chave ausente de todos os arquivos e o consumo dos testes anotado.

Resumo

Fontes

Lidas em 30 de outubro de 2026.

  1. Anthropic. Batch processing: custo 50% menor; a maioria dos lotes termina em menos de 1 hora.

Quiz da aula

Três situações para aplicar o que viu.

Aula 8 de 12

Antes de seguir para a próxima aula

Coloque em prática o que viu. As caixas ficam marcadas neste navegador, para você voltar depois.

Ficou com dúvida nesta aula? O time da IV Help responde pessoalmente no WhatsApp.

Perguntar no WhatsApp