OpenAI API — primeira chamada, streaming e controle de custo

1. Pegar a chave

Crie conta em platform.openai.com, vá em API Keys → Create new secret key. Adicione crédito na aba Billing (mínimo US$5). Guarde a chave em variável de ambiente, nunca no lado cliente.

2. Primeira chamada (TypeScript)

import OpenAI from "openai";
const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
const res = await client.chat.completions.create({
  model: "gpt-5-mini",
  messages: [{ role: "user", content: "Explique RLHF em 2 frases." }],
});
console.log(res.choices[0].message.content);

3. Streaming

const stream = await client.chat.completions.create({
  model: "gpt-5-mini",
  messages: [{ role: "user", content: "Escreva um haiku sobre TypeScript" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

4. Structured outputs

const res = await client.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Extraia nome e email: João <joao@x.com>" }],
  response_format: { type: "json_schema", json_schema: {
    name: "Contact",
    schema: { type: "object", required: ["name","email"],
      properties: { name: {type:"string"}, email: {type:"string"} } },
    strict: true,
  }},
});

5. Controle de custo

• •Use `gpt-5-mini` como padrão; suba pra `gpt-5` só no que exige raciocínio
• •Ative cache de prompt — 50–90% de desconto em prefixos repetidos
• •Trunque histórico antigo (mantenha últimas N mensagens)
• •Limite requisições no seu lado pra não estourar o mensal