Construa com CometAPIPrecisa de uma API para vários modelos?Teste o fluxo no Playground e depois crie uma chave da API quando o modelo e o custo atenderem ao seu caso de uso.
como acessar o GPT-6.1 Terra de forma mais econômica por meio da CometAPI e abordar configuração, exemplos de código, estratégias de raciocínio, melhores práticas, comparações
GPT-6.1 Terra (gpt-6.1-terra) é o modelo intermediário da OpenAI lançado em 26 de outubro de 2026. Oferece raciocínio visual robusto, uso de computador preciso e escrita natural a metade do preço de GPT-6.1 Sol e GPT-5.6 Terra ($1 de entrada / $5 de saída por milhão de tokens, padrão). Com uma janela de contexto de 1,05M de tokens, esforço de raciocínio configurável (de nenhum ao máximo), entrada de imagem e suporte completo a ferramentas via a Responses API, é ideal para fluxos de trabalho orientados a agentes em alto volume, como processamento de faturas, interpretação de desenhos técnicos, interação com a tela e revisão de documentos. Este guia cobre a configuração exata, exemplos de código, estratégias de raciocínio, boas práticas, comparações e como acessá-lo de forma mais econômica pela CometAPI.
Principais pontos
ID do modelo: gpt-6.1-terra — janela de contexto de 1,050,000, 128,000 tokens máximos de saída, corte de conhecimento em 1º de junho de 2026.
Preços (padrão OpenAI): $1 / $5 por 1M de tokens de entrada/saída; entrada em cache $0.05; long-context (>272K de entrada) e Fast mode custam mais.
Revisado para maior clareza, atribuição de fontes e terminologia de API atual.
Melhor para tarefas visuais + uso de computador; supera significativamente o GPT-5.6 Terra, igualando ou aproximando-se de modelos de nível superior a custo muito menor e maior velocidade.
Prefira a Responses API para chamada de ferramentas, uso de computador, saídas estruturadas e controle de raciocínio.
A CometAPI oferece o mesmo modelo com tarifas descontadas (cerca de $0.80 / $4.00) com uma única chave compatível com OpenAI para 500+ modelos, permitindo troca fácil e economia contínua de 20–40%.
O que é o GPT-6.1 Terra?
GPT-6.1 Terra é o modelo rápido e eficiente de nível intermediário da família GPT-6.1, posicionado entre o leve Luna e os níveis mais capazes Sol/Astra. O posicionamento oficial enfatiza raciocínio visual detalhado, uso de computador preciso (interação com a tela, preenchimento de formulários, controle de aplicativos) e escrita natural mais clara.
Aceita entradas de texto e imagem e produz saída em texto. Não oferece suporte nativo a entrada/saída de áudio ou vídeo. Capacidades-chave incluem streaming, saídas estruturadas, chamada de funções, cache de prompt, pesquisa na web, pesquisa de arquivos, uso de computador, interpretador de código e mais — principalmente por meio da Responses API.
A OpenAI destaca grandes ganhos em relação ao GPT-5.6 Terra: pontuações mais altas no Agents’ Last Exam (tarefas profissionais de uso de computador) por cerca de um terço do custo, quase paridade com o GPT-6 Astra em alguns benchmarks visuais e de agentes a ~1/10 do preço por token, taxas de alucinação substancialmente menores e mais de 3× mais rápido na conclusão de tarefas do que Sol ou Astra em cargas de trabalho relevantes.
Especificações e preços do GPT-6.1 Terra
Especificação
Detalhes
Model ID
gpt-6.1-terra
Context Window
1,050,000 tokens
Max Input Tokens
~922,000
Max Output Tokens
128,000
Knowledge Cutoff
1º de junho de 2026
Input Modalities
Texto, Imagem
Output Modalities
Texto
Reasoning Effort Levels
none, low, medium (padrão), high, xhigh, max
Supported Endpoints
Chat Completions, Responses, Batch
Tool Calling
Requer Responses API
Fine-tuning
Não suportado
Preços padrão da OpenAI (por 1M de tokens)
Entrada: $1.00
Entrada em cache: $0.05
Gravações de cache (retenção de 30 min): $1.25
Saída: $5.00
Observações: Prompts que excedem 272K tokens de entrada incorrem em 2× nas tarifas de entrada/cache e 1,5× na tarifa de saída para toda a solicitação. Batch/Flex são 50% menores; Fast mode é 2×. Processamento regional pode adicionar acréscimos.
A CometAPI atualmente lista o GPT-6.1 Terra a aproximadamente $0.80 de entrada / $4.00 de saída (confirme no painel), proporcionando economia significativa enquanto oferece um endpoint unificado compatível com OpenAI.
Como configurar a API do GPT-6.1 Terra
Direto na OpenAI
Crie ou use um projeto da OpenAI com acesso à API (Build tier e acima; o Free tier não é compatível com este modelo).
Gere uma chave de API e armazene-a com segurança (variável de ambiente ou gerenciador de segredos).
Instale o SDK mais recente da OpenAI: pip install --upgrade openai (Python) ou npm install openai (Node.js).
Via CometAPI (recomendado para a maioria dos usos em produção e multi-modelo)
Como acessar a API do GPT-6.1 Terra na CometAPI?
Conta e credenciais
Acesse CometAPI, gere uma chave de API e confirme que gpt-6.1-terra está disponível. Armazene a credencial como variável de ambiente, não no código-fonte da sua aplicação.
Uma chave da CometAPI autentica solicitações à CometAPI. Mantenha-a no seu ambiente de desenvolvimento ou backend; não a incorpore em uma página web pública nem faça commit no controle de versão. A variável de ambiente deve estar disponível no terminal que executa seu script.
Defina a chave no Bash.
export COMETAPI_KEY="your_cometapi_api_key"
No Windows, defina a mesma variável no PowerShell.
$env:COMETAPI_KEY="your_cometapi_api_key"
Uma primeira solicitação pequena e específica
Use um prompt curto de texto e uma resposta antes de adicionar dados de imagem, um schema JSON ou funções. Confirme o acesso ao modelo e a URL base https://api.cometapi.com/v1. Se sua conta oferecer várias rotas, escolha aquela cuja documentação abrange os recursos que você planeja usar.
Como usar uma resposta da API GPT-6.1 Terra?
Envie a primeira solicitação de texto
Adicione o código a seguir após a configuração do cliente e salve o script combinado como first_request.py. Ele solicita uma resposta curta, verifica a conclusão e grava o texto em um arquivo UTF-8.
Gere uma resposta em texto, verifique a conclusão e salve answer.txt.
from pathlib import Path
response = client.responses.create(
model="gpt-6.1-terra",
instructions="You are a concise technical writing assistant.",
input="Summarize three common causes of failed API integrations and their fixes.",
reasoning={"effort": "medium"},
max_output_tokens=2000,
)
if response.status != "completed":
raise RuntimeError(
f"Response status: {response.status}; "f"details: {response.incomplete_details}"
)
ifnot response.output_text.strip():
raise RuntimeError("No text returned; inspect response.output")
Path("answer.txt").write_text(response.output_text, encoding="utf-8")
print(response.output_text)
print("Saved answer.txt")
print(response.usage)
Run the combined client-and-request script.
python first_request.py
Verifique a resposta salva
Abra answer.txt e confirme que a resposta atende ao prompt e contém todas as três causas e correções solicitadas. Uma resposta de API concluída estabelece que a geração terminou; sua aplicação ainda precisa verificar se o conteúdo atende aos requisitos. Mantenha o registro de uso retornado se estiver comparando custos de solicitações.
Use cURL para uma verificação HTTP direta
Para uma verificação rápida do endpoint sem o SDK, execute este comando no Bash com COMETAPI_KEY definido. Inspecione o JSON retornado, incluindo status, saída e uso. Não presuma que o primeiro item de saída sempre contém o texto final.
curl -sS https://api.cometapi.com/v1/responses \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6.1-terra","input":"Explain how AI can reduce invoice-processing errors in 100 words.","reasoning":{"effort":"medium"},"max_output_tokens":600}'
Escolha as configurações da solicitação
Use os campos de solicitação de Responses abaixo como referência compacta. Comece com model, input e um orçamento de saída modesto; adicione formato ou configurações de ferramentas apenas quando o fluxo de trabalho precisar.
Parâmetro
Uso neste tutorial
model
Selecione gpt-6.1-terra.
input
Passe um prompt, mensagens, imagens ou itens de conversa.
instructions
Defina o comportamento e os requisitos de saída.
reasoning.effort
Escolha none, low, medium (padrão), high, xhigh ou max.
max_output_tokens
Limite o orçamento combinado de raciocínio e saída visível.
stream
Receba eventos de forma incremental.
text.format
Solicite um formato de saída estruturado.
tools
Declare funções chamáveis.
Escolha low effort para uma tarefa simples de extração, ou comece com medium para análise de documentos. Aumente o esforço quando seus próprios exemplos mostrarem melhoria útil. Sob as regras de compatibilidade de parâmetros do GPT-6, omita temperature, top_p e top_logprobs quando o effort não for none.
Tokens de raciocínio contam para o orçamento de saída. Se a resposta estiver incompleta, inspecione seu status e incomplete_details antes de analisá-la ou exibi-la. A orientação sobre tokens de raciocínio explica por que um valor pequeno de max_output_tokens pode ser consumido antes que uma resposta visível completa seja retornada.
Controlando o esforço de raciocínio
Escolha o esforço deliberadamente para equilibrar qualidade, latência e custo:
none: Mais rápido, para extração/classificação simples.
low: Tarefas rotineiras.
medium (padrão): A maioria dos trabalhos mistos ou de múltiplas etapas.
high / xhigh / max: Discrepâncias visuais complexas, planejamento ou tarefas de alto risco — use apenas quando avaliações justificarem os tokens/latência extras.
Chat Completions funciona para texto/imagem puros sem ferramentas, mas chamadas de ferramenta e alguns recursos avançados exigem Responses.
Como a API do GPT-6.1 Terra pode analisar imagens?
O modelo aceita imagens juntamente com texto. Isso dá suporte a interpretação de capturas de tela, extração de documentos, revisão de desenhos técnicos e comparação de materiais visuais. A documentação de entrada de visão da OpenAI especifica o bloco de conteúdo input_image.
Analise uma imagem local de fatura com Python
Coloque invoice.png no diretório de trabalho.
Codifique um PNG local e envie com um prompt de extração de fatura. Terra se destaca em correspondência de fotos de produto, desenhos técnicos, capturas de tela e QA visual.
response = client.responses.create(
model="gpt-6.1-terra",
reasoning={"effort": "medium"},
input=[{
"role": "user",
"content": [
{"type": "input_text", "text": "Review this campaign image. List only visible issues with cropping, text placement, contrast, and logo safety. Cite regions and propose fixes."},
{"type": "input_image", "image_url": "https://example.com/image.jpg", "detail": "high"}
]
}]
)
print(response.output_text)
Formatos compatíveis incluem PNG, JPEG, WEBP e GIF não animado. Use detail: "high" ou "low" conforme apropriado; maior detalhe consome mais tokens. URLs de dados base64 também são compatíveis.
Chamada de ferramentas, uso de computador e saídas estruturadas
A chamada de ferramentas (chamada de funções, uso de computador, pesquisa na web, pesquisa de arquivos, interpretador de código, MCP etc.) requer a Responses API.
Boas práticas para uso de computador:
Execute em um ambiente isolado (navegador/VM).
Aplique listas de permissão estritas para sites/ações.
Exija aprovação humana para ações de alto impacto (compras, exclusões, exportação de dados).
Defina limites de etapas/tempo/custo.
Verifique o estado final em vez de confiar apenas no resumo do modelo.
Trate o conteúdo da página como não confiável (alega-se forte resistência a prompt injection, mas defesa em profundidade é essencial).
Você deve usar Responses ou Chat Completions?
Para o GPT-6.1 Terra, Chat Completions suporta solicitações de texto e imagem sem ferramentas. Chamada de ferramentas requer Responses, que também é recomendada para fluxos de trabalho de agente de múltiplas etapas, gerenciamento de estado de conversa, preservação do contexto de raciocínio entre chamadas de ferramentas e eventos avançados de streaming. Use Responses para os exemplos abaixo e para fluxos que dependem de suas saídas estruturadas ou recursos de gerenciamento de estado. Um gateway compatível também deve suportar o endpoint e os campos que você envia. Consulte a orientação oficial de migração.
Ao migrar uma integração existente, verifique três coisas antes de mudar o tráfego: o ID do modelo, o endpoint e seus parâmetros de solicitação. Uma solicitação de Chat Completions com ferramentas precisa de uma implementação de Responses; mudar apenas o nome do modelo não basta. Em Responses, use reasoning.effort; em Chat Completions, use reasoning_effort.
Tabela de comparação: GPT-6.1 Terra vs. modelos relacionados
Aspecto
GPT-6.1 Terra
GPT-6.1 Sol
GPT-5.6 Terra
GPT-6 Astra (aprox.)
Posicionamento
Intermediário, alto volume visual/uso de PC
Maior capacidade
Intermediário anterior
Frontier
Preço padrão (entrada/saída)
$1 / $5
~$2 / $10
~$2 / $12
Muito mais alto
Contexto
1,05M
Similar
Similar
Similar
Velocidade em tarefas de agente
O mais rápido do grupo
Mais lento
Mais lento
Mais lento
Agents’ Last Exam
Forte (+15 pts vs 5.6 em medium)
Mais forte em código difícil
Básico
Comparável ou ligeiramente melhor
Melhor uso
Agentes em alto volume, QA visual, formulários
Codificação/raciocínio complexos
Legado
Maior capacidade
Tratamento de erros em um fluxo de trabalho da API GPT-6.1 Terra
Primeiro, separe uma solicitação que precisa de correção de uma falha temporária de conexão ou serviço. Comece a partir da menor solicitação funcional ao diagnosticar parâmetros opcionais e mantenha detalhes de erro em logs no lado do servidor sem incluir a chave de API.
Falha de autenticação ou acesso: verifique a chave, o host de destino, o acesso da conta e o saldo disponível antes de tentar novamente.
Parâmetro não compatível: remova campos opcionais, confirme o endpoint e o modelo e adicione um campo por vez.
Geração incompleta: inspecione status e incomplete_details; ajuste o orçamento de saída ou simplifique a tarefa antes de consumir o resultado.
Limite de taxa ou falha transitória: use backoff limitado e um limite de tentativas. Repetir pode gerar outra resposta faturável.
Stream interrompido: preserve o texto parcial como saída interrompida. Não o trate como resposta completa nem execute uma ação com base em uma solicitação de ferramenta parcial.
Falha de ferramenta ou a jusante: verifique a resposta salva e os registros da operação antes de repetir uma operação de negócio.
Conclusão
GPT-6.1 Terra representa um salto prático para desenvolvedores que constroem agentes visuais e de uso de computador em alto volume. Sua combinação de capacidade aprimorada, eficiência de custo dramaticamente melhor e raciocínio configurável o torna a escolha padrão para muitos workloads de produção que antes exigiam modelos mais caros.
Comece com a Responses API, inicie com esforço de raciocínio medium, imponha saídas estruturadas e proteções de segurança, e direcione o tráfego por uma plataforma unificada como a CometAPI para custo e flexibilidade ideais. Com a configuração e os padrões descritos acima, você pode passar do zero para uma integração pronta para produção em minutos mantendo os custos de longo prazo sob controle.
Para preços, limites de taxa e disponibilidade de recursos mais recentes, sempre confira a documentação oficial da OpenAI e seu painel da CometAPI. Boas construções!
FAQs
Vários usuários podem compartilhar uma conversa da API GPT-6.1 Terra?
Mantenha o histórico de conversas isolado por usuário ou workspace autorizado. Um backend compartilhado pode manter a credencial da API, mas isso não dá a cada usuário permissão para ler todas as conversas. Antes de carregar mensagens anteriores ou resultados armazenados, verifique se o usuário atual pode acessar essa conversa. Para fluxos colaborativos, defina quem pode ver e estender o histórico compartilhado.
O mesmo prompt da API GPT-6.1 Terra retornará texto idêntico?
Não confie em saída idêntica em bytes de gerações repetidas. Preserve o prompt, o ID do modelo, as configurações e o resultado aceito quando a reprodutibilidade for importante. Se um fluxo precisar exatamente da mesma redação aprovada depois, recupere a resposta salva em vez de gerar novamente. Avalie uma nova resposta conforme os requisitos da tarefa, em vez de tratar apenas diferenças de redação como falha.
store=False define a política de privacidade para todo o fluxo da API?
Não. Uma configuração de armazenamento por solicitação não descreve cada log, cache ou política de retenção da sua aplicação e do gateway de API. Revise os termos e os controles de dados aplicáveis a cada serviço antes de enviar documentos confidenciais. Limite os dados que você envia e evite registrar conteúdo sensível de prompt nos logs da aplicação apenas para facilitar a depuração.
Como obtenho uma chave da API GPT-6.1 Terra?
Você pode acessar a API GPT-6.1 Terra pela CometAPI. Crie uma conta, gere uma chave de API e configure seu SDK com a URL base https://api.cometapi.com/v1 e o ID do modelo gpt-6.1-terra. Não é necessária uma chave separada da OpenAI.
Quanto custa a API GPT-6.1 Terra?
Em 28 de outubro de 2026, a precificação oficial da OpenAI é $1.00 por milhão de tokens de entrada, $0.05 por milhão de tokens de entrada em cache e $5.00 por milhão de tokens de saída. As tarifas publicadas da CometAPI são $0.80 para entrada e $4.00 para saída, aproximadamente 20% menores. Para 10.000 tokens de entrada não em cache e 2.000 tokens de saída, o custo estimado é $0.016 pela CometAPI versus $0.020 pela OpenAI, excluindo cobranças adicionais.
A API GPT-6.1 Terra é gratuita?
Não. De acordo com a documentação do modelo da OpenAI, GPT-6.1 Terra não está disponível no Free tier da API e é acessível a partir do nível pago Build. Usuários do ChatGPT Plus, Pro, Enterprise e Edu podem acessar Terra pelo ChatGPT Work e Codex, mas o uso da API é cobrado separadamente das assinaturas do ChatGPT. Alternativamente, desenvolvedores podem acessar GPT-6.1 Terra via CometAPI com uma chave de API válida e créditos suficientes, sujeito à disponibilidade do provedor.
