Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Rapporti d'aspetto, risoluzioni e gestione dei costi

Lezione 3 di 12 Aggiornata il 3 novembre 2026 Intermedio
In questa pagina
  1. Ottimizza le tue generazioni video
  2. Scegli il rapporto d’aspetto corretto
  3. Tre risoluzioni, a seconda del modello
  4. Quanto costa davvero la produzione
  5. Gestione dei limiti di frequenza (Rate Limits)
  6. Consegnare il video senza scaricarlo
  7. Punti chiave

Aggiornato il 3 novembre 2026 sulla base della documentazione video di xAI: l’API accetta nove rapporti d’aspetto (inclusi 21:9 e 5:2) e tre risoluzioni, con 1080p dipendente dal modello; i tre modelli video hanno ciascuno il proprio prezzo; e il parametro size, con le sue dimensioni in pixel, presentato dalla versione precedente, non appare nel riferimento API. Fonti: Video Generation · Videos API · Pricing.

Ottimizza le tue generazioni video

Saper scrivere un prompt non basta per passare alla produzione. Due fattori determinano il resto: l’inquadramento tecnico dei tuoi output e il controllo dei costi. Uno studio che genera duecento clip al mese senza una strategia di prototipazione paga diverse volte il prezzo necessario, e un team che scopre alla fine di un progetto che il suo formato non corrisponde al canale di distribuzione deve ricominciare da capo. Questa lezione copre entrambi i punti insieme, perché si influenzano a vicenda.

Scegli il rapporto d’aspetto corretto

Il parametro aspect_ratio imposta le proporzioni del video generato. Sono accettati nove valori e ciascuno corrisponde a una specifica destinazione di distribuzione.

RapportoProporzioniUso principale
16:9Paesaggio widescreenYouTube, presentazioni, siti web
9:16RitrattoTikTok, Stories, Reels
1:1QuadratoPost social, miniature
4:3Paesaggio classicoDocumenti, slide
3:4Ritratto classicoPinterest, poster
3:2Paesaggio fotograficoPortfolio, gallerie
2:3Ritratto fotograficoPoster, copertine
21:9Cinema widescreenRiprese cinematografiche
5:2BannerBanner web, intestazioni

In assenza di un parametro esplicito, l’API applica 16:9. Questo è un valore predefinito ragionevole per il web, ma diventa una trappola non appena utilizzi formati verticali: una campagna destinata ai Reels deve dichiarare 9:16 in ogni richiesta, altrimenti recupererai paesaggi che dovranno essere ritagliati, con la perdita di composizione che ne consegue. Due modalità sono esenti da questa impostazione: nell’image-to-video, l’output segue il rapporto dell’immagine sorgente, e nell’editing, quello del video sorgente.

Tre risoluzioni, a seconda del modello

Il parametro resolution accetta tre valori. Il valore predefinito, 480p, è destinato ad anteprime e bozze: il rendering è più veloce, rendendolo un banco di prova ideale per validare un prompt prima di rieseguirlo alla qualità finale. 720p corrisponde alla qualità HD sufficiente per la maggior parte degli usi web e mobile. 1080p, infine, ti offre il Full HD, ma non su tutti i modelli:

ModelloRisoluzione massima
grok-imagine-video-1.51080p nativo (720p in reference-to-video)
grok-imagine-video-1.5-lite1080p, tramite upsampling da 720p
grok-imagine-video720p

L’editing non è regolabile: il video prodotto mantiene la risoluzione della sorgente, limitata a 720p. E non esiste un’impostazione più fine di questi passaggi: il riferimento API non fornisce alcun parametro per la dimensione in pixel. Se la tua distribuzione richiede dimensioni esatte, scegli il rapporto e la risoluzione più vicini, quindi ritaglia in fase di editing.

