API do GPT: use modelos GPT-6 no seu próprio código

Desenvolvedores acessam modelos GPT pela API da OpenAI ou por roteadores como o OpenRouter. Este guia mostra a primeira requisição, IDs de modelos, ajustes de raciocínio e custos de cada versão.

6 min de leituraAtualizado

Duas formas de chamar o GPT no seu código

Se você quer usar o GPT no seu próprio aplicativo, script ou planilha, precisa de acesso à API. Há dois caminhos comuns:

  • API da OpenAI em https://api.openai.com/v1. Você cria uma conta na plataforma da OpenAI, cadastra um método de pagamento, gera uma chave e faz chamadas diretas a modelos como gpt-6-luna ou gpt-6.1-terra.
  • OpenRouter em https://openrouter.ai/api/v1. Uma única chave dá acesso ao GPT junto a modelos de outras empresas, usando o mesmo formato de requisição para todos. Os IDs dos modelos GPT levam o prefixo openai/, como em openai/gpt-6-luna.

Ambos cobram por token, os pequenos pedaços de texto que o modelo lê e escreve. A entrada (seu prompt) e a saída (a resposta) têm preços separados, sendo a saída sempre a parte mais cara. Tokens de raciocínio, o "pensamento" interno que o modelo realiza antes de responder, também são faturados como saída.

Um aviso rápido antes de começar: o GPT.me não oferece uma API pública. Nosso chat é um site feito para pessoas. Para integração via código, use uma das duas opções acima.

Preços atuais do GPT

Preços por milhão de tokens para os modelos GPT-6 atuais, conforme listados no OpenRouter; a API da própria OpenAI pratica os mesmos valores-base.

ModeloID na API (OpenAI)EntradaEntrada em cacheSaída
GPT-6 Lunagpt-6-luna$0.10$0.01$0.50
GPT-6.1 Terragpt-6.1-terra$1$0.05$5
GPT-6 Solgpt-6-sol$2$0.20$10
GPT-6.1 Solgpt-6.1-sol$2$0.10$10
GPT-6 Astragpt-6-astra$10$1$50

Valores da tabela do OpenRouter, nov. de 2026. Todos os cinco modelos aceitam texto e imagens, retornam texto e contam com uma janela de contexto de 1.050.000 tokens com até 128.000 tokens de saída. Quando um único prompt ultrapassa 272.000 tokens, o OpenRouter dobra o valor da entrada e aumenta o da saída em 50% para essa requisição. O OpenRouter também oferece versões "pro" de cada modelo, executando o mesmo motor em um modo que consome muito mais tokens de raciocínio.

Chamando a OpenAI diretamente

A OpenAI oferece dois endpoints para texto: a nova Responses API, adotada em toda a documentação do GPT-6, e o endpoint clássico de Chat Completions, que ainda funciona para conversas simples. Crie uma chave na plataforma, salve-a em uma variável de ambiente chamada OPENAI_API_KEY e envie a requisição. Usando curl:

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-luna",
    "reasoning": { "effort": "none" },
    "input": "Liste três usos para um clipe de papel, um por linha."
  }'

A resposta vem em JSON; o texto gerado fica no array output. A biblioteca oficial em Python já extrai isso para você:

from openai import OpenAI

client = OpenAI()  # lê OPENAI_API_KEY

result = client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "low"},
    input="391 é um número primo? Explique em duas frases.",
)
print(result.output_text)

Instale com pip install openai. Essa biblioteca também está disponível para JavaScript e várias outras linguagens.

Chamando o GPT pelo OpenRouter

O OpenRouter usa o formato Chat Completions, então a maioria dos códigos compatíveis com a OpenAI funciona apenas trocando a URL base, a chave e o ID do modelo. O guia de início rápido traz todos os detalhes. Veja um exemplo em JavaScript puro, sem bibliotecas externas:

const OPENROUTER_URL = "https://openrouter.ai/api/v1/chat/completions";

const payload = {
  model: "openai/gpt-6-luna",
  max_tokens: 800,
  reasoning: { effort: "low" },
  messages: [
    { role: "system", content: "Responda de forma breve e direta." },
    { role: "user", content: "Qual é a diferença entre memória RAM e armazenamento?" },
  ],
};

const key = process.env.OPENROUTER_API_KEY;

const res = await fetch(OPENROUTER_URL, {
  method: "POST",
  body: JSON.stringify(payload),
  headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
});

const body = await res.json();
const text = body.choices?.[0]?.message?.content;
console.log(text ?? body);

