Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Endpoint supportati nei batch

Lezione 3 di 12 Aggiornata il 2 novembre 2026 Sviluppatore
In questa pagina
  1. Sette endpoint, un unico flusso di lavoro
  2. Endpoint di testo
  3. Endpoint di immagini
  4. Endpoint video
  5. Combinare endpoint in un batch
  6. Scegliere l’endpoint giusto
  7. Punti chiave

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-sdk ufficiale (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 url di 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