{
  "model": "grok-imagine-video-1.5",
  "prompt": "Your description",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

Quanto costa davvero la produzione

Il prezzo è conteggiato per secondo di video generato e dipende dal modello: $0.020 per grok-imagine-video-1.5-lite, $0.050 per grok-imagine-video e $0.080 per grok-imagine-video-1.5. La progressione è perfettamente lineare, il che rende il budget prevedibile.

Durata1.5-litegrok-imagine-video1.5
1 secondo$0.02$0.05$0.08
3 secondi$0.06$0.15$0.24
5 secondi$0.10$0.25$0.40
8 secondi (predefinito)$0.16$0.40$0.64
10 secondi$0.20$0.50$0.80
15 secondi$0.30$0.75$1.20

Al 3 novembre 2026, la pagina Models di xAI mostra un unico prezzo al secondo per ogni modello, senza distinzione per risoluzione, mentre la pagina Video Overview fa riferimento a prezzi “per risoluzione”: controlla la griglia prima di impegnarti in un lotto di grandi dimensioni.

La prima leva di ottimizzazione è la scelta del modello. xAI raccomanda grok-imagine-video-1.5-lite, quattro volte più economico della versione 1.5, per video semplici, e grok-imagine-video-1.5 quando hai bisogno di immagini di riferimento, voci, immagini imposte o 1080p nativo; editing ed estensione, nel frattempo, funzionano solo con grok-imagine-video. La seconda leva è il numero di tentativi. Prototipa sistematicamente in breve: valida la direzione del movimento su due o tre secondi prima di impegnarti in una generazione di dieci o quindici secondi. Affina il prompt finché non è corretto al primo tentativo, poiché ogni rigenerazione paga il prezzo pieno. Esegui questi test in 480p: il prezzo visualizzato non cambia, ma il tempo di generazione ridotto ti permette di iterare più velocemente. E tieni presente il limite di frequenza quando pianifichi un lotto.

Questo ragionamento si calcola facilmente. Per un progetto di venticinque video da cinque secondi con grok-imagine-video, la produzione grezza ammonta a 20 × $0.25, ovvero $5.00 ($2.00 con la versione lite, $8.00 con la 1.5). Supponi due iterazioni medie per video e sei a $10.00. Aggiungi un margine di sperimentazione del 50% e presenti un budget di $15.00 che terrà. Questo è l’ordine di grandezza da comunicare a un cliente, non il costo teorico del primo calcolo.

Gestione dei limiti di frequenza (Rate Limits)

I limiti API sono conteggiati in richieste al secondo, per modello, e crescono con il livello del tuo team, stabilito a sua volta dalla tua spesa cumulativa: al livello di ingresso, i modelli video accettano 10 richieste al secondo e l’API risponde 429 Too Many Requests oltre tale soglia (Rate limits). Nell’uso comune, questo limite è raramente raggiunto: poiché la generazione è asincrona e lunga, passi più tempo ad aspettare che a inviare. Il rischio appare sui lotti massicci lanciati in parallelo, dove poche righe di codice possono saturare la quota in un istante. Spaziare le inviazioni è sufficiente per rimanere entro i limiti.

import asyncio

async def soumettre_lot(prompts, par_seconde=5):
    """Submits generations without exceeding the rate limit."""
    for prompt in prompts:
        await soumettre_video(prompt)  # POST, without waiting for completion
        await asyncio.sleep(1 / par_seconde)

Per lotti molto grandi che possono attendere, l’API Batch offre un’altra strada: le sue richieste non contano contro i limiti di frequenza e i tre modelli video la accettano (solo in certe regioni per grok-imagine-video e grok-imagine-video-1.5). Non aspettarti risparmi: lo sconto Batch si applica solo ai modelli di testo e il video è fatturato alla tariffa standard. L’elaborazione viene generalmente effettuata entro 24 ore, senza garanzia.

Consegnare il video senza scaricarlo

Ultima impostazione utile in produzione: il parametro output.upload_url designa un URL firmato (S3 o GCS presigned, Azure SAS) al quale il video verrà inviato automaticamente tramite HTTP PUT, con l’intestazione Content-Type: video/mp4, non appena generato.

{
  "model": "grok-imagine-video",
  "prompt": "Your description",
  "duration": 5,
  "output": {
    "upload_url": "https://your-storage.com/upload/video.mp4"
  }
}

In pratica, questo rimuove un intero passaggio dalla tua pipeline: non c’è bisogno di scaricare ogni file per poi spingerlo sul tuo storage, il video arriva direttamente alla sua destinazione. Su un flusso di diverse decine di clip al giorno, è tutto quel codice di trasferimento e gestione degli errori in meno da mantenere.

Prezzi registrati il 3 novembre 2026 — i prezzi evolvono regolarmente: prima di qualsiasi calcolo di budget, controlla la griglia attuale sulla pagina ufficiale dei modelli e dei prezzi di xAI.

Punti chiave

  • Sono disponibili nove rapporti d’aspetto, 16:9 di default; nell’image-to-video, l’output segue il rapporto dell’immagine
  • Tre risoluzioni: 480p (default), 720p e 1080p, quest’ultima solo sui modelli 1.5
  • Nessun parametro imposta una dimensione in pixel: rapporto e risoluzione bastano
  • Il prezzo è lineare, al secondo: $0.020, $0.050 o $0.080 a seconda del modello
  • Prototipa breve, in 480p, con il modello più economico che basta
  • output.upload_url automatizza la consegna; l’API Batch bypassa i limiti di frequenza, senza sconto sul video