API da OpenAI: guia inicial com chave, código e custo real

O que você precisa ter antes da primeira chamada

O problema típico de quem procura a API da OpenAI não é entender o que é uma API. É sair do ChatGPT, onde tudo funciona com um clique, e cair num painel de desenvolvedor com chaves, créditos, tiers e uma lista de modelos com preços diferentes por milhão de tokens. O medo é legítimo: errar a configuração e receber uma fatura em dólar no cartão.

A boa notícia é que o caminho mínimo é curto e controlável. Pela documentação atual, você precisa de três coisas: uma conta na plataforma da OpenAI, uma chave de API guardada na variável de ambiente OPENAI_API_KEY e o SDK oficial instalado com pip install openai. A cobrança é pré-paga: a página de ajuda sobre prepaid billing informa compra mínima de US$ 5, valor padrão sugerido de US$ 10 na primeira compra e créditos que expiram em 1 ano. Ou seja, comprar US$ 100 “para garantir” é uma má ideia se você ainda está validando a ideia.

Se você nunca programou em Python fora de um notebook, vale ler antes nosso guia sobre como instalar um projeto Python com ambiente isolado — o mesmo cuidado com venv serve aqui.

• Conta na plataforma da OpenAI (separada da assinatura do ChatGPT; uma não paga a outra).
• Crédito pré-pago: mínimo de US$ 5, válido por 1 ano.
• Chave de API em variável de ambiente, nunca colada no código.
• Python com o pacote openai instalado em um ambiente virtual.

O primeiro código, igual ao da documentação

O quickstart oficial da OpenAI hoje é inteiro construído sobre a Responses API (client.responses.create). O exemplo mínimo em Python, conferido na documentação em outubro de 2026, tem cinco linhas úteis: importar a classe OpenAI, criar o cliente (que lê a chave da variável de ambiente sozinho), chamar responses.create com um modelo e um texto de entrada, e imprimir response.output_text.

No exemplo oficial o modelo usado é gpt-6-astra, o topo de linha. Para aprender, troque por gpt-6-luna: o código é o mesmo e o custo por token é cem vezes menor, segundo a página de preços. Salve como exemplo.py e rode python exemplo.py.

• export OPENAI_API_KEY="sua_chave" (macOS/Linux) ou setx OPENAI_API_KEY "sua_chave" (Windows PowerShell)
• pip install openai
• from openai import OpenAI
• client = OpenAI()
• response = client.responses.create(model="gpt-6-luna", input="Resuma em uma frase o que é Pix.")
• print(response.output_text)

Quanto custa de verdade: a conta em dólar e o IOF

A página de preços da OpenAI lista três modelos principais no tier Standard, por milhão de tokens: gpt-6-astra a US$ 10 de entrada e US$ 50 de saída; gpt-6.1-sol a US$ 2 e US$ 10; gpt-6-luna a US$ 0,10 e US$ 0,50. Entrada em cache sai bem mais barata (US$ 1, US$ 0,10 e US$ 0,01, respectivamente), e contextos longos têm preço maior.

Faça a conta com um caso brasileiro concreto: um robô que responde dúvidas de clientes de uma loja no WhatsApp, com 1.000 atendimentos por mês, cada um com cerca de 2.000 tokens de entrada (instruções + histórico + pergunta) e 500 de saída. Isso dá 2 milhões de tokens de entrada e 0,5 milhão de saída. No gpt-6-luna, são cerca de US$ 0,45 por mês; no gpt-6.1-sol, US$ 9; no gpt-6-astra, US$ 45. A escolha do modelo pesa cem vezes mais que qualquer otimização de prompt.

Para quem paga 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. Além disso, entra a conversão cambial do emissor do cartão. A página de prepaid billing da OpenAI não trata de impostos locais.

Se a tarefa não precisa de resposta imediata — classificar 10 mil avaliações de produto, por exemplo —, a Batch API dá 50% de desconto em troca de uma janela de conclusão de até 24 horas.

Limites de uso, tiers e o teto que você mesmo define

A OpenAI controla o uso em duas camadas. A primeira são os tiers da conta, que sobem automaticamente conforme o total de créditos comprados. Pela documentação de rate limits, existe um tier Free com limite de US$ 100 de uso mensal para quem está numa geografia permitida (não confirmamos na documentação se o Brasil está incluído), e três tiers pagos: Build (a partir de US$ 5 comprados, até US$ 500/mês), Launch (US$ 100, até US$ 5.000/mês) e Grow (US$ 500, até US$ 200.000/mês).

