Grok Imagine API: guida Python e 3 modelli provati fianco a fianco

L'API di Grok Imagine è l'API di xAI per immagini e video, e ha tre modelli immagine che puoi chiamare già oggi: grok-imagine-image, grok-imagine-image-quality e grok-imagine-image-2.0. Il 18 ottobre 2026 abbiamo fatto girare gli stessi quattro prompt su tutti e tre, e Grok Imagine 2.0 ha vinto tre test su quattro.

Qui sotto: quale modello scegliere, uno script Python che funziona così com'è, quanto chiede xAI per immagine e a cosa fare attenzione.

Risposta breve

• Usa Grok Imagine 2.0 (grok-imagine-image-2.0) come predefinito. Nei nostri test ha dato la tipografia migliore sul poster, il miglior scatto di prodotto e la miglior foto, e xAI lo quota da 0,04 $ per immagine.
• Tieni l'originale grok-imagine-image per le bozze economiche: 0,02 $ per immagine su xAI, e ha azzeccato anche il testo del nostro poster.
• Salta grok-imagine-image-quality: xAI lo ritira il 2 novembre 2026, e ha aggiunto al nostro poster un indirizzo inventato.
• Ogni immagine è tornata in 7-18 secondi.

Che cos'è l'API di Grok Imagine?

È l'API di xAI per immagini e video, aperta il 28 gennaio 2026 (xAI). Image 2.0 è arrivato il 7 agosto 2026 e, secondo xAI, è secondo al mondo sia nella generazione sia nella modifica delle immagini (xAI).

Tutti e tre sono su OmniaKey: Grok Imagine, Grok Imagine Quality e Grok Imagine 2.0. OmniaKey vende l'accesso API a questi modelli, quindi i nostri test sono passati da lì; ogni prezzo qui è quello di xAI.

Quale modello di Grok Imagine conviene usare?

Grok Imagine 2.0, a meno che tu non abbia bisogno solo di bozze economiche. Abbiamo dato a ogni modello gli stessi quattro prompt una volta, senza impostazioni di dimensione o proporzioni, e abbiamo giudicato le immagini a piena dimensione.

Test 1: il testo sul poster

Prompt:

A minimalist poster for a neighborhood coffee shop opening. Large bold headline text "GRAND OPENING", smaller text below "Saturday 9 AM", a simple line drawing of a coffee cup, cream background, dark brown ink.

Tutti e tre hanno scritto correttamente le due righe (il poster qui sopra). Grok Imagine 2.0 aveva il layout più curato, con filetti sottili intorno alla data. Quality ha aggiunto una riga che nessuno aveva chiesto:

Verdetto: 2.0 per l'aspetto, l'originale se ti serve solo il testo giusto. Per la stampa evita Quality: il testo inventato è l'ultima cosa che vuoi su un volantino.

Test 2: una foto realistica

Prompt:

A realistic photo of an elderly fisherman mending a blue net on a wooden dock at sunrise, soft golden light, gulls in the background, shallow depth of field.

• Grok Imagine: bella luce dorata e una scena credibile, ma con tutto il molo a fuoco.
• Quality: soggetto e ambiente giusti, però il pescatore è piccolo nell'inquadratura e il dettaglio è più morbido.
• Grok Imagine 2.0: un primo piano con lo sfondo sfocato, l'unico che ha fatto davvero la "profondità di campo ridotta".

Verdetto: 2.0.

Test 3: uno scatto di prodotto

Prompt:

Studio product photo of a matte black wireless earbud case, lid open, both earbuds inside, on a pure white background, soft shadow, sharp focus, no text, no logo.

Tutti e tre hanno azzeccato ogni dettaglio: coperchio aperto, entrambi gli auricolari, fondo bianco, nessun logo. L'originale lasciava la custodia piccola nell'inquadratura e Quality l'ha fotografata di taglio. Grok Imagine 2.0 ha riempito l'inquadratura con dettaglio nitido, pronto per una scheda prodotto.

Verdetto: 2.0.

Test 4: contare gli oggetti

Prompt:

Top-down photo of a wooden table with exactly three red apples on the left and exactly two green pears on the right, nothing else on the table.

