Crea con CometAPITi serve una sola API per più modelli?Testa il flusso di lavoro in Playground, poi crea una chiave API quando modello e costo sono adatti al tuo caso d'uso.
come accedere a GPT-6.1 Terra in modo più conveniente dal punto di vista dei costi tramite CometAPI e trattare configurazione, esempi di codice, strategie di ragionamento, buone pratiche e confronti
GPT-6.1 Terra (gpt-6.1-terra) è il modello GPT-6.1 di fascia media di OpenAI rilasciato il 26 ottobre 2026. Offre solido ragionamento visivo, uso del computer preciso e scrittura naturale a metà del prezzo di GPT-6.1 Sol e GPT-5.6 Terra ($1 input / $5 output per milione di token standard). Con una finestra di contesto da 1,05M token, impegno di ragionamento configurabile (da none a max), input immagine e pieno supporto degli strumenti tramite la Responses API, è ideale per workflow agentici ad alto volume come elaborazione fatture, interpretazione di disegni tecnici, interazione con schermi e revisione documenti. Questa guida copre configurazione esatta, esempi di codice, strategie di ragionamento, best practice, confronti e come accedervi in modo più conveniente tramite CometAPI.
Punti chiave
Model ID: gpt-6.1-terra — finestra di contesto 1.050.000, 128.000 token massimi di output, knowledge cutoff 1 giugno 2026.
Prezzi (standard OpenAI): $1 / $5 per 1M token input/output; input in cache $0,05; contesti lunghi (>272K input) e modalità Fast costano di più.
Revisionato per chiarezza, attribuzione delle fonti e terminologia API aggiornata.
Ideale per attività visive + uso del computer; supera nettamente GPT-5.6 Terra eguagliando o avvicinandosi ai modelli di fascia superiore a costo molto inferiore e maggiore velocità.
Preferire la Responses API per chiamata strumenti, uso del computer, output strutturati e controllo del ragionamento.
CometAPI offre lo stesso modello a tariffe scontate (circa $0,80 / $4,00) con un’unica chiave compatibile con OpenAI per oltre 500 modelli, consentendo cambio semplice e risparmi continuativi del 20–40%.
Che cos’è GPT-6.1 Terra?
GPT-6.1 Terra è il modello veloce ed efficiente di fascia media della famiglia GPT-6.1, posizionato tra il leggero Luna e i più capaci Sol/Astra. Il posizionamento ufficiale enfatizza il ragionamento visivo dettagliato, l’uso preciso del computer (interazione con schermi, compilazione di moduli, controllo applicazioni) e una scrittura naturale più chiara.
Accetta input di testo e immagini e produce output testuale. Non supporta nativamente input/output audio o video. Le funzionalità chiave includono streaming, output strutturati, function calling, cache dei prompt, ricerca web, ricerca file, uso del computer, code interpreter e altro—principalmente tramite la Responses API.
OpenAI evidenzia grandi miglioramenti rispetto a GPT-5.6 Terra: punteggi più alti su Agents’ Last Exam (attività professionali di uso del computer) a circa un terzo del costo, quasi parità con GPT-6 Astra su alcuni benchmark visivi e agent a ~1/10 del prezzo per token, tassi di allucinazione sostanzialmente inferiori e oltre 3× più veloce nel completamento dei task rispetto a Sol o Astra nei carichi di lavoro pertinenti.
Specifiche e prezzi di GPT-6.1 Terra
Specifiche
Dettagli
ID modello
gpt-6.1-terra
Finestra di contesto
1.050.000 token
Token di input massimi
~922.000
Token di output massimi
128.000
Limite di conoscenza
1 giugno 2026
Modalità di input
Testo, Immagine
Modalità di output
Testo
Livelli di impegno nel ragionamento
none, low, medium (default), high, xhigh, max
Endpoint supportati
Chat Completions, Responses, Batch
Chiamata degli strumenti
Richiede Responses API
Fine-tuning
Non supportato
Prezzi standard OpenAI (per 1M token)
Input: $1,00
Input in cache: $0,05
Scritture in cache (ritenzione 30 min): $1,25
Output: $5,00
Note: Prompt oltre 272K token di input comportano tariffe 2× per input/cache e 1,5× per output per l’intera richiesta. Batch/Flex costano il 50% in meno; la modalità Fast costa 2×. L’elaborazione regionale può aggiungere maggiorazioni.
CometAPI attualmente elenca GPT-6.1 Terra a circa $0,80 input / $4,00 output (confermare in dashboard), offrendo risparmi significativi e un endpoint unificato compatibile con OpenAI.
Come configurare l’API di GPT-6.1 Terra
Diretto con OpenAI
Crea o usa un progetto OpenAI con accesso API (tier Build e superiori; il tier Free non è supportato per questo modello).
Genera una API key e conservala in modo sicuro (variabile d’ambiente o secret manager).
Installa l’SDK OpenAI più recente: pip install --upgrade openai (Python) o npm install openai (Node.js).
Tramite CometAPI (consigliato per la maggior parte dei casi di produzione e uso multi-modello)
Come accedere all’API GPT-6.1 Terra in CometAPI?
Account e credenziali
Accedi a CometAPI, genera una API key e conferma che gpt-6.1-terra sia disponibile. Conserva la credenziale come variabile d’ambiente, non nel codice sorgente dell’applicazione.
Una chiave CometAPI autentica le richieste verso CometAPI. Mantienila nel tuo ambiente di sviluppo o backend; non inserirla in una pagina web pubblica né effettuare commit nel controllo versione. La variabile d’ambiente deve essere disponibile nel terminale che esegue lo script.
Set the key in Bash.
export COMETAPI_KEY="your_cometapi_api_key"
In Windows, imposta la stessa variabile in PowerShell.
$env:COMETAPI_KEY="your_cometapi_api_key"
Una prima richiesta piccola e specifica
Usa un breve prompt testuale e una risposta prima di aggiungere dati immagine, uno schema JSON o funzioni. Conferma l’accesso al modello e la base URL https://api.cometapi.com/v1. Se il tuo account offre più route, scegli quella la cui documentazione copre le funzionalità che intendi usare.
Come usare una risposta dell’API GPT-6.1 Terra?
Invia la prima richiesta di testo
Aggiungi il seguente codice dopo il setup del client e salva lo script combinato come first_request.py. Chiede una risposta breve, verifica il completamento e scrive il testo in un file UTF-8.
Genera una risposta testuale, verifica il completamento e salva 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
Controlla la risposta salvata
Apri answer.txt e conferma che la risposta tratti il prompt e contenga tutte e tre le cause e relative soluzioni richieste. Una risposta API “completed” stabilisce che la generazione è terminata; la tua applicazione deve comunque verificare che il contenuto soddisfi i requisiti. Conserva il record di usage restituito se stai confrontando i costi della richiesta.
Usa cURL per un controllo HTTP diretto
Per un controllo rapido dell’endpoint senza SDK, esegui questo comando in Bash con COMETAPI_KEY impostata. Ispeziona il JSON restituito, inclusi status, output e usage. Non presumere che il primo elemento di output contenga sempre il testo finale.
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}'
Scegli le impostazioni della richiesta
Usa i campi di richiesta di Responses qui sotto come riferimento compatto. Inizia con model, input e un budget di output moderato; aggiungi impostazioni di formato o strumenti solo quando servono al workflow.
Parametro
Uso in questo tutorial
model
Seleziona gpt-6.1-terra.
input
Passa un prompt, messaggi, immagini o elementi di conversazione.
instructions
Imposta comportamento e requisiti di output.
reasoning.effort
Scegli none, low, medium (default), high, xhigh o max.
max_output_tokens
Limita il budget combinato di ragionamento e output visibile.
stream
Ricevi eventi in modo incrementale.
text.format
Richiedi un formato di output strutturato.
tools
Dichiara funzioni invocabili.
Scegli low per un semplice task di estrazione o inizia con medium per analisi documentali. Aumenta l’effort quando i tuoi test mostrano un miglioramento utile. In base alle regole di compatibilità dei parametri GPT-6, ometti temperature, top_p e top_logprobs quando l’effort non è none.
I token di ragionamento concorrono al budget di output. Se la risposta è incompleta, ispeziona status e incomplete_details prima di analizzarla o mostrarla. La guida ai token di ragionamento spiega perché un valore piccolo di max_output_tokens può essere consumato prima di restituire una risposta visibile completa.
Controllare l’impegno di ragionamento
Scegli consapevolmente l’effort per bilanciare qualità, latenza e costo:
none: Il più veloce, per estrazione/classificazione semplici.
low: Attività di routine.
medium (default): La maggior parte dei lavori misti o multi-step.
high / xhigh / max: Discrepanze visive complesse, pianificazione o task critici—usare solo quando le valutazioni giustificano token/latency extra.
Chat Completions funziona per testo/immagini pure senza strumenti, ma la chiamata strumenti e alcune funzionalità avanzate richiedono Responses.
Come può l’API GPT-6.1 Terra analizzare le immagini?
Il modello accetta immagini insieme al testo. Supporta interpretazione di screenshot, estrazione da documenti, revisione di disegni tecnici e confronto di materiali visivi. La documentazione sull’input visivo di OpenAI specifica il blocco di contenuto input_image.
Analizzare un’immagine di fattura locale con Python
Posiziona invoice.png nella directory di lavoro.
Codifica un PNG locale e invialo con un prompt di estrazione fattura. Terra eccelle in matching di foto prodotto, disegni tecnici, screenshot e QA visivo.
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)
I formati supportati includono PNG, JPEG, WEBP, GIF non animata. Usa detail: "high" o "low" in modo adeguato; maggiore dettaglio costa più token. Sono supportati anche data URL Base64.
Tool calling, uso del computer e output strutturati
La chiamata strumenti (function calling, uso del computer, ricerca web, ricerca file, code interpreter, MCP, ecc.) richiede la Responses API.
Best practice per l’uso del computer:
Esegui in un ambiente isolato (browser/VM).
Applica allowlist rigorose per siti/azioni.
Richiedi approvazione umana per azioni ad alto impatto (acquisti, eliminazioni, esportazioni di dati).
Imposta limiti di step/tempo/costo.
Verifica lo stato finale invece di fidarti solo del riepilogo del modello.
Considera i contenuti delle pagine non attendibili (si rivendica una forte resistenza al prompt-injection, ma il defense-in-depth è essenziale).
Meglio usare Responses o Chat Completions?
Per GPT-6.1 Terra, Chat Completions supporta richieste di testo e immagine ordinarie senza strumenti. La chiamata strumenti richiede Responses, consigliata anche per workflow agentici multi-step, gestione dello stato di conversazione, conservazione del contesto di ragionamento tra chiamate a strumenti ed eventi di streaming avanzati. Usa Responses per gli esempi sottostanti e per i workflow che si basano su output strutturati o gestione dello stato. Un gateway compatibile deve supportare l’endpoint e i campi inviati. Vedi la guida ufficiale alla migrazione.
Nel migrare un’integrazione esistente, verifica tre cose prima di spostare il traffico: l’ID modello, l’endpoint e i parametri di richiesta. Una richiesta Chat Completions con strumenti necessita di un’implementazione Responses; cambiare solo il nome del modello non basta. In Responses usa reasoning.effort; in Chat Completions usa reasoning_effort.
Tabella di confronto: GPT-6.1 Terra vs modelli correlati
Aspetto
GPT-6.1 Terra
GPT-6.1 Sol
GPT-5.6 Terra
GPT-6 Astra (approx.)
Posizionamento
Fascia media, uso visivo/computer ad alto volume
Capacità superiore
Fascia media precedente
Frontier
Prezzo standard (in/out)
$1 / $5
~$2 / $10
~$2 / $12
Molto più alto
Contesto
1,05M
Simile
Simile
Simile
Velocità nei compiti agentici
La più veloce del gruppo
Più lenta
Più lenta
Più lenta
Agents’ Last Exam
Forte (+15 punti vs 5.6 a medium)
Più forte su coding difficile
Baseline
Paragonabile o leggermente migliore
Uso consigliato
Agenti ad alto volume, QA visivo, moduli
Coding/ragionamento complesso
Legacy
Massima capacità
Gestire gli errori in un flusso di lavoro dell’API GPT-6.1 Terra
Distingui prima le richieste che richiedono correzione da un errore temporaneo di connessione o servizio. Parti dalla richiesta funzionante più piccola quando diagnostichi parametri opzionali e conserva i dettagli degli errori nei log lato server senza includere la API key.
Autenticazione o accesso fallito: verifica chiave, host di destinazione, accesso account e saldo disponibile prima di ritentare.
Parametro non supportato: rimuovi i campi opzionali, conferma endpoint e modello, quindi aggiungi un campo alla volta.
Generazione incompleta: ispeziona status e incomplete_details; aumenta il budget di output o semplifica il task prima di consumare il risultato.
Rate limit o errore transitorio: usa backoff limitato e un limite di retry. Il retry può generare un’altra risposta a pagamento.
Stream interrotto: conserva il testo parziale come output interrotto. Non trattarlo come risposta completa né eseguire un’azione basata su una richiesta strumento parziale.
Errore dello strumento o a valle: controlla la risposta salvata e i record dell’operazione prima di ripetere una business
Conclusione
GPT-6.1 Terra rappresenta un salto pratico per gli sviluppatori che costruiscono agenti visivi e di uso del computer ad alto volume. La combinazione di capacità migliorata, efficienza di costo notevolmente migliore e ragionamento configurabile lo rende la scelta predefinita per molti carichi di produzione che prima richiedevano modelli più costosi.
Inizia con la Responses API, parti da un impegno di ragionamento medium, applica output strutturati e guardrail di sicurezza e instrada il traffico tramite una piattaforma unificata come CometAPI per costi e flessibilità ottimali. Con la configurazione e i pattern descritti, puoi passare da zero a un’integrazione pronta per la produzione in pochi minuti mantenendo sotto controllo i costi a lungo termine.
Per prezzi, limiti di velocità e disponibilità delle funzionalità più aggiornati, verifica sempre la documentazione ufficiale di OpenAI e la tua dashboard CometAPI. Buon lavoro!
FAQ
Più utenti possono condividere una conversazione dell’API GPT-6.1 Terra?
Mantieni la cronologia conversazioni isolata per utente o workspace autorizzato. Un backend condiviso può conservare la credenziale API, ma ciò non concede a ogni utente il permesso di leggere ogni conversazione. Prima di caricare messaggi precedenti o risultati memorizzati, verifica che l’utente corrente possa accedere a quella conversazione. Per workflow collaborativi, definisci chi può visualizzare ed estendere la cronologia condivisa.
Lo stesso prompt dell’API GPT-6.1 Terra restituirà testo identico?
Non fare affidamento su output identici al byte da generazioni ripetute. Conserva prompt, ID modello, impostazioni e risultato accettato quando è importante la riproducibilità. Se un workflow necessita esattamente della stessa formulazione approvata in seguito, recupera la risposta salvata invece di generarla di nuovo. Valuta una nuova risposta rispetto ai requisiti del task invece di considerare le sole differenze di formulazione come un errore.
Il parametro store=False definisce la politica sulla privacy per l’intero workflow API?
No. Un’impostazione di storage a livello di richiesta non descrive ogni log, cache o policy di retention in tutta la tua applicazione e nel gateway API. Esamina termini e controlli dati applicabili a ciascun servizio prima di inviare documenti riservati. Limita i dati che invii ed evita di registrare contenuti sensibili del prompt nei log applicativi solo per semplificare il debugging.
Come ottengo una chiave dell’API GPT-6.1 Terra?
Puoi accedere alla GPT-6.1 Terra API tramite CometAPI. Crea un account, genera una API key e configura il tuo SDK con la base URL https://api.cometapi.com/v1 e il model ID gpt-6.1-terra. Non è richiesta una API key OpenAI separata.
Quanto costa l’API GPT-6.1 Terra?
Al 28 ottobre 2026, i prezzi ufficiali di OpenAI sono $1,00 per milione di token in input, $0,05 per milione di token di input in cache e $5,00 per milione di token in output. Le tariffe pubblicate da CometAPI sono $0,80 per input e $4,00 per output, circa il 20% in meno. Per 10.000 token di input non in cache e 2.000 token di output, il costo stimato è $0,016 tramite CometAPI contro $0,020 tramite OpenAI, escludendo addebiti aggiuntivi.
L’API GPT-6.1 Terra è gratuita?
No. Secondo la documentazione del modello di OpenAI, GPT-6.1 Terra non è disponibile sul tier Free dell’API ed è accessibile dal tier a pagamento Build in su. Gli utenti ChatGPT Plus, Pro, Enterprise ed Edu possono accedere a Terra tramite ChatGPT Work e Codex, ma l’uso dell’API è fatturato separatamente dagli abbonamenti ChatGPT. In alternativa, gli sviluppatori possono accedere a GPT-6.1 Terra tramite CometAPI con una API key valida e crediti sufficienti, soggetti alla disponibilità del provider.
