Como usar a API da OpenAI — guia prático pra quem está começando

Usar o ChatGPT pelo navegador é ótimo, mas tem um limite: você fica preso na interface deles. Quando você quer integrar IA no seu próprio projeto — um bot, um script, uma aplicação — é aí que a API entra.

Esse guia vai do zero até a sua primeira requisição funcionando, em Python. Sem enrolação.

Passo 1: criar sua conta e gerar a API key

• 1

  Acesse platform.openai.com

  Crie uma conta ou faça login. É separado da conta do ChatGPT, mas você pode usar o mesmo e-mail.

• 2

  Adicione crédito

  Vá em Billing → Add payment method. Coloque uns US$ 5 pra começar — dá pra fazer muita coisa com isso usando o GPT-4o mini.

• 3

  Gere sua API key

  Vá em API Keys → Create new secret key. Dê um nome descritivo e copie a chave — ela só aparece uma vez. Guarde em lugar seguro, nunca suba pro GitHub.

Passo 2: instalar a biblioteca

Abra o terminal e instale o SDK oficial da OpenAI:

# instalar a biblioteca oficial
pip install openai

Passo 3: sua primeira requisição

Crie um arquivo chamado teste.py e cole o código abaixo:

from openai import OpenAI

# inicializa o cliente com sua chave
client = OpenAI(api_key="sk-...")  # substitua pela sua chave

# faz uma requisicao simples
response = client.chat.completions.create(
    model="gpt-4o-mini",  # mais barato pra testar
    messages=[
        {
            "role": "user",
            "content": "Explique o que e machine learning em 3 linhas."
        }
    ]
)

# imprime a resposta
print(response.choices[0].message.content)

Rode com python teste.py e você vai ver a resposta aparecer no terminal. Pronto — você já está usando a API.

Como funciona a estrutura de mensagens

O campo messages aceita um array de objetos com dois campos: role e content. Os roles possíveis são:

• system: instrucões gerais pro modelo seguir durante toda a conversa
• user: a mensagem do usuário
• assistant: resposta anterior do modelo (pra manter contexto de conversa)

# exemplo com system prompt e historico
response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {
            "role": "system",
            "content": "Voce e um assistente especialista em Python. Responda sempre em portugues."
        },
        {
            "role": "user",
            "content": "Qual a diferenca entre lista e tupla?"
        }
    ]
)

Entendendo os custos

A API cobra por token — pedaços de texto de aproximadamente 4 caracteres cada. Uma mensagem curta tem ~50 tokens, um texto longo pode ter milhares. Os preços variam por modelo:

• GPT-4o mini: US$ 0,15 por milhão de tokens de entrada — o mais barato, ideal pra testes
• GPT-4o: US$ 5,00 por milhão de tokens de entrada — modelo principal
• GPT-4o (saída): US$ 15,00 por milhão de tokens — o output é sempre mais caro

Na prática, US$ 5 de crédito no GPT-4o mini dá pra fazer centenas de requisições. Pra aprender, é mais que suficiente.

Dica: configure um limite de gasto mensal no painel da OpenAI (Billing → Usage limits). Assim você não tem surpresa no cartão se algum script entrar em loop.

Próximos passos

Com a base funcionando, você pode explorar:

• Streaming: receber a resposta palavra por palavra, como o ChatGPT faz
• Function calling: fazer o modelo chamar funções do seu código
• Embeddings: transformar texto em vetores pra buscas semânticas
• Vision: enviar imagens junto com o texto

A documentação oficial da OpenAI é muito boa e cobre tudo isso com exemplos. Vale bookmarkar.