Como usar a API do ChatGPT: guia do primeiro projeto em Python

Se cê tá começando agora no mundo da inteligência artificial, já deve ter percebido que o Python é a língua oficial da conversa. E a porta de entrada mais comum é a API da OpenAI. A boa notícia é que, com a chegada do Python 3.15.0rc2, o ambiente para desenvolver está ficando cada vez mais redondo e estável para as grandes novidades que vêm por aí em outubro.

Neste guia, vou te mostrar como tirar o seu primeiro projeto do papel, configurar a chave de acesso e rodar um código que realmente funciona, sem enrolação e pensando no bolso de quem paga em reais.

Como configurar a API do ChatGPT para o primeiro projeto?

O primeiro passo é entender que a API não é de graça, mas custa pouco para quem está testando. Cê precisa criar uma conta na OpenAI Platform e gerar uma API Key.

Dica de ouro: a OpenAI funciona com sistema de créditos pré-pagos. Cê pode colocar, por exemplo, uns 5 dólares (cerca de R$ 28,00 na cotação atual) e isso vai render milhares de perguntas se cê usar modelos mais leves.

1. Acesse a aba "API Keys" no painel da OpenAI.
2. Clique em "Create new secret key" e guarde esse código como se fosse a senha do seu banco. Se perder, terá que criar outra.
3. No seu computador, instale a biblioteca oficial usando o terminal: pip install openai

Como o Python 3.15 está quase saindo do forno (versão estável prevista para 1º de outubro de 2026), é bom garantir que seu ambiente venv esteja atualizado, mas para produção, continue usando o Python 3.12 ou 3.13 por enquanto.

Qual modelo escolher para não gastar muito?

Para quem está começando, o erro mais comum é querer usar sempre o modelo mais potente. Em 2026, a briga entre as melhores LLMs está feia, e a OpenAI cortou preços para competir.

Modelo	Preço (1M tokens - Entrada)	Indicação
GPT-4o mini	R$ 0,85 (aprox.)	Testes, bots simples e automação rápida.
GPT-4o	R$ 28,00 (aprox.)	Tarefas complexas que exigem raciocínio fino.
GPT-5.6 Sol	R$ 45,00 (aprox.)	O topo de linha para agentes autônomos.

Valores estimados com base no dólar a R$ 5,60.

Mão na massa: seu primeiro script em Python

Crie um arquivo chamado meu_chat.py e cole o código abaixo. Ele usa a estrutura mais atual da biblioteca da OpenAI:

from openai import OpenAI

# Inicializa o cliente (ele busca a chave na sua variável de ambiente)
client = OpenAI(api_key="SUA_CHAVE_AQUI")

response = client.chat.completions.create(
  model="gpt-4o-mini",
  messages=[
    {"role": "system", "content": "Você é um assistente mineiro muito prestativo."},
    {"role": "user", "content": "Explica pra mim o que é uma API como se fosse no balcão da padaria."}
  ]
)

print(response.choices[0].message.content)

Por que importa?

Aprender a manipular a API do ChatGPT é a base para criar desde bots de atendimento até sistemas de análise de dados complexos. Como a OpenAI abriu escritório em São Paulo, a tendência é que o suporte e a integração com empresas brasileiras só aumentem. Dominar isso agora é garantir que cê não vai ficar para trás quando o mercado nacional acelerar de vez. Não é trem pouco, não!

Perguntas Frequentes (FAQ)

1. Minha chave deu erro de "Quota Exceeded", o que fazer? Isso acontece se cê não colocou créditos na conta ou se o limite gratuito de novos usuários expirou. Vá em Settings > Billing e adicione pelo menos 5 dólares.

2. É seguro colocar a chave direto no código? Para testes rápidos, tudo bem. Mas para projetos reais, use variáveis de ambiente (.env). Nunca suba sua chave para o GitHub, ou alguém vai gastar seus créditos em minutos.

3. Posso usar a API para criar um bot de WhatsApp? Pode sim, mas aí cê vai precisar de um intermediário (como a API oficial da Meta ou serviços como Twilio) para conectar o Python ao zap.

4. O Python 3.15 muda algo no código da API? Por enquanto nada na sintaxe básica, mas a nova versão traz um sampling profiler que ajuda muito a descobrir por que seu script de IA está lento. Coisa boa demais da conta para quem quer otimizar custo de servidor.