Execute no Node 18 ou superior (que já traz fetch integrado), salvando o arquivo como .mjs para usar await no nível superior. Se nenhum texto for retornado, o script exibirá a resposta completa: o OpenRouter inclui um campo error com uma mensagem clara, por exemplo, se a chave for inválida ou se os créditos acabarem.

As páginas de cada modelo no OpenRouter, como GPT-6 Luna e GPT-6.1 Terra, mostram preços atualizados, provedores e parâmetros suportados.

Configurações que costumam gerar dúvidas

  • Esforço de raciocínio. GPT-6 Luna, GPT-6 Sol e GPT-6.1 Terra aceitam none, low, medium, high, xhigh e max, tendo medium como padrão no OpenRouter. GPT-6.1 Sol e GPT-6 Astra sempre raciocinam e não aceitam none. Na Responses API o campo é reasoning.effort; em Chat Completions, é reasoning_effort.
  • Temperatura. A documentação da OpenAI indica que temperature e top_p não são suportados enquanto o raciocínio estiver ativo; remova-os a menos que o esforço seja none. Códigos antigos que definem temperatura podem retornar erro.
  • Limite de saída. O raciocínio consome parte do limite de tokens. Se você definir um max_tokens muito baixo com um nível alto de raciocínio, o modelo pode esgotar o limite antes de escrever a resposta final.
  • Tools (ferramentas). As páginas da OpenAI destacam que a chamada de funções (function calling) no GPT-6.1 Terra requer a Responses API. Se o uso de ferramentas falhar via Chat Completions, troque de endpoint.

Como manter os custos baixos

  1. Comece pelo Luna. Custando um décimo do Terra, ele se sai muito bem em resumos, extração, classificação e respostas curtas. Só migre para modelos superiores em tarefas em que ele falhar.
  2. Mantenha o esforço de raciocínio baixo. Cada nível a mais de raciocínio costuma gerar mais tokens ocultos de saída. Use none ou low para tarefas simples.
  3. Aproveite o prefixo em cache. A entrada em cache custa um décimo da entrada comum ou até menos. Coloque instruções longas e fixas logo no início de cada prompt para que as requisições recorrentes aproveitem o cache.
  4. Fique abaixo de 272.000 tokens por prompt sempre que possível, evitando a taxa extra para contextos longos.
  5. Defina um limite de gastos no painel da sua conta para evitar surpresas no orçamento caso ocorra um loop infinito no código.
  6. Envie apenas o histórico necessário. Em cada requisição, você paga novamente por toda a conversa acumulada. Mantenha apenas as interações indispensáveis para o contexto ou substitua as mensagens antigas por um resumo curto.

Uma estimativa prática: um token equivale a cerca de três quartos de uma palavra em inglês. Uma pergunta e uma resposta de algumas centenas de palavras somam cerca de mil tokens no total; logo, o custo por requisição corresponde ao valor por milhão exibido na tabela dividido por mil, somado aos eventuais tokens de raciocínio. Acompanhe o campo usage em cada resposta para conferir o consumo real dos seus prompts.

Para suporte de programação além da API, confira nosso guia de GPT para programação e a página para desenvolvedores. Para testar um prompt antes de escrever qualquer código, experimente primeiro no nosso chat com GPT-6 Luna.

Perguntas frequentes

A API do GPT é gratuita?

Não. Tanto a OpenAI quanto o OpenRouter cobram por token. Um teste rápido com o GPT-6 Luna custa uma fração de centavo, mas ainda assim exige uma conta com método de pagamento configurado.

Devo usar a OpenAI diretamente ou o OpenRouter?

Prefira o acesso direto se você só precisa do GPT e quer acesso imediato a todas as novidades da OpenAI. Escolha o OpenRouter se deseja alternar entre GPT, Claude, Gemini e outros modelos com apenas uma chave e uma única fatura.

Por qual modelo devo começar?

GPT-6 Luna pela velocidade e pelo custo-benefício; GPT-6.1 Terra para uma escrita mais refinada, compreensão visual e raciocínio avançado; e GPT-6.1 Sol ou GPT-6 Astra apenas para as análises e tarefas de programação mais exigentes.

O GPT.me tem uma API?

Não. O GPT.me é um site de chat gratuito. Para integração via código, utilize a API da OpenAI ou o OpenRouter.

Tem uma dúvida? Pergunte agora

Sem conta e sem downloads. Abra o chat, digite o que quiser e a resposta começará a surgir em poucos segundos.

Começar a conversar