Ricette di prompt per grok-imagine image-to-image: 5 esempi di editing pronti da copiare e incollare con output reali

TL;DR

• Che cos'è: cinque prompt di editing pronti da copiare e incollare per grok-imagine/image-to-image — il livello base da $0.03 dell'editor di immagini di xAI su hiapi — ciascuno con l'immagine di input esatta, il prompt e l'output grezzo del primo tentativo prodotto dall'API live. Nessun retry nascosto, tutti i media sono ospitati qui in modo permanente.
• A cosa serve questo modello: editing economico, veloce e guidato da istruzioni. Passi 1–3 immagini di riferimento più un'istruzione in inglese semplice e il modello ri-renderizza la scena — cambia il colore di un prodotto, lo colloca in un nuovo ambiente, ridisegna lo stile di una foto o compone due riferimenti — conservando ciò che gli chiedi di conservare.
• Fatti sullo schema (verificati il 2026-07-13 contro l'API dei task live): prompt e image_urls sono obbligatori; image_urls accetta da 1 a 3 URL accessibili pubblicamente; resolution opzionale è in minuscolo 1k o 2k; aspect_ratio opzionale accetta auto e 13 rapporti fissi da 2:1 a 9:20. Non ci sono strength, seed o n — i campi sconosciuti vengono rifiutati con un 400, quindi la guida avviene interamente tramite il prompt.
• Prezzo (dalla pagina dei prezzi): $0.03 per immagine prodotta, più $0.003 per immagine di riferimento — meno della metà del prezzo del livello qualità. Alle tariffe attuali, un editing a singolo riferimento come quelli qui sotto costa $0.033, e nelle nostre esecuzioni ogni editing è stato restituito in ben meno di un minuto.
• Conto totale dei media di questo articolo: quattro immagini di riferimento grok-imagine/text-to-image per un totale di $0.03, cinque editing del livello base ($0.033 ciascuno a singolo riferimento, $0.036 la composizione a doppio riferimento), una copertina gpt-image-2 da $0.03 — totale di $0.318 alle tariffe attuali.

Livello base o livello qualità?

hiapi offre due livelli di editing della stessa famiglia, con lo stesso schema di richiesta:

	grok-imagine/image-to-image	grok-imagine-quality/image-to-image
Prezzo	$0.03/immagine + $0.003 per riferimento	$0.08 per 1k, $0.10 per 2k, più $0.015 per riferimento
Immagini di riferimento	1–3 URL	1–3 URL
Ideale per	Cambio colore, ridisegno di stile, sostituzione scenario, volumi/batch	Massima fedeltà d'identità per volti e dettagli fini

Questo articolo tratta il livello base. Ha completato tutte le ricette qui sotto al primo tentativo a circa un terzo del prezzo — se stai iterando sui prompt o generando varianti in batch, parti da qui e passa al livello superiore solo quando la fedeltà non ti soddisfa. Abbiamo condotto esperimenti analoghi sul livello qualità, vedi l'altro articolo con le ricette, se vuoi confrontare.

Come sono state realizzate queste ricette

Ogni ricetta contiene tre parti: l'immagine di input, il prompt di editing esatto (copialo così com'è) e l'output grezzo. Ho generato ogni immagine di riferimento con grok-imagine/text-to-image ($0.03 ciascuna), scritto personalmente ogni prompt di editing e l'ho eseguito una sola volta tramite grok-imagine/image-to-image sull'API dei task hiapi live. Ogni output che vedi è il risultato del primo tentativo — impostazioni e costo reale sono stampati sotto ogni immagine.

Poiché lo schema non ha una manopola per l'intensità dell'editing, due abitudini nei prompt sostengono tutte e cinque le ricette:

• Prima la clausola di modifica, poi la clausola di conservazione. Descrivi prima l'editing, poi elenca tutto ciò che deve essere conservato: «Mantieni esattamente la stessa forma della scarpa, l'angolazione della fotocamera, l'illuminazione, lo sfondo e l'ombra sul terreno.» La clausola di conservazione è il tuo unico controllo di coerenza — trattala come portante, non come decorativa.
• aspect_ratio: "auto" eredita il formato dell'input — dal primo URL. Tutti e cinque gli editing hanno usato auto. Nella ricetta 4, il primo riferimento è quadrato, il secondo è 4:3; l'output è uscito quadrato. Se componi due riferimenti, metti quello di cui vuoi adottare la composizione al primo posto in image_urls.

Ricetta 1 — Cambio colore prodotto: nuova palette, tutto il resto invariato

Obiettivo: l'editing più comune nell'e-commerce — cambiare la palette di un prodotto senza rifare il servizio fotografico.

Input, una natura morta grok-imagine/text-to-image da $0.03:

Prompt:

