GPT-6.1 Terra na API: código, Flex e custo por fatura

👁 114 leituras

O GPT-6.1 Terra está disponível na API da OpenAI como gpt-6.1-terra e na OpenRouter como openai/gpt-6.1-terra. A seguir, veja exemplos em Python e JavaScript para extrair dados de uma fatura para um JSON com esquema fixo e criar um texto curto para e-mail. Também comparei três modos da OpenAI na OpenRouter. No teste que executei em polonês em 26 de outubro de 2026, a leitura de uma fatura custou US$ 0,00097 no modo Standard e US$ 0,00049 no Flex, que também foi mais rápido nessa medição.

O que o Terra oferece na API

Dados da página do modelo na documentação da OpenAI, consultada em 26/10/2026. Entre as ferramentas disponíveis na Responses API estão web_search, file_search, code_interpreter, computer_use, mcp e apply_patch. Se você está criando sua primeira conta de API, explico como obter uma chave e fazer o primeiro pedido em API da OpenAI: chave, preços e primeira solicitação.

Python: transformar uma fatura em JSON

A OpenAI cita a leitura de faturas como um dos usos do Terra, então comecei por esse caso. A entrada era o texto de uma fatura de uma gráfica para uma clínica, com número, datas, identificadores fiscais com hífens, três itens e valores. A saída precisa seguir o esquema JSON: com "strict": True, o modelo não pode acrescentar nem omitir campos. Usei a biblioteca requests e a OpenRouter, por onde fiz todos os testes. O teste original usou uma fatura e instruções em polonês; os textos abaixo são traduções para o português do material testado, não um novo teste em português:

import os, json, requests

URL = ("https://openrouter.ai/api/v1"
       "/chat/completions")
KEY = os.environ["OPENROUTER_API_KEY"]

schema = {
  "type": "object",
  "properties": {
    "number": {"type": "string"},
    "date": {"type": "string"},
    "seller_tax_id": {"type": "string"},
    "items": {"type": "array",
      "items": {
      "type": "object",
      "properties": {
        "name": {"type": "string"},
        "net": {"type": "number"}},
      "required": ["name", "net"],
      "additionalProperties": False}},
    "gross": {"type": "number"},
    "due_date": {"type": "string"}},
  "required": ["number", "date",
    "seller_tax_id", "items",
    "gross", "due_date"],
  "additionalProperties": False}

def invoice(text, mode="openai"):
    body = {
      "model": "openai/gpt-6.1-terra",
      "messages": [
        {"role": "system", "content":
         "Extraia dados de faturas. Datas"
         " no formato AAAA-MM-DD; identificador"
         " fiscal sem hífens."},
        {"role": "user",
         "content": text}],
      "reasoning": {"effort": "low"},
      "response_format": {
        "type": "json_schema",
        "json_schema": {"name": "invoice",
          "strict": True,
          "schema": schema}},
      "provider": {"only": [mode]},
      "usage": {"include": True}}
    r = requests.post(URL, json=body,
        timeout=120, headers={
        "Authorization": f"Bearer {KEY}"})
    r.raise_for_status()
    j = r.json()
    msg = j["choices"][0]["message"]
    data = json.loads(msg["content"])
    return data, j["usage"]

Trecho da fatura original, traduzido para o português: “Vendedor: Gráfica Lipa Ltda. (…) Identificador fiscal 946-27-18-305”, “Data de emissão: 26/10/2026” e “Data de vencimento: 09/11/2026”. A resposta do Terra, abreviada em dois itens, também é uma tradução do resultado do teste original em polonês:

{
 "number": "FV/10/2026/118",
 "date": "2026-10-26",
 "seller_tax_id": "9462718305",
 "items": [
  {"name": "Folhetos A5, 170 g",
   "net": 950.0}, ...],
 "gross": 1923.72,
 "due_date": "2026-11-09"
}

As datas foram convertidas para o formato ISO, os hífens foram removidos do identificador fiscal e o valor bruto foi extraído da linha “total a pagar: 1923,72” da fatura original. O separador decimal foi convertido de vírgula para ponto. Consumo: 384 tokens de entrada, 120 de saída e US$ 0,000984. Mil faturas como essa custariam cerca de US$ 0,98. Esses resultados vêm do teste original em polonês; a tradução do exemplo não foi retestada.

Três parâmetros que vale a pena copiar:

• "reasoning": {"effort": "low"} - low é suficiente para extrair campos. Medium usaria mais tokens de raciocínio, cobrados como tokens de saída. Compare os níveis no teste GPT-6.1 Terra: low, medium ou max.
• "provider": {"only": ["openai"]} - sem essa opção, a OpenRouter pode encaminhar a solicitação para outro endpoint. Aqui você escolhe o modo: openai, openai/flex ou openai/fast.
• "usage": {"include": True} - a resposta inclui o custo em dólares, sem que você precise calculá-lo.

