Modifica di più immagini e riferimenti
In questa pagina
Aggiornato il 2 novembre 2026 — Imagine.
grok-imagine-image-qualityè stato rimosso a partire dal 2 novembre 2026 (le richieste sono ora gestite da Imagine 2.0 in qualitàlow): gli esempi utilizzano oragrok-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 viene gestita tramite l’SDK xAI o una richiesta HTTP.
Lavorare con più immagini sorgente
Uno dei punti di forza dell’endpoint di modifica è la possibilità di fornire fino a 5 immagini di riferimento in un’unica richiesta. Questo apre a possibilità creative avanzate: combinare elementi da più fonti, fondere stili o creare composizioni complesse.
Il parametro images (al plurale)
Passare da image a images cambia più della semplice struttura del parametro: modifica ciò che chiedi al modello di fare. Con una singola sorgente, il modello modifica un’immagine; con più sorgenti, deve arbitrare tra di esse, decidendo cosa prendere da ciascuna. Arbitrerà comunque; l’unica domanda è se tu guidi questo processo, ed è proprio su questo che ci concentreremo nella prossima sezione.
Nota che i due parametri si escludono a vicenda: image (singolo oggetto) e images (array) non possono essere combinati.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Combina il personaggio della prima immagine con "
"il paesaggio della seconda immagine",
"images": [
{"url": "https://exemple.com/personnage.jpg"},
{"url": "https://exemple.com/paysage.jpg"}
]
}
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
).json()
Riferire le immagini nel prompt
Quando fornisci più immagini, puoi riferirti a ciascuna di esse individualmente nel tuo prompt utilizzando la sintassi <IMAGE_0>, <IMAGE_1>, ecc. L’indice inizia da 0.
payload = {
"model": "grok-imagine-image",
"prompt": "Posiziona il prodotto di <IMAGE_0> sul tavolo di <IMAGE_1>, "
"con l'illuminazione ambientale di <IMAGE_2>",
"images": [
{"url": "https://exemple.com/produit.jpg"}, # <IMAGE_0>
{"url": "https://exemple.com/table.jpg"}, # <IMAGE_1>
{"url": "https://exemple.com/ambiance.jpg"} # <IMAGE_2>
]
}
Questa sintassi è ciò che distingue una composizione controllata da una fusione approssimativa. Dire «combina queste immagini» lascia tutto al modello; dire «posiziona il prodotto di <IMAGE_0> nell’ambientazione di <IMAGE_1> mantenendo l’illuminazione di <IMAGE_1>» non lascia spazio all’interpretazione. Non appena fornisci più di una sorgente, riferisciti ad esse esplicitamente.
Casi d’uso con più immagini
Trasferimento di stile
Applica lo stile di un’immagine di riferimento a un’altra:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Riproduci il contenuto di <IMAGE_0> nello stile artistico di <IMAGE_1>",
"images": [
{"url": "https://exemple.com/photo-originale.jpg"},
{"url": "https://exemple.com/reference-style.jpg"}
]
}
Composizione di prodotti
Integra un prodotto in un’ambientazione con un’illuminazione di riferimento:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Fotografa il prodotto di <IMAGE_0> posizionato sul mobile di <IMAGE_1> "
"nella stanza di <IMAGE_2>, con illuminazione naturale coerente",
"images": [
{"url": "https://exemple.com/produit-detouré.png"},
{"url": "https://exemple.com/meuble.jpg"},
{"url": "https://exemple.com/piece.jpg"}
]
}
Fusione di volti e sfondi
Combina un ritratto con uno sfondo specifico:
payload = {
"model": "grok-imagine-image",
"prompt": "Posiziona la persona di <IMAGE_0> davanti all'edificio di <IMAGE_1>, "
"mantenendo l'illuminazione naturale e la prospettiva",
"images": [
{"url": "https://exemple.com/portrait.jpg"},
{"url": "https://exemple.com/batiment.jpg"}
]
}
Limiti e migliori pratiche
Il limite tecnico è di 5 immagini per richiesta e puoi mescolare liberamente i formati: alcune sorgenti come URL, altre come Base64, nello stesso array. La vera difficoltà non sta qui: risiede nella precisione del prompt, che deve crescere con il numero di immagini. Con due sorgenti, «combina il personaggio e l’ambientazione» spesso basta; con cinque, il modello non può più indovinare quale elemento prendere da quale immagine, ed è esattamente qui che entrano in gioco i riferimenti da <IMAGE_1> a <IMAGE_5>: «posiziona il logo di <IMAGE_2> sulla maglietta del personaggio di <IMAGE_1>, nell’atmosfera luminosa di <IMAGE_3>» non lascia alcuna ambiguità. Per composizioni complesse multi-sorgente, il modello pro (grok-imagine-image-quality) giustifica il suo costo aggiuntivo: è proprio qui che il divario con il modello standard è più visibile, nella coerenza tra elementi eterogenei.
Esercitazione pratica
Prova a combinare due immagini che hai a disposizione:
payload = {
"model": "grok-imagine-image",
"prompt": "Crea una scena in cui l'oggetto di <IMAGE_0> fluttua nel cielo di <IMAGE_1>, "
"in stile surrealista",
"images": [
{"url": "URL_OF_YOUR_FIRST_IMAGE"},
{"url": "URL_OF_YOUR_SECOND_IMAGE"}
],
"n": 3
}
Genera 3 varianti per confrontare le interpretazioni del modello.
Punti chiave
- Il parametro
imagesaccetta fino a 5 immagini sorgente in un array image(singolare) eimages(plurale) si escludono a vicenda- La sintassi
<IMAGE_0>,<IMAGE_1>ti permette di riferirti a ciascuna immagine nel prompt - I casi d’uso includono il trasferimento di stile, la composizione e la fusione
- Sii preciso nel tuo prompt quando utilizzi più sorgenti