Ricolora la sneaker in una morbida tela verde salvia, con suola in gomma color crema e lacci coordinati verde salvia. Mantieni esattamente la stessa forma della scarpa, l'angolazione della fotocamera, l'illuminazione, lo sfondo e l'ombra sul terreno. Non aggiungere altri oggetti.

Output grezzo:

grok-imagine/image-to-image · resolution: "1k" · aspect_ratio: "auto" (input 1:1 → output 1:1) · $0.033

Perché funziona: la clausola di modifica specifica tre materiali concreti (tela, suola, lacci) e colori precisi, mentre la clausola di conservazione fissa forma, angolazione, illuminazione, sfondo e ombre. Le cuciture, il numero di occhielli e la texture della punta sono rimasti invariati. Nominare i componenti — «suola», «lacci» — è importante: un prompt scarno tipo «rendila verde» farebbe colorare al modello qualsiasi cosa a caso.

Ricetta 2 — Trasferimento di scenario: da foto da studio a strada notturna

Obiettivo: collocare la stessa sneaker da catalogo in uno scenario lifestyle d'atmosfera, per un visual pubblicitario.

Input identico alla ricetta 1. Prompt:

Colloca questa identica sneaker sull'asfalto bagnato di una strada cittadina di notte, con insegne al neon che si riflettono nelle pozzanghere poco profonde circostanti, illuminazione cinematografica color ottanio e magenta, angolazione bassa della fotocamera. Mantieni invariati il design, il colore e le proporzioni della sneaker.

Output grezzo:

grok-imagine/image-to-image · resolution: "1k" · aspect_ratio: "auto" · $0.033

Perché funziona — e un avvertimento onesto: la descrizione della scena è densa (superficie, meteo, insegne, tonalità, altezza della fotocamera), così il modello non ha vuoti da riempire con elementi generici. Design e proporzioni sono rimasti intatti. Nota però che la scarpa appare leggermente rosata: il modello ha ri-illuminato il prodotto con il neon magenta della scena, come farebbe la luce ambientale reale. È un rendering fisicamente plausibile, non un difetto — ma se l'accuratezza del colore del marchio non è negoziabile, dillo esplicitamente: «La tela resta bianco puro, senza dominanti di colore provenienti dall'ambiente.»

Ricetta 3 — Trasferimento di stile: da foto ad acquerello

Obiettivo: trasformare una foto ritratto in un'illustrazione mantenendo la persona riconoscibile.

Input, un ritratto grok-imagine/text-to-image da $0.03:

Prompt:

Trasforma questa foto in un'illustrazione ad acquerello dai tratti sciolti: morbide colature di pigmento, texture della carta visibile, bordi sfumati, linee minime. Mantieni chiaramente riconoscibili la posa, i capelli neri corti, gli orecchini a cerchio e il dolcevita giallo.

Output grezzo:

grok-imagine/image-to-image · resolution: "1k" · aspect_ratio: "auto" (input 3:4 → output 3:4) · $0.033

Perché funziona: lo stile è descritto tramite i meccanismi del medium — colature, texture della carta, bordi sfumati, linee — e non tramite nomi di artisti o etichette vaghe come «artistico». La clausola di conservazione ancora l'identità a quattro attributi concreti (posa, capelli, orecchini, maglia) e tutti e quattro sono rimasti dopo la conversione di medium, fino al singolo orecchino a cerchio visibile.

Ricetta 4 — Doppio riferimento: questo prodotto in quella scena

Obiettivo: comporre il prodotto di un'immagine nell'ambiente di un'altra — un editing che di solito richiede maschere e un compositore.