A segunda camada são os limites por minuto e por dia — requisições (RPM/RPD) e tokens (TPM/TPD) —, que variam por modelo e valem para a organização e para cada projeto. O que bater primeiro trava a chamada. Seu código precisa tratar esse erro com espera e nova tentativa, em vez de quebrar na cara do cliente.

A camada que mais protege seu bolso é a que você configura: na recarga automática, a OpenAI permite definir um limite mensal de compras automáticas. Para um protótipo, deixe a recarga automática desligada. Se o crédito acabar, a API para — e isso é exatamente o que você quer enquanto testa.

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

Este guia é sobre a OpenAI, mas não recomendamos acoplar um produto a um único fornecedor sem antes rodar o mesmo teste em pelo menos uma alternativa. As três abaixo têm SDK oficial em Python, cobrança por token e quickstart de poucas linhas. Para uma comparação do lado do usuário final, veja ChatGPT vs Claude vs Gemini.

Segurança da chave e dos dados: o que a documentação exige

A central de ajuda da OpenAI tem uma lista objetiva de boas práticas de segurança de chaves. As que mais pegam iniciantes: nunca colocar a chave em código que roda no navegador ou num app de celular (a requisição precisa passar pelo seu backend), nunca fazer commit da chave em repositório — nem privado —, usar uma chave por pessoa da equipe e criar chaves com data de expiração e rotação.

Sobre dados: segundo a página Your data, o que é enviado à API não é usado para treinar modelos da OpenAI, a menos que você opte por compartilhar. Mesmo assim, logs de monitoramento de abuso são mantidos por até 30 dias por padrão. Se o seu caso envolve CPF, dados de saúde ou conversas de clientes, isso tem implicação de LGPD — registre a base legal e informe o titular. Nosso texto sobre privacidade ao usar IA detalha o que não enviar.

• Chave só no servidor, em variável de ambiente ou gerenciador de segredos.
• Uma chave por pessoa e por projeto; revogue a de quem sair.
• Defina expiração e rotacione ao menor sinal de vazamento.
• Não registre em log o conteúdo completo das conversas com dados pessoais.

Roteiro para sair do zero a um protótipo

A ordem importa. Quem começa pelo código e deixa custo e avaliação para depois costuma descobrir os problemas em produção.

• 1. Escreva em uma frase a tarefa que a API vai fazer (ex.: “classificar mensagens de clientes em dúvida, reclamação ou pedido”).
• 2. Separe 30 exemplos reais anonimizados, com a resposta certa anotada por você.
• 3. Crie a conta, compre US$ 5 de crédito, deixe a recarga automática desligada e gere uma chave com expiração.
• 4. Rode o exemplo mínimo com gpt-6-luna e depois o seu caso, lendo os 30 exemplos de um arquivo.
• 5. Compare as respostas com o gabarito. Se errar mais do que você tolera, repita só com gpt-6.1-sol e meça de novo.
• 6. Isole a chamada à OpenAI numa função própria (ex.: gerar_resposta()), para trocar de fornecedor sem reescrever o sistema.
• 7. Rode os mesmos 30 exemplos na API da Anthropic ou do Gemini antes de decidir. Para entender por que respostas erradas soam convincentes, leia sobre alucinações de IA.

Veredito da Folha IA

Primeira escolha: OpenAI API com gpt-6-luna na Responses API. É o caminho com menor custo de entrada, documentação em que o exemplo oficial roda com cinco linhas e cobrança pré-paga que limita o prejuízo a US$ 5 enquanto você aprende. Para a maioria dos protótipos de texto — classificar, resumir, responder perguntas sobre um catálogo —, o modelo mais barato resolve, e a conta mensal fica em centavos de dólar.

Quando a escolha muda: se o seu teste com casos reais mostrar que o gpt-6-luna erra demais, suba para o gpt-6.1-sol antes de ir ao gpt-6-astra, que custa cinco vezes mais. Se o produto gira em torno de ler contratos, processos ou PDFs extensos e você precisa de contexto de 1 milhão de tokens documentado, a API da Anthropic merece ser a principal. E se você quer apenas aprender sem cadastrar cartão, comece pelo tier gratuito do Gemini — sabendo que, ali, o conteúdo enviado pode ser usado pelo Google para melhorar produtos. Para um panorama mais amplo, veja nosso guia de API de IA para iniciantes.