Riferimento API

Responses

Modelli su questo endpoint (5)

gpt-5.6-luna gpt-6-astra gpt-6-luna gpt-6-sol gpt-6.1-sol+1

POST/v1/responses

Il formato della Responses API di OpenAI — un unico campo input, elementi di output strutturati e riepiloghi del ragionamento per i modelli che li espongono.

#Parametri della richiesta

modelstringobbligatorio
ID del modello da /v1/models. Il gateway determina il fornitore upstream da questo valore.
inputstring | arrayobbligatorio
Il prompt: una semplice stringa o un array di elementi di input.
instructionsstringfacoltativo
Istruzioni a livello di sistema, equivalenti a un messaggio system.
streambooleanfacoltativo
Trasmette in streaming eventi SSE response.* invece di un unico corpo JSON.
max_output_tokensintegerfacoltativo
Limite massimo di token generati; limita anche la stima della quota pre-riservata.
toolsarrayfacoltativo
Dichiarazioni delle funzioni che il modello può chiamare — vedi la guida alla chiamata di strumenti.
previous_response_idstringfacoltativo
Collega un turno successivo a una risposta precedente senza reinviare la cronologia.

#Compattare una conversazione lunga

POST/v1/responses/compact

La compattazione condensa una conversazione diventata troppo lunga per continuare a reinviarla e restituisce la versione abbreviata da portare avanti. È la chiamata che gli agenti di coding fanno quando una sessione si avvicina al limite di contesto.

modelstringobbligatorio
Un modello che supporta la compattazione. Gli altri rifiutano questo percorso con unsupported_endpoint.
inputarray | stringfacoltativo
La conversazione da compattare, nel formato di input Responses.
instructionsstring | arrayfacoltativo
Cosa preservare durante la compattazione — per esempio "mantieni ogni percorso di file e ogni decisione".
previous_response_idstringfacoltativo
Continua da una risposta salvata invece di reinviare tutta la cronologia.

compacted.json

{
  "id": "resp_…",
  "object": "response",
  "created_at": 1789000000,
  "output": [ /* the compacted conversation */ ],
  "usage": {"input_tokens": 8120, "output_tokens": 240, "total_tokens": 8360}
}

Mai in streaming, sempre fatturato a token

La compattazione non ha una versione in streaming — stream:true non fa parte di questa richiesta. Ha lo stesso prezzo di qualsiasi altra chiamata Responses sui token che legge e scrive, quindi compatta in modo mirato e non a ogni turno.

#Errori correlati

400 invalid_request_errorCorpo malformato o parametro non supportato per questo modello.
401Bearer token non valido o mancante. Su questo percorso non c'è error.code — basati sullo stato.
402 insufficient_user_quotaIl saldo del portafoglio non copre la stima pre-riservata.
429Limitazione per chiave. Corpo vuoto; attendi Retry-After. Un 429 che contiene insufficient_user_quota indica invece un limite di spesa giornaliero.
503 model_not_foundModello sconosciuto, oppure nessun canale funzionante lo serve al momento.

Tabella completa dei codici di errore →

#Esempio di richiesta

curl https://www.aisplice.store/v1/responses \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "input": "Say hello."
  }'

#Risposta

response.json

{
  "id": "resp_…",
  "object": "response",
  "model": "gpt-5.6-luna",
  "output": [{
    "type": "message",
    "role": "assistant",
    "content": [{"type": "output_text", "text": "Hello!"}]
  }],
  "usage": {"input_tokens": 9, "output_tokens": 3, "total_tokens": 12}
}

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.

PrecedenteChat Completions SuccessivoMessages (formato Anthropic)