Proporzioni, risoluzioni e formati di output
In questa pagina
Aggiornato il 2 novembre 2026 — Imagine.
grok-imagine-image-qualityè stato rimosso a partire dal 2 novembre 2026 (le sue richieste sono gestite da Imagine 2.0 in qualitàlow): gli esempi ora utilizzanogrok-imagine-image(Imagine 1.0) egrok-imagine-image-2.0(Imagine 2.0, qualitàlow,mediumoauto). Con l’SDK di OpenAI,aspect_ratio,resolutionequalityvengono passati tramiteextra_body, mentre la modifica avviene attraverso l’SDK xAI o una richiesta HTTP.
Padroneggia le dimensioni delle tue immagini
Le proporzioni e la risoluzione che scegli determinano direttamente l’aspetto e l’utilizzo delle tue immagini generate. L’API Grok Imagine offre una notevole flessibilità con numerose proporzioni predefinite e due livelli di risoluzione.
Proporzioni disponibili
Scegli la proporzione in base alla destinazione e fallo prima di generare. Ritagliare un’immagine quadrata per trasformarla in un banner panoramico dopo la generazione compromette la composizione costruita dal modello per il formato quadrato: il soggetto finisce fuori centro e i margini scompaiono. Generare direttamente nel formato corretto ha lo stesso costo e ti fornisce un’immagine progettata per quelle specifiche proporzioni.
| Proporzione | Orientamento | Utilizzo tipico |
|---|---|---|
| 1:1 | Quadrato | Profili, icone, Instagram |
| 16:9 | Paesaggio ampio | Presentazioni, banner, video |
| 9:16 | Ritratto verticale | Storie, Reels, TikTok |
| 4:3 | Paesaggio classico | Foto tradizionali, documenti |
| 3:4 | Ritratto | Poster, copertine di libri |
| 3:2 / 2:3 | Foto standard | Stampa fotografica, cartoline |
| 2:1 / 1:2 | Ultra ampio / ultra verticale | Banner web, panorami |
| auto | Automatico | Il modello sceglie la proporzione ottimale |
Sono disponibili anche proporzioni aggiuntive per casi specifici come gli schermi degli smartphone: 9:19.5, 19.5:9, 9:20 e 20:9.
Risoluzioni: 1k vs 2k
Tra 1k e 2k, la domanda non è «qual è la migliore», ma «dove verrà visualizzata questa immagine». Su uno schermo, la differenza è invisibile per la stragrande maggioranza degli usi web e 2k comporta solo un tempo di generazione più lungo. Diventa invece cruciale per la stampa, dove il numero di pixel per centimetro determina direttamente la nitidezza percepita.
1k: Risoluzione standard, adatta alla maggior parte degli usi web. Tempo di generazione più rapido.2k: Alta risoluzione, ideale per la stampa o per visual che richiedono molti dettagli.
# Risoluzione standard per il web
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Icona per app mobile in stile neon",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Alta risoluzione per la stampa
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Poster per concerto in stile Art Déco con tipografia elegante",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Formati di risposta
Il parametro response_format determina come l’immagine ti viene restituita:
URL temporaneo (Predefinito)
response = client.images.generate(
model="grok-imagine-image",
prompt="Gatto astronauta",
response_format="url"
)
# response.data[0].url → URL temporaneo, scaricalo rapidamente
JSON Base64
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Gatto astronauta",
response_format="b64_json"
)
image_bytes = base64.b64decode(response.data[0].b64_json)
with open("astronaut_cat.png", "wb") as f:
f.write(image_bytes)
La parola importante è temporaneo: l’URL restituito scade. Un’applicazione che lo memorizza in un database e lo visualizza settimane dopo si troverà di fronte a immagini rotte, spesso ben dopo il deployment. Hai due opzioni funzionanti: scaricare immediatamente l’immagine dall’URL oppure richiedere direttamente il Base64; in entrambi i casi, l’immagine deve finire sul tuo storage.
Scegliere la combinazione giusta
Per ogni caso d’uso, ecco le combinazioni raccomandate:
- Post Instagram:
1:1, risoluzione1k, Imagine 1.0 - Storia/Reel:
9:16, risoluzione1k, Imagine 1.0 - Banner Web:
16:9o2:1, risoluzione1k, Imagine 1.0 - Poster per eventi:
3:4, risoluzione2k, Imagine 2.0 in qualitàmedium - Illustrazione per articoli:
16:9, risoluzione2k, Imagine 2.0 in qualitàmedium
Punti chiave
- Oltre 10 proporzioni disponibili, più la modalità
auto - Due risoluzioni:
1k(veloce, web) e2k(dettagliata, stampa) - Due formati di risposta:
url(temporaneo) eb64_json(persistente) - I tipi MIME restituiti possono essere PNG, JPEG o WebP
- Adatta la proporzione al canale di distribuzione della tua immagine