Source: https://ailoot.ai/docs/it/api/responses/ Canonical: https://ailoot.ai/docs/it/api/responses/ Language: it [API](https://ailoot.ai/docs/it/) # Responses [Markdown](https://ailoot.ai/docs/it/api/responses/index.md) Il nuovo formato OpenAI: un input, output tipizzato, strumenti e ragionamento. È usato da Codex CLI. POST`https://api.ailoot.ai/v1/responses` Responses ```bash curl https://api.ailoot.ai/v1/responses \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6.1-sol", "instructions": "Rispondi brevemente.", "input": "Qual è la differenza tra TCP e UDP?" }' ``` ```python from openai import OpenAI import os client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"]) resp = client.responses.create( model="gpt-6.1-sol", instructions="Rispondi brevemente.", input="Qual è la differenza tra TCP e UDP?", ) print(resp.output_text) ``` ```js import OpenAI from "openai"; const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY }); const resp = await client.responses.create({ model: "gpt-6.1-sol", instructions: "Rispondi brevemente.", input: "Qual è la differenza tra TCP e UDP?", }); console.log(resp.output_text); ``` 200 OK ```json { "id": "resp_67f1…", "object": "response", "status": "completed", "model": "gpt-6.1-sol", "output": [ { "type": "message", "role": "assistant", "content": [ { "type": "output_text", "text": "TCP garantisce la consegna e l’ordine, UDP no, ma è più veloce…" } ] } ], "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 } } ``` ## Autorizzazione | Parametro | Tipo | Obbligatorio | Descrizione | | --- | --- | --- | --- | | `Authorization` | header | obbligatorio | Chiave nel formato `Bearer sk-…`. Sono accettati anche gli header `x-api-key` oppure `x-goog-api-key`. | ## Corpo della richiesta | Parametro | Tipo | Obbligatorio | Descrizione | | --- | --- | --- | --- | | `model` | string | obbligatorio | ID del modello con formato Responses. Nel catalogo ce ne sono 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax e Grok. I modelli Gemini non sono disponibili in questo formato. | | `input` | string \| array | obbligatorio | Testo della richiesta oppure array di messaggi e parti (testo, immagini). | | `instructions` | string | facoltativo | Istruzione di sistema. | | `stream` | boolean | facoltativo | Flusso di eventi SSE; l’ultimo evento è `response.completed`. Il testo a pagamento arriva in un unico blocco dopo il calcolo del costo. | | `max_output_tokens` | integer | facoltativo | Numero massimo di token della risposta, ragionamento incluso. Se non specificato, Ailoot imposta 4096 (o meno, se il limite di risposta del modello è inferiore). Per risposte lunghe imposta il limite esplicitamente. Le richieste con `previous_response_id` e con strumenti integrati `web_search` oppure `code_interpreter` per le nuove richieste testuali usano stime separate del contesto salvato e del lavoro degli strumenti; non passano automaticamente al costo dell’intera finestra di input. Le riserve accettate in precedenza mantengono le condizioni originarie. Per immagini, video e audio in output viene riservato l’intero costo del risultato. Se la riserva calcolata non rientra nel saldo disponibile o nel limite della chiave, per un modello e un metodo supportati Ailoot può ridurre `max_tokens` (`max_output_tokens` in Responses) al volume pagabile, ma non sotto 256 token o il minimo superiore previsto dal metodo, e lo comunica nell’header `X-Ailoot-Max-Tokens-Capped`. La possibilità di riduzione viene verificata per il modello testuale specifico e il metodo. Si applica alle rotte testuali Gemini supportate, nel formato nativo Gemini e nel formato Anthropic Messages; `deepseek-ai/deepseek-v4.1-flash`, `meta/llama-3.2-11b-vision-instruct`, `meta/muse-glimmer-30b`, `nvidia/ising-calibration-1.5-31b`, `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning`, `nvidia/nemotron-3-super-120b-a12b`, `nvidia/nemotron-3-ultra-550b-a55b`, `nvidia/nemotron-3.5-content-safety`, `nvidia/nemotron-3.5-lightning-30b-a3b`, `nvidia/riva-translate-4b-instruct-v1.1`, `nvidia/riva-translate-4b-instruct-v2`, `poolside/laguna-xs-2.1`, `z-ai/glm-5.3-flash` — nei formati Chat Completions e Messages (quando supportati dal modello). **Output** — ai fini della riserva per una nuova richiesta testuale, viene stimato in base alla lunghezza tipica della risposta e alle condizioni accettate. Il limite richiesto si imposta tramite `max_tokens` (`max_output_tokens` in Responses). Il limite richiesto non coincide automaticamente con il numero di token usato per calcolare la riserva e non garantisce la lunghezza effettiva della risposta di un modello senza un vincolo affidabile. Il valore iniziale 4096 si applica solo alle relative rotte; la regola specifica dipende dal modello e dal metodo. | | `reasoning` | object | facoltativo | `{"effort": "low" \| "medium" \| "high"}` per i modelli di ragionamento. | | `tools` | array | facoltativo | Funzioni che il modello può chiamare. | | `text` | object | facoltativo | Formato della risposta, ad esempio `{"format": {"type": "json_schema", ...}}`. | | `temperature` | number | facoltativo | Casualità della risposta, se il modello la supporta. | ## Risposta | Parametro | Tipo | Obbligatorio | Descrizione | | --- | --- | --- | --- | | `output` | array | | Elementi della risposta: messaggi (`message`), ragionamento, chiamate a funzioni. Nell’SDK è comodo usare `output_text`. | | `status` | string | | `completed`, `incomplete` (limite raggiunto) oppure `failed`. | | `usage` | object | | `input_tokens`, `output_tokens`, `total_tokens`. | Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.[Contatta l’assistenza](mailto:support@ailoot.ai) ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.