Introduzione
GPT 6.1 Terra legge schermate e documenti per ricavarne bozze mirate o campi strutturati. Con Terra, indica la zona della schermata e i campi da estrarre; chiedi di lasciare come sconosciuti i valori illeggibili.
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Testo |
| Finestra di contesto | 1,050,000 tokens |
| Limite di max_tokens | 128,000 |
Caratteristiche principali
Il GPT 6.1 più leggero per il lavoro quotidiano
GPT 6.1 Terra legge schermate e documenti per ricavarne bozze mirate o campi strutturati. Con Terra, indica la zona della schermata e i campi da estrarre; chiedi di lasciare come sconosciuti i valori illeggibili.
Un'impostazione none per i turni che non richiedono pianificazione
Terra accetta none, low, medium, high, xhigh e max; none è utile per un’estrazione diretta. Terra prevede 4,096 token di risposta e permette di arrivare a 128,000; con un livello superiore a none, anche il ragionamento usa questo budget.
Immagini più grandi, lette con più dettaglio
Terra accetta 256 messaggi e 128 definizioni di strumenti, con 37,000 token di input per immagine su questo endpoint. Con Terra, indica la zona della schermata e i campi da estrarre; chiedi di lasciare come sconosciuti i valori illeggibili.
La stessa finestra da 1,050,000 token, con una fascia per i prompt lunghi
Il contesto di 1,050,000 token di Terra comprende documenti, conversazione e risposta; riserva fino a 128,000 token all’output. Un insieme di documenti per Terra che supera 272,000 token di input rientra nella fascia lunga per tutta la richiesta, risposta inclusa; consulta prima il listino della pagina.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
messages | Sì | Invia a Terra la schermata e le istruzioni di estrazione in messages; conserva gli identificativi delle chiamate nei turni successivi. almeno 1 elementi · al massimo 256 elementi |
max_tokens | No | Imposta |
reasoning_effort | No | Terra accetta none, low, medium, high, xhigh e max; none è utile per un’estrazione diretta. |
stop | No | Terra accetta una sequenza di arresto o una lista di quattro al massimo; evita marcatori presenti nei valori estratti. almeno 1 caratteri · almeno 1 elementi · al massimo 4 elementi |
temperature | No | temperature di Terra si applica con |
top_p | No | Con Terra a |
tools | No | Descrivi le funzioni di ricerca o estrazione proponibili da Terra; l’esecuzione spetta alla tua applicazione. al massimo 128 elementi |
parallel_tool_calls | No | Consenti a Terra ricerche indipendenti insieme se nessun risultato serve per formulare un’altra chiamata. Predefinito: |
tool_choice | No | Scegli auto, none, required o una funzione specifica per il flusso documentale di Terra. |
response_format | No | Richiedi la struttura JSON dei campi estratti da Terra e verificala rispetto al tuo schema. |
Prezzi
Input $1 / Output $5 per 1 milione di token; Prompt oltre 272K token: Input $2 / Output $7.50
Casi d’uso
Leggere gli screenshot e trasformarli in modifiche
Con Terra, indica la zona della schermata e i campi da estrarre; chiedi di lasciare come sconosciuti i valori illeggibili.
Estrarre campi da documenti e moduli
Passa un modulo scansionato o un documento lungo e chiedi campi con nome in una struttura JSON fissa. Usa reasoning_effort none o low per estrazioni semplici e convalida l'output nella tua applicazione.
Scrivere e riscrivere con un tono coerente
Fornisci a Terra le linee guida di stile e alcuni esempi approvati, poi chiedi risposte, riepiloghi o testi di prodotto. È progettato per una scrittura chiara e naturale, e di solito basta un impegno basso.
Chiudi il ciclo delle chiamate di strumenti
Richiedi la struttura JSON dei campi estratti da Terra e verificala rispetto al tuo schema.
Consigli avanzati
Scegli l'impegno in base al compito
Terra accetta none, low, medium, high, xhigh e max; none è utile per un’estrazione diretta.
Indica al modello la parte dell'immagine
Aggiungi l'immagine come parte
image_urle nomina la zona, per esempio la terza colonna della tabella. Tieni l'istruzione in testo accanto all'immagine e non affidarti a caratteri minuscoli che l'immagine non può risolvere.Imposta
max_tokenssulla risposta previstamax_tokensvale 4,096 per impostazione predefinita e accetta fino a 128,000, con il ragionamento conteggiato al suo interno. Un'estrazione breve ne richiede poco, una bozza lunga con impegno più alto ne richiede di più. Trasmetti in streaming le risposte lunghe e controllafinish_reason.Chiudi il ciclo delle chiamate di strumenti
Se definisci degli strumenti, restituisci ogni risultato come messaggio tool con il
tool_call_idcorrispondente e mantieni nello storico itool_callsdell'assistente. Convalida gli argomenti prima di agire di conseguenza.
GPT 6.1 Terra
GPT 6.1 Terra legge schermate e documenti per ricavarne bozze mirate o campi strutturati.
openai/gpt-6.1-terra/chat
Con Terra, indica la zona della schermata e i campi da estrarre; chiedi di lasciare come sconosciuti i valori illeggibili.
Terra prevede 4,096 token di risposta e permette di arrivare a 128,000; con un livello superiore a none, anche il ragionamento usa questo budget.
Per estrarre dati con Terra, definisci funzioni eseguibili e restituisci i risultati con il tool_call_id originale; qui sono ammesse 128 definizioni. Gli strumenti nativi OpenAI passano da Responses.
Un insieme di documenti per Terra che supera 272,000 token di input rientra nella fascia lunga per tutta la richiesta, risposta inclusa; consulta prima il listino della pagina.
Le capacità visive e di scrittura di GPT 6.1 Terra non garantiscono risposte NSFW senza restrizioni; valgono le regole sui contenuti del modello.
Le capacità visive e di scrittura di GPT 6.1 Terra non garantiscono risposte NSFW senza restrizioni; valgono le regole sui contenuti del modello.
Avvio rapido dell’API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "openai/gpt-6.1-terra/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.