API de IA para iniciantes: qual escolher e quanto custa

Por que usar uma API em vez do chat

Você já usa ChatGPT, Claude ou Gemini no navegador e agora quer que a IA trabalhe dentro de algo seu: uma planilha que classifica pedidos sozinha, um robô que responde clientes no WhatsApp, um script que resume as notas fiscais do mês. O chat não faz isso. Para conectar um modelo de IA a um sistema, você precisa da API — a porta de entrada que o seu código usa para mandar um texto e receber a resposta de volta.

A diferença prática para o iniciante é dupla. Primeiro, a cobrança: no chat você paga assinatura mensal fixa; na API você paga pelo que usa, medido em tokens (pedaços de palavras), com preço separado para o que entra e para o que sai. Segundo, a responsabilidade: na API, guardar a chave, controlar gasto e tratar erro passa a ser trabalho seu. Se a sua dúvida ainda é qual assistente usar no dia a dia, comece por ChatGPT vs Claude vs Gemini; este guia é para quem já decidiu programar.

Como ler uma tabela de preço por milhão de tokens

As três principais APIs cobram em dólar por milhão de tokens (às vezes escrito “1M tokens” ou “MTok”). Você vai ver sempre pelo menos duas colunas: entrada (input — tudo o que você manda: instruções, histórico, documento) e saída (output — o que o modelo escreve). A saída costuma custar de quatro a cinco vezes mais que a entrada. Há ainda uma terceira coluna, de cache, mais barata, para quando você reenvia o mesmo trecho de instruções várias vezes.

Um exemplo brasileiro para fixar: uma loja quer classificar 1.000 mensagens de clientes por mês em “dúvida”, “troca” ou “reclamação”. Cada chamada leva umas 2.000 unidades de entrada (instruções + mensagem) e devolve 500 de saída. No total, 2 milhões de tokens de entrada e meio milhão de saída. Com os preços conferidos em outubro de 2026, isso custa cerca de US$ 0,45 por mês no gpt-6-luna da OpenAI ou no Claude Haiku 5.5 da Anthropic, e cerca de US$ 3,38 no Gemini 3.8 Flash pago. Nos modelos de topo — gpt-6-astra ou Claude Fable 5.1, ambos a US$ 10/US$ 50 —, a mesma tarefa sairia US$ 45.

Duas lições saem dessa conta. A escolha do modelo pesa muito mais que a do fornecedor. E para tarefas simples de classificação e resumo, não faz sentido começar pelo modelo mais caro.

O custo que a tabela não mostra: IOF, câmbio e créditos que vencem

Pagando com cartão brasileiro, some o IOF de 3,5% sobre transações internacionais com cartão de crédito e débito, alíquota prevista no art. 15-B, inciso VII, do Decreto 6.306/2007, com redação dada pelo Decreto 12.499/2025, segundo o texto compilado no site do Planalto. Entra também a conversão cambial do emissor do cartão. Nenhuma das três páginas de preço trata de impostos brasileiros.

O modelo de cobrança também muda o risco. A OpenAI trabalha com crédito pré-pago: compra mínima de US$ 5 e créditos que expiram em 1 ano, segundo a central de ajuda. A Anthropic informa que novos usuários recebem uma pequena quantia de créditos gratuitos para testar, sem dizer o valor. O Gemini tem tier gratuito em vários modelos Flash e, ao ativar faturamento, entra no Tier 1, com teto de gasto de US$ 250.

Um detalhe que pega quem planeja para 2027: a página de preços do Gemini traz valores com data de validade — o Gemini 3.8 Flash custa US$ 0,75/US$ 3,75 “até 31 de dezembro de 2026”. Se o seu orçamento é anual, confira a página de novo em janeiro.

As três opções que valem a pena

As três abaixo têm SDK oficial em Python, quickstart de poucas linhas e modelo barato o bastante para errar sem medo. A ordem não é de qualidade, e sim de facilidade para o iniciante: o Gemini vem primeiro porque é o único dos três em que dá para começar sem cartão.

O tier gratuito tem um preço: seus dados

O tier gratuito do Gemini é ótimo para aprender, mas a página de preços do Google é explícita: no tier gratuito, o conteúdo enviado é usado para melhorar os produtos do Google. No tier pago, não. Isso resolve a dúvida de forma simples: texto inventado, exemplo de tutorial, documento público — tier gratuito. Mensagem de cliente, CPF, endereço, dado de saúde, contrato — só no pago, com base legal registrada para atender à LGPD.

Em qualquer fornecedor, pago ou não, anonimize o que puder antes de mandar e leia a política de dados da API antes de colocar informação de cliente. Nosso texto sobre privacidade ao usar IA lista o que nunca deve sair da sua empresa sem avaliação.

Do zero à primeira resposta: roteiro em sete passos

Os três quickstarts seguem o mesmo desenho: criar a chave, guardar numa variável de ambiente (GEMINI_API_KEY, OPENAI_API_KEY ou ANTHROPIC_API_KEY), instalar o pacote (google-genai, openai ou anthropic) e rodar um script curto. Se você já tem Python instalado, o roteiro abaixo cabe numa tarde.

• 1. Escreva a tarefa em uma frase e separe 20 a 30 exemplos reais anonimizados, com a resposta certa anotada.
• 2. Pegue a chave no Google AI Studio (é criada automaticamente para novos usuários) e defina GEMINI_API_KEY no terminal.
• 3. Crie um ambiente virtual e rode pip install -U google-genai — se tiver dúvida, veja como instalar um projeto Python com ambiente isolado.
• 4. Rode o exemplo do quickstart com o modelo gemini-3.8-flash e depois troque o texto pelos seus exemplos.
• 5. Ajuste as instruções até acertar a maioria dos casos — o guia de como escrever bons prompts ajuda nessa etapa.
• 6. Quando for usar dados reais, crie conta paga na OpenAI (US$ 5 de crédito) ou na Anthropic e rode os mesmos exemplos no gpt-6-luna ou no Claude Haiku 5.5.
• 7. Compare acertos e custo, escolha um fornecedor e isole a chamada numa função própria para poder trocar depois. O passo a passo detalhado da OpenAI está no nosso guia inicial da API da OpenAI.

Veredito da Folha IA

Para aprender: Gemini API no tier gratuito. Sem cartão, sem IOF, chave pronta no AI Studio. Use só com dados que poderiam ser públicos.

Para o primeiro produto real: OpenAI API com gpt-6-luna. Custa o mesmo que o Claude Haiku 5.5 para prompts curtos (US$ 0,10/US$ 0,50 por milhão de tokens), tem cobrança pré-paga que limita o prejuízo a quanto você colocou de crédito.

Quando a escolha muda: se o produto lê contratos, processos ou PDFs grandes, a Anthropic passa a ser a primeira opção — todos os modelos Claude atuais têm janela de 1 milhão de tokens documentada. Mas atenção: o Haiku 5.5 fica cinco vezes mais caro acima de 100 mil tokens de prompt, então documentos longos pedem uma conta específica. E se a empresa já tem Google Cloud com faturamento e contrato, o Gemini pago pode ser o caminho mais simples.