Endpoint supportati nei batch
In questa pagina
Aggiornato il 2 novembre 2026, sulla base della documentazione di xAI: lo sconto batch è del 20% sui modelli di testo idonei (non del 50%), gli esempi seguono l’API REST e l’
xai-sdkufficiale (client.batch.*; l’API Batch di xAI non utilizza il formato di OpenAI, quindi l’SDK di OpenAI non si applica) e l’API Responses ha la priorità rispetto a Chat Completions, un endpoint legacy presso xAI. Fonti: Batch API · Riferimento REST · Prezzi Batch.
Sette endpoint, un unico flusso di lavoro
L’API Batch non si limita alla generazione di testo. Accetta sette endpoint che coprono testo, immagini e video; puoi combinarli in un singolo batch per costruire pipeline multimodali complete in una sola operazione.
Endpoint di testo
/v1/responses — L’API Responses, quella raccomandata da xAI. Ti offre accesso a strumenti lato server (ricerca web, ricerca su X, esecuzione di codice, MCP), chiamate di funzioni e output strutturati, ed è la prima a ricevere le nuove funzionalità.
/v1/chat/completions — L’endpoint di completamento originale, nel formato di OpenAI. xAI lo mantiene come endpoint legacy: è ancora utile per il codice esistente scritto per esso, ma una nuova pipeline farebbe meglio a partire con Responses.
Sui modelli idonei, lo sconto batch del 20% si applica a entrambi gli endpoint, per tutti i tipi di token.
Endpoint di immagini
/v1/images/generations — Genera immagini da un prompt. I parametri che utilizzerai sono aspect_ratio (ad esempio "16:9"), resolution ("1k", "1.5k" o "2k"), n per il numero di immagini e response_format ("url" o "b64_json").
/v1/images/edits — Modifica un’immagine esistente, specificata da un oggetto image contenente un url (un indirizzo pubblico o dati codificati in base64) o l’file_id di un file caricato. Utile per eseguire trasformazioni in serie su un catalogo visivo.
Le immagini sono fatturate alla tariffa standard, senza sconto batch: qui il valore del batching è operativo, non finanziario.
Endpoint video
/v1/videos/generations (o /v1/videos) — Genera video da un prompt, con durata da 1 a 15 secondi (duration, 8 di default), a 480p, 720p o 1080p.
/v1/videos/edits — Modifica un video esistente, passato in un oggetto video (l’URL di un file .mp4 o un file_id).
/v1/videos/extensions — Estende un video con un nuovo segmento da 2 a 10 secondi.
Come per le immagini, i prezzi dei video restano alla tariffa standard in modalità batch. I risultati di immagini e video tornano come URL firmati che scadono dopo un’ora.
Combinare endpoint in un batch
In un file JSONL, ogni riga nomina il proprio endpoint nel campo url:
{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Summarize this article: ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a neighborhood bookstore"}}
In questo modo puoi generare le descrizioni dei tuoi prodotti e le relative immagini visive nello stesso batch.
Scegliere l’endpoint giusto
- Responses: la scelta predefinita, essenziale non appena hai bisogno di strumenti lato server, output strutturati o delle funzionalità più recenti
- Chat Completions: continuità per il codice già scritto nel formato Chat Completions, e nient’altro
- Immagini e video: per produrre contenuti visivi in serie, tenendo presente che non beneficiano di alcuno sconto
Punti chiave
- Sono accettati sette endpoint: due per il testo, due per le immagini, tre per i video
- Responses è l’endpoint raccomandato; Chat Completions è un endpoint legacy presso xAI
- Solo i token sui modelli di testo idonei ottengono lo sconto del 20%
- Il campo
urldi ogni riga JSONL determina l’endpoint di destinazione e gli endpoint possono essere mescolati all’interno di un batch - I risultati di immagini e video sono URL firmati validi per un’ora