Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Modifica di più immagini e riferimenti

Lezione 7 di 14 Aggiornata il 2 novembre 2026 Principiante
In questa pagina
  1. Lavorare con più immagini sorgente
  2. Il parametro images (al plurale)
  3. Riferire le immagini nel prompt
  4. Casi d’uso con più immagini
  5. Limiti e migliori pratiche
  6. Esercitazione pratica
  7. Punti chiave

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 ora 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 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 images accetta fino a 5 immagini sorgente in un array
  • image (singolare) e images (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