Standard, Flex ou Fast: resultados da medição

Na OpenRouter, o Terra tem três endpoints da OpenAI. Enviei a mesma fatura cinco vezes para cada um, uma chamada de cada vez, em 26/10/2026, por volta das 21h45. O material do teste estava em polonês:

As 15 respostas tinham o identificador fiscal e o valor bruto corretos. O Flex foi o mais rápido, mas essa medição se baseia em cinco chamadas feitas na noite de 26 de outubro, não é uma regra: com outra carga, a ordem pode mudar. O Fast custa o dobro do Standard e, nessa medição, não foi mais rápido que o Flex. Para processamento em segundo plano, eu escolheria Flex ou Batch (mesmo preço de US$ 0,50 / US$ 2,50); para respostas em tempo real, Standard.

JavaScript: criar um texto para e-mail

O mesmo modelo com Node.js (a versão 18 ou posterior inclui fetch), desta vez usando Flex e o nível medium. O texto exibido é uma tradução do pedido usado no teste original em polonês, não um novo teste em português:

const URL = "https://openrouter.ai" +
  "/api/v1/chat/completions";
const KEY =
  process.env.OPENROUTER_API_KEY;
const r = await fetch(URL, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${KEY}`,
    "Content-Type": "application/json"},
  body: JSON.stringify({
    model: "openai/gpt-6.1-terra",
    reasoning: { effort: "medium" },
    provider: { only: ["openai/flex"] },
    usage: { include: true },
    messages: [{ role: "user", content:
      "Escreva 3 assuntos de e-mail com " +
      "um lembrete sobre a fatura " +
      "FV/10/2026/118 no valor de US$ 489,58." +
      " Sem pontos de exclamação." }]
  })});
const j = await r.json();
const msg = j.choices[0].message;
console.log(msg.content);

Resposta do Terra, traduzida do resultado do teste original em polonês:

1. Lembrete sobre a fatura FV/10/2026/118
   no valor de US$ 489,58
2. Solicitação de pagamento da fatura
   FV/10/2026/118
3. Pagamento de US$ 489,58 - fatura
   FV/10/2026/118

47 tokens de entrada, 77 de saída e US$ 0,000216. A resposta não usou pontos de exclamação e incluiu o número da fatura e o valor em cada assunto. A conversão do valor para dólares serve apenas para apresentar o exemplo traduzido; o teste foi feito com o texto original em polonês.

O que observar no custo

• Limite de 272 mil tokens. Se uma solicitação tiver mais tokens de entrada, o conteúdo inteiro será cobrado a US$ 2 por milhão de tokens de entrada e US$ 7,50 por milhão de tokens de saída. Para documentos longos, considere dividir o conteúdo.
• Cache. Repetir o início da solicitação (por exemplo, o mesmo esquema e as mesmas instruções) custa US$ 0,05 por milhão de tokens, em vez de US$ 1.
• Processamento regional (dados em uma região escolhida) acrescenta 10% ao preço.

Os resultados do Terra em tarefas em polonês estão no guia GPT-6.1 Terra. Os exemplos de teste apresentados neste artigo também foram originalmente executados em polonês; suas traduções não são resultados de testes em português.

Perguntas frequentes

Qual é o nome do GPT-6.1 Terra na API?

gpt-6.1-terra na API da OpenAI e openai/gpt-6.1-terra na OpenRouter. A versão datada na OpenRouter é openai/gpt-6.1-terra-20261026.

O Terra funciona com Chat Completions?

Sim, além de Responses e Batch. Ferramentas como uso do computador e busca na web exigem a Responses API.

Quanto custa ler uma fatura com o Terra?

Na medição feita com o teste original em polonês, custou US$ 0,000972 no modo Standard e US$ 0,000492 no Flex, com cerca de 380 tokens de entrada e 120 de saída, no nível de raciocínio low.

Fontes e data da consulta

• API da OpenAI: modelo GPT-6.1 Terra - endpoints, ferramentas, contexto, limites e preços (consulta em 26/10/2026)
• OpenAI: apresentação do GPT-6.1 Terra - leitura de faturas como caso de uso (consulta em 26/10/2026)
• OpenRouter: endpoints do GPT-6.1 Terra - modos openai, openai/flex e openai/fast e seus preços (consulta em 26/10/2026)
• Medição do autor: Python 3.13 + requests, Node.js 26, OpenRouter, 26/10/2026, aproximadamente das 21h40 às 21h50. Os testes foram feitos em polonês.

// continue lendoModelo de decisão vs. LLM: custo de 1 milhão de classificaçõesBenchmarksGPT-6 Sol e Luna: preços da API e custo por tarefaBenchmarksRaven: como uma foto pode revelar onde você moraGeral