Generare immagini prodotto per l'e-commerce con seedream-5.0-lite/image-to-image tramite hiapi

La fotografia di prodotto per un negozio online raramente consiste solo nel generare un'immagine accattivante. Richiede di generare ripetutamente lo stesso prodotto: la foto su sfondo bianco per il catalogo, la scena lifestyle, la correzione di ferramenta o etichette dopo un cambio di fornitore, e la serie di immagini nelle cinque varianti colore per la pagina prodotto. I modelli text-to-image qui fanno fatica, perché ogni nuovo prompt inventa un prodotto leggermente diverso.

È qui che entra in gioco seedream-5.0-lite/image-to-image. È l'editor di immagini basato su istruzioni di ByteDance: fornisci una foto reale del prodotto (o fino a 14 immagini di riferimento), descrivi la modifica in linguaggio naturale, e il modello segue le istruzioni mantenendo coerenti le aree non modificate. Su hiapi, una singola immagine a risoluzione 2K costa solo $0.035 — un set completo di sei immagini per il catalogo costa circa $0.21.

Tutto quanto segue è stato generato tramite vere chiamate API su hiapi. Ogni sezione mostra l'output effettivo e il prompt esatto.

Flusso di lavoro: un'ancora, molteplici modifiche

Il modello che rende le immagini prodotto AI pronte per la produzione è ancorare e modificare:

1. Ancoraggio — ottieni un'immagine prodotto pulita e standard. Fotografa il prodotto reale, oppure genera una volta un'immagine concettuale con seedream-5.0-lite/text-to-image (anch'esso $0.035).
2. Modifica — alimenta image-to-image con l'immagine di ancoraggio per generare ogni variante derivata: sostituzione dello sfondo, correzione dei dettagli, varianti colore. L'identità del prodotto deriva dai pixel di riferimento, non dal prompt, quindi in ogni immagine c'è la stessa borsa.

Ecco la nostra immagine di ancoraggio — una borsa da weekend in tela, generata una volta con il modello gemello t2i e usata come riferimento per tutte le modifiche successive:

Struttura della richiesta

seedream-5.0-lite/image-to-image funziona sull'endpoint delle attività asincrone di hiapi: invia a POST /v1/tasks, esegui il polling dell'ID attività fino al completamento, poi scarica l'URL di output. Quattro campi di input, tutti obbligatori:

Campo	Tipo	Descrizione
prompt	string	Istruzione di modifica
image_urls	array	Da 1 a 14 URL di immagini di riferimento accessibili pubblicamente
aspect_ratio	enum	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
resolution	enum	Solo 2K o 4K — questo modello non ha un livello 1K

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
      "prompt": "Replace the white studio background: place the bag on a weathered wooden bench in a sunlit modern loft. Keep the bag itself completely unchanged.",
      "image_urls": ["https://your-cdn.com/products/weekender-anchor.jpg"],
      "aspect_ratio": "3:2",
      "resolution": "2K"
    }
  }'

La risposta contiene data.taskId. Esegui il polling di GET /v1/tasks/{taskId} finché status non è success, poi scarica immediatamente output[0].url — i link di output scadono, quindi copia il file nel tuo storage. Nella nostra esecuzione, ogni modifica si è completata in circa 60–120 secondi.

Modalità di modifica 1: ricollocare lo sfondo (catalogo → lifestyle)

La modifica più frequente nell'e-commerce: stesso prodotto, nuova scena. Il trucco chiave nel prompt è dedicare la maggior parte del testo a fissare ciò che non deve cambiare, e poi descrivere il nuovo ambiente:

Mantieni questa borsa da weekend in tela color arancio bruciato completamente invariata — stessa forma, stesso colore, stesse maniglie, stesse cuciture, con finiture in pelle marrone scuro e zip in ottone. Sostituisci lo sfondo bianco da studio: posiziona la borsa su una panca in legno usurato in un moderno loft illuminato dal sole, con una luce mattutina soffusa che entra dalle grandi finestre, piante verdi sfocate sullo sfondo, ombre di contatto naturali sulla panca, stile fotografia lifestyle da rivista caldo.

Confronta con l'immagine di ancoraggio: le finiture, la toppa in pelle con cuciture incrociate, i cursori delle zip e le proporzioni si mantengono. L'ombra di contatto cade sulle assi di legno — questo dettaglio di ancoraggio al suolo è ciò che fa sembrare la ricollocazione una foto reale anziché un composito.

Modalità di modifica 2: correzione precisa dei dettagli (sostituzione della ferramenta)

L'etichetta "modifica precisa" di Seedream Lite significa interventi chirurgici. Supponiamo che il fornitore sia passato dalla ferramenta in ottone a quella nera opaca e tu non voglia rifare lo shooting. Chiedi una sola modifica e congela tutto il resto:

Mantieni questa borsa da weekend in tela color arancio bruciato esattamente com'è — stesso sfondo bianco, stessa composizione, stessa luce, stessa texture della tela e finiture in pelle marrone. Modifica solo la ferramenta metallica: sostituisci tutte le zip, gli anelli e le fibbie in ottone con ferramenta metallica nera opaca. Non alterare nient'altro.

Zip, anelli a D e fibbie delle cinghie diventano tutti neri; la texture della tela e la composizione restano intatte. Questo tipo di modifica, se rigenerata con un text-to-image, ridisegnerebbe inconsapevolmente l'intera borsa.

Modalità di modifica 3: serie di varianti colore

La pagina prodotto richiede che ogni variante colore sia fotografata allo stesso modo. Ricolora l'immagine di ancoraggio fissando design, finiture e composizione:

Mantieni il design di questa borsa da weekend completamente invariato — stessa forma, stesse finiture e maniglie in pelle marrone, stessa ferramenta in ottone, stesso sfondo bianco da studio, stessa luce e composizione. Cambia solo il colore del corpo in tela da arancio bruciato a verde bosco profondo, preservando la texture del tessuto e le cuciture.

Ripeti con "blu navy", "antracite" e "beige sabbia" e ottieni con un solo shooting la serie di immagini per cinque SKU al costo di $0.175 — la composizione è identica in ogni variante, ed è proprio questo che fa apparire coerente il selettore colori sulla pagina prodotto.

Generare in batch l'intero set di immagini catalogo con Python

In produzione, non invii una modifica alla volta. L'API delle attività si parallelizza in modo pulito — invia tutte le modifiche in una volta, poi esegui il polling. Ecco il pattern che abbiamo usato (tre modifiche completate in parallelo in meno di tre minuti):

import json, time, requests, concurrent.futures

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_HIAPI_KEY", "Content-Type": "application/json"}
ANCHOR = "https://your-cdn.com/products/weekender-anchor.jpg"

EDITS = [
    ("lifestyle", "3:2", "Keep this exact bag unchanged... place it on a weathered wooden bench in a sunlit loft..."),
    ("hardware-black", "1:1", "Change only the metal hardware to matte black. Do not alter anything else."),
    ("colorway-green", "1:1", "Change only the canvas body color to deep forest green, preserving texture and trim."),
]

def run_edit(name, aspect_ratio, prompt):
    task = requests.post(API, headers=HEADERS, json={
        "model": "seedream-5.0-lite/image-to-image",
        "input": {"prompt": prompt, "image_urls": [ANCHOR],
                  "aspect_ratio": aspect_ratio, "resolution": "2K"},
    }).json()
    task_id = task["data"]["taskId"]
    while True:
        d = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if d["status"] == "success":
            img = requests.get(d["output"][0]["url"]).content   # expires — save it now
            open(f"{name}.jpg", "wb").write(img)
            return name, len(img)
        if d["status"] == "fail":
            raise RuntimeError(f"{name}: {d.get('error')}")
        time.sleep(5)

with concurrent.futures.ThreadPoolExecutor(max_workers=3) as ex:
    for name, size in ex.map(lambda e: run_edit(*e), EDITS):
        print(f"{name}: {size} bytes")

Tre consigli pratici dopo aver eseguito questo codice:

• image_urls deve essere accessibile pubblicamente. Carica prima l'immagine di ancoraggio sul tuo CDN o storage oggetti; l'API valida fino a 14 URL per richiesta.
• Salva subito gli output. output[0].url è un link a tempo. Copia i byte nel tuo bucket prima di fare qualsiasi altra cosa.
• Usa più immagini di riferimento quando serve. Passare più immagini di riferimento (fronte/retro/dettaglio dello stesso prodotto, oppure un prodotto più un riferimento di stile) fornisce più segnali di identità per oggetti difficili come i tessuti a motivi.

Costi e quando scegliere questo modello

A $0.035 per immagine 2K, un set realistico di immagini per SKU — un'immagine di ancoraggio, una ricollocazione lifestyle, una correzione di dettaglio e tre varianti colore — sei immagini in tutto, costa $0.21. Per i prezzi aggiornati di ogni livello, consulta la pagina prezzi di hiapi.

Se stai scegliendo tra editor: il nostro confronto tra tre modelli image-to-image esegue le stesse modifiche sui principali concorrenti, e la guida all'e-commerce con Nano-Banana presenta un'altra architettura di ancoraggio e ricollocazione. In questo flusso di lavoro, il punto di forza di Seedream 5.0 Lite è la precisione nel rispetto delle istruzioni, l'input multi-riferimento a 14 slot e un prezzo uniforme e basso che rende il batching per SKU un costo irrisorio.

Per iniziare

Ottieni una chiave API, carica un'immagine prodotto pulita, poi esegui il prompt di ricollocazione lifestyle qui sopra su seedream-5.0-lite/image-to-image — in pochi minuti avrai il tuo primo set di immagini derivate. Per il riferimento completo dell'endpoint delle attività, consulta la documentazione di hiapi.