Riferimento 1 (il prodotto, nonché il formato che l'output seguirà):

Riferimento 2 (la scena):

Prompt:

Colloca il dripper in ceramica nera e la caraffa di vetro della prima immagine sul tavolo di legno della seconda immagine, con la luce dorata della finestra che colpisce il vetro, mantenendo il design del prodotto identico a quello della prima immagine, con un caldo feeling da fotografia analogica.

Output grezzo:

grok-imagine/image-to-image · due image_urls · resolution: "1k" · aspect_ratio: "auto" (segue il primo riferimento: 1:1) · $0.036

Perché funziona: il prompt assegna un ruolo a ciascun riferimento in base alla posizione — «della prima immagine», «della seconda immagine» — così il modello sa qual è il soggetto e qual è la scena. La sagoma del dripper e il beccuccio della caraffa corrispondono al riferimento, e i raggi dell'ora d'oro colpiscono esattamente il punto in cui si trovano nella scena di riferimento. Nota l'output quadrato: con più riferimenti, il primo URL determina il formato dell'output, quindi ordina image_urls in modo intenzionale.

Ricetta 5 — Conversione in asset: da foto ad adesivo fustellato

Obiettivo: trasformare una foto in un adesivo in stile vettoriale piatto — asset rapidi per social e merchandising con un solo prompt.

Input identico al ritratto della ricetta 3. Prompt:

Trasforma questo ritratto in un adesivo fustellato vettoriale piatto: contorni spessi e puliti, ombreggiatura cel semplice, spesso bordo bianco adesivo attorno alla figura, sfondo tinta unita chiaro. Mantieni i capelli neri corti, gli orecchini a cerchio e il dolcevita giallo.

Output grezzo:

grok-imagine/image-to-image · resolution: "1k" · aspect_ratio: "auto" · $0.033

Perché funziona: «adesivo fustellato vettoriale piatto» da solo è ambiguo, quindi il prompt lo definisce operativamente — contorni, ombreggiatura cel, bordo, sfondo. Gli attributi identitari della clausola di conservazione sono rimasti intatti una seconda volta in una conversione di medium completa, ed è proprio questo il punto: un ritratto di riferimento può essere esteso in un intero kit di asset (acquerello, adesivo e qualunque stile tu scriva dopo), a $0.033 ciascuno.

Eseguire esattamente le stesse chiamate

Tutto quanto sopra è l'API dei task asincrona: crea un task, esegui il polling del task, scarica l'output. Con curl:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine/image-to-image",
    "input": {
      "prompt": "Ricolora la sneaker in una morbida tela verde salvia, con suola in gomma color crema e lacci coordinati verde salvia. Mantieni esattamente la stessa forma della scarpa, l'angolazione della fotocamera, l'illuminazione, lo sfondo e l'ombra sul terreno. Non aggiungere altri oggetti.",
      "image_urls": ["https://your-cdn.example.com/sneaker.jpg"],
      "resolution": "1k",
      "aspect_ratio": "auto"
    }
  }'

La risposta restituisce un taskId. Esegui il polling finché status non è success, poi scarica l'immagine da output[0].url (gli URL hanno breve validità — salva il file, non fare hotlink):

curl https://api.hiapi.ai/v1/tasks/$TASK_ID \
  -H "Authorization: Bearer $HIAPI_API_KEY"

Tre regole dello schema che ti aiutano a evitare i 400:

1. image_urls devono essere accessibili pubblicamente — niente header di autenticazione, niente localhost. Carica prima le immagini di riferimento su un bucket o una CDN.
2. resolution è in minuscolo 1k o 2k; aspect_ratio è auto oppure uno dei 13 rapporti fissi (2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:19.5, 9:20, 1:2).
3. Qualsiasi altro campo — strength, seed, n, negative_prompt — viene rifiutato: additional properties not allowed. Il prompt è l'intera superficie di controllo, ed è per questo che il pattern della clausola di conservazione è importante.

Per la configurazione, esempi in Python e gestione degli errori, vedi la guida complementare: Come usare grok-imagine image-to-image tramite l'API hiapi.

Domande frequenti

grok-imagine/image-to-image supporta strength, seed o negative prompt? No. Lo schema di input è prompt, image_urls e resolution / aspect_ratio opzionali — verificato il 2026-07-13 contro l'API live; i campi sconosciuti restituiscono 400. Usa invece il pattern clausola di modifica / clausola di conservazione per guidare il modello.

Quante immagini di riferimento posso passare e l'ordine conta? Da 1 a 3 URL pubblici, e sì, conta — con aspect_ratio: "auto" il formato dell'output segue il primo URL, e frasi di ruolo come «della prima immagine / della seconda immagine» legano ogni riferimento al suo compito.

Quando dovrei passare al livello qualità? Il livello base ha gestito al primo tentativo cambio colore, sostituzione di scenario, ridisegno di stile e composizione a doppio riferimento a $0.033–$0.036. Valuta grok-imagine-quality/image-to-image ($0.08 per 1k, più $0.015 per riferimento) quando ti serve la massima fedeltà per volti o dettagli fini del prodotto, oppure output 2K. Per un confronto tra modelli vedi Le migliori API image-to-image del 2026.

Perché il mio prodotto bianco torna con una dominante di colore? Il modello ri-illumina il soggetto con la luce ambientale della scena (vedi la dominante magenta nella ricetta 2). Se il colore preciso è importante, fissalo nella clausola di conservazione: «La tela resta bianco puro, senza dominanti di colore provenienti dall'ambiente.»

Da dove provengono le immagini di riferimento? Va bene qualsiasi URL pubblico — incluse le tue foto prodotto. Le nostre sono state generate con grok-imagine/text-to-image a $0.03 ciascuna, quindi l'intero articolo — riferimenti, cinque editing e copertina — costa in totale $0.318 alle tariffe attuali.

---

Ogni prompt di questo articolo è pronto da copiare e incollare. Ottieni una API key, punta image_urls su una tua foto prodotto ed esegui la ricetta 1 così com'è sulla pagina del modello grok-imagine/image-to-image — il tuo primo cambio colore costa $0.033.