Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Proporzioni, risoluzioni e formati di output

Lezione 3 di 14 Aggiornata il 2 novembre 2026 Principiante
In questa pagina
  1. Padroneggia le dimensioni delle tue immagini
  2. Proporzioni disponibili
  3. Risoluzioni: 1k vs 2k
  4. Formati di risposta
  5. Scegliere la combinazione giusta
  6. Punti chiave

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 utilizzano grok-imagine-image (Imagine 1.0) e grok-imagine-image-2.0 (Imagine 2.0, qualità low, medium o auto). Con l’SDK di OpenAI, aspect_ratio, resolution e quality vengono passati tramite extra_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, risoluzione 1k, Imagine 1.0
  • Storia/Reel: 9:16, risoluzione 1k, Imagine 1.0
  • Banner Web: 16:9 o 2:1, risoluzione 1k, Imagine 1.0
  • Poster per eventi: 3:4, risoluzione 2k, Imagine 2.0 in qualità medium
  • Illustrazione per articoli: 16:9, risoluzione 2k, Imagine 2.0 in qualità medium

Punti chiave

  • Oltre 10 proporzioni disponibili, più la modalità auto
  • Due risoluzioni: 1k (veloce, web) e 2k (dettagliata, stampa)
  • Due formati di risposta: url (temporaneo) e b64_json (persistente)
  • I tipi MIME restituiti possono essere PNG, JPEG o WebP
  • Adatta la proporzione al canale di distribuzione della tua immagine