Tutti e tre hanno messo esattamente tre mele a sinistra e due pere a destra, senza altro sul tavolo. L'originale mostrava le pere in piedi invece che dall'alto, e le pere di 2.0 sono uscite più gialle che verdi.

Verdetto: pareggio sul conteggio; Quality ha avuto lo scatto dall'alto più pulito.

Come si chiama da Python?

Tre passaggi: creare il lavoro, controllarlo finché non è finito, poi scaricare l'immagine. Metti la chiave in una variabile d'ambiente ed esegui:

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Crea il lavoro. Riusa la stessa Idempotency-Key solo quando ripeti questa identica richiesta.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "grok-imagine-image-2.0",
        "type": "image",
        "operation": "generate",
        "input": {"prompt": "A flat illustration of a red bicycle leaning on a yellow wall, morning light"},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Controlla lo status finché il lavoro non è finito.
while task["status"] in ("queued", "processing"):
    time.sleep(2)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Scarica subito: l'URL firmato dura poco.
asset = task["assets"][0]
with open("bicycle.jpg", "wb") as f:
    f.write(requests.get(asset["url"], timeout=60).content)
print("saved bicycle.jpg", asset["mime_type"], asset["byte_size"], "bytes")

Quando l'abbiamo eseguito il 18 ottobre 2026, ha stampato questo e salvato un JPEG da 1248 × 832 16 secondi dopo l'avvio:

task: task_LBCu6Lr8hyD4RH25JfiOixJHPHi3Cd0o queued
saved bicycle.jpg image/jpeg 267732 bytes

Per provare un altro modello, cambia solo il valore di model.

Quanto costa l'API di Grok Imagine?

xAI fattura per immagine, e il prezzo dipende dal modello, dalla risoluzione e, per 2.0, dal livello di qualità. Queste sono le tariffe di xAI dalla sua pagina dei prezzi, controllate il 18 ottobre 2026:

2.0 usa la qualità bassa per le immagini nuove, a meno che tu non chieda altro, quindi un'immagine 1K costa 0,04 $ su xAI. Sull'API di xAI, una richiesta che viola le linee guida d'uso viene comunque addebitata. Con OmniaKey paghi un prezzo fisso per immagine (le tariffe attuali sono nelle pagine dei modelli) e un lavoro fallito viene rimborsato.

A cosa devi fare attenzione?

• Nessuna modifica tramite OmniaKey. L'API di xAI permette a 2.0 di modificare le immagini con fino a cinque immagini di riferimento, ma tramite OmniaKey Grok genera solo immagini nuove. Per le modifiche usa un modello che le supporta, come Nano Banana 2.1.
• La forma la sceglie il modello. Senza impostazioni di proporzioni, Grok ha scelto il verticale per il nostro poster e l'orizzontale per le scene, sempre intorno a un megapixel (da 832 × 1248 a 1280 × 720).
• Quality sparisce il 2 novembre. Dopo quella data xAI risponde alle richieste per grok-imagine-image-quality con 2.0 a qualità bassa, quindi cambia adesso.
• Riprova una volta sul 400. Uno dei nostri 14 lavori è fallito con un 400 ed è stato rimborsato; il nuovo tentativo identico ha funzionato.

Conclusione

Per la maggior parte del lavoro chiama grok-imagine-image-2.0: ha vinto tre dei nostri quattro test e costa 0,04 $ per immagine 1K su xAI. Usa il modello originale quando ti servono molte bozze economiche, e lascia Quality prima del 2 novembre.

Domande frequenti

L'API di Grok Imagine è gratuita?

No. xAI indica un prezzo per immagine per ogni modello immagine di Grok, a partire da 0,02 $ per il modello originale.

Grok Imagine può fare video tramite l'API?

Sì. xAI fattura i modelli video al secondo, per esempio 0,08 $ al secondo a 480p per Grok Imagine Video 1.5. Su OmniaKey vedi Grok Imagine Video 1.5.

Che dimensione avrà l'immagine?

Circa un megapixel per impostazione predefinita. La guida di xAI indica 1K come predefinito e 2K come opzione, e il modello sceglie le proporzioni se non le imposti.

Cosa succede a grok-imagine-image-quality dopo il 2 novembre?

xAI continua a rispondere, ma con Grok Imagine 2.0 a qualità bassa e al prezzo di 2.0. L'originale grok-imagine-image non è toccato.