Wan 2.7 text-to-image per fotografia di prodotto e-commerce: immagini a livello studio in 4K con una singola chiamata API

Ogni immagine in questa guida è stata generata con wan2.7-image/text-to-image tramite l'API task di hiapi durante la stesura — i prompt mostrati sono quelli realmente usati, e i tempi sono i tempi di parete reali di queste esecuzioni. Se vendi online e ti servono immagini per le schede prodotto, scene, mockup di packaging o dettagli ingrandibili, senza prenotare uno studio, questo è il workflow che fa per te.

Perché usare Wan 2.7 Image per la fotografia di prodotto

Wan 2.7 Image Pro (ID modello wan2.7-image/text-to-image) è il modello text-to-image di punta di Tongyi Wanxiang. Tre caratteristiche lo rendono particolarmente adatto al lavoro e-commerce:

• Output fino a 4K. I visualizzatori con zoom delle piattaforme e-commerce e la stampa on-demand vogliono più pixel del default comune di 1K. Wan 2.7 supporta nativamente 4096×4096 — senza upscaling.
• Forte aderenza ai prompt. Le immagini di prodotto sono compositive: questa bottiglia, su quella superficie, illuminata da questo lato. Nelle nostre esecuzioni, le descrizioni dei materiali ("vetro smerigliato", "alluminio spazzolato"), la direzione della luce e il posizionamento degli oggetti sono stati azzeccati al primo colpo.
• Prezzo unificato. Su hiapi, $0.08 per immagine a qualsiasi risoluzione — 1K, 2K e 4K costano lo stesso (verificato sulla pagina prezzi in tempo reale). La maggior parte dei modelli premium applica un sovrapprezzo per il 4K, quindi se il tuo flusso è prevalentemente in 4K, la tariffa unificata è la scelta più economica. Maggiori confronti più avanti.

Accetta anche prompt in inglese e cinese, cosa importante se il tuo team di copywriting lavora in cinese ma il negozio si rivolge a utenti inglesi.

Avvio rapido: una POST, un polling

Wan 2.7 Image gira sull'API task asincrona di hiapi. Invii un task, esegui il polling finché non è completato, poi scarichi l'output. Inizia ottenendo una chiave API dalla guida di avvio rapido.

Invio:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image/text-to-image",
    "input": {
      "prompt": "Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

La risposta contiene l'ID del task in data.taskId. Esegui il polling dell'endpoint di dettaglio finché status non è success:

import requests, time

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

def generate(prompt, aspect_ratio="1:1", resolution="2K", timeout=600):
    r = requests.post(API, headers=HEADERS, json={
        "model": "wan2.7-image/text-to-image",
        "input": {"prompt": prompt, "aspect_ratio": aspect_ratio,
                  "resolution": resolution},
    })
    task_id = r.json()["data"]["taskId"]

    deadline = time.time() + timeout
    while time.time() < deadline:
        task = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if task["status"] == "success":
            return requests.get(task["output"][0]["url"]).content
        if task["status"] == "fail":
            raise RuntimeError(task.get("error"))
        time.sleep(5)
    raise TimeoutError(task_id)

png_bytes = generate("...")  # save immediately — see the expiry note below

Nelle nostre esecuzioni, la creazione del task è tornata in circa 2 secondi, la generazione in 2K si è completata in 60–75 secondi e le immagini 4K hanno richiesto 86 secondi. Aggiungendo l'overhead del polling, metti in budget circa un minuto e mezzo per immagine.

Prima di metterlo in produzione, due avvertenze operative:

1. Gli URL di output scadono. output[0].url contiene un timestamp expireAt — è un link temporaneo, non una risorsa CDN. Scarica i byte e salvali nel tuo storage nel momento esatto in cui il task va a buon fine. Se ti è già capitato questo problema, abbiamo scritto della modalità di errore in perché il tuo URL di output hiapi restituisce 404 e come gestirlo.
2. La lista dei rapporti d'aspetto è rigida. Wan 2.7 Image accetta solo 1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8. Qualsiasi altro rapporto — inclusi rapporti fotografici comuni come 3:2 e 4:5 — restituisce 400 INVALID_REQUEST, con un messaggio che elenca la lista consentita. Ci siamo imbattuti proprio in questo: una richiesta da 1536×1920 (semplificabile a 4:5) è stata rifiutata; reinviata con 3:4 è andata a buon fine. Se ti serve il 4:5 di Instagram, genera in 3:4 e ritaglia.

I quattro tipi di immagine che ogni scheda prodotto richiede

Ecco i quattro tipici tipi di immagine e-commerce, ciascuno con il prompt realmente usato e l'output non modificato.

1. Immagine principale su sfondo bianco

Amazon, eBay e la maggior parte delle piattaforme e-commerce richiedono uno sfondo bianco puro per l'immagine principale della scheda. Punti chiave nel prompt: specifica esplicitamente lo sfondo ("sfondo bianco puro senza giunzioni"), chiedi una "leggera ombra di contatto" così il prodotto non fluttua, e descrivi l'illuminazione come farebbe un fotografo.

Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography

Generata in 1:1 / 2K, ha richiesto 61 secondi. Il rendering dei materiali — il vetro smerigliato con il contagocce visibile in trasparenza, la texture in metallo spazzolato sul tappo — è proprio l'effetto di quella "forte aderenza ai prompt".

2. Immagine di scena

Le immagini secondarie della scheda servono a comunicare il contesto d'uso. Metti il prodotto dove il cliente immagina di usarlo e lascia che il prompt porti i requisiti di styling: superficie, oggetti di scena, direzione della luce, profondità di campo.

A frosted glass serum bottle with a brushed aluminum dropper cap standing on a white marble bathroom counter beside a folded beige linen towel and a sprig of eucalyptus, soft morning window light from the left, shallow depth of field, warm lifestyle product photography for an online store listing

Ogni elemento richiesto è presente: piano in marmo, asciugamano piegato, eucalipto, luce dalla finestra a sinistra, sfondo sfumato. È il tipo di immagine in cui l'aderenza al prompt conta di più, perché un oggetto in più o mancante significa rigenerare.

3. Immagine di packaging con testo di brand leggibile

Il rendering del testo è dove la maggior parte dei modelli di immagine fallisce sul lavoro di prodotto. Testi brevi e ben delimitati con Wan 2.7 vengono resi in modo affidabile — metti la stringa esatta tra virgolette e descrivi la tipografia:

Product packaging shot: a matte sage-green cardboard box with the brand name "VELA" printed in clean white sans-serif capital letters on the front panel, standing next to a matching frosted glass serum bottle, studio lighting on a light gray seamless background, sharp focus, e-commerce product photography

"VELA" è stato reso in modo fedele. Un avvertimento onesto dalle nostre esecuzioni di test: questo vale per stringhe brevi che specifichi esplicitamente. Quando le prime bozze della nostra immagine banner lasciavano l'etichetta alla libera iniziativa del modello, questo inventava sui flaconi un testo plausibile ma senza senso ("SERUM SERUE") — quindi o metti tra virgolette il testo esatto che vuoi, oppure prompi "nessuna etichetta, nessun testo, nessun logo" e aggiungi l'etichetta in post-produzione. Controlla sempre il testo di qualsiasi immagine generata prima di pubblicarla.

4. Immagine macro di dettaglio in 4K

Le immagini di dettaglio ingrandibili sostengono un posizionamento premium. È qui che entrano in gioco l'output 4K e la tariffa unificata — gli stessi $0.08 per un file 4096×4096:

Extreme close-up macro photograph of fine water droplets on the frosted glass surface of a cosmetic serum bottle, the brushed aluminum cap edge visible at the top of the frame, crisp micro-detail, controlled studio reflections, luxury skincare advertising detail shot

Il file a piena risoluzione è 4096×4096 (circa 1,2 MB come JPEG ottimizzato) e resta nitido senza alcun upscaling nei visualizzatori con zoom delle piattaforme e-commerce.

Confronto per carichi di lavoro e-commerce

Tutti i prezzi sotto sono le tariffe per immagine in tempo reale di hiapi al momento della stesura — controlla la pagina prezzi per i numeri attuali.

Modello	1K	2K	4K	Ideale per
wan2.7-image/text-to-image	$0.08	$0.08	$0.08	Flussi prevalentemente 4K, composizioni ricche di prompt
gpt-image-2/text-to-image	$0.03	$0.04	$0.06	Cataloghi ad alto volume in cui basta 1K–2K
nano-banana	$0.05	—	—	Velocità (1–2 secondi per immagine), iterazione rapida
nano-banana-pro	$0.17	$0.17	$0.2992	Asset di brand premium, molto rendering di testo

La regola decisionale che consigliamo: se le tue schede richiedono il 4K, Wan 2.7 è l'opzione 4K più economica della linea di prodotti, e la tariffa unificata rende la previsione dei costi molto semplice. Se 1K–2K bastano e i volumi sono il vincolo, gpt-image-2 è il cavallo da tiro del budget. Se devi iterare decine di volte sulla composizione prima di fissare la direzione, la generazione in 1–2 secondi di nano-banana mantiene i cicli rapidi — poi rendi nuovamente in 4K la variante vincente con Wan 2.7.

Una scheda prodotto completa — immagine principale, scena, packaging, macro — costa $0.32 su Wan 2.7 e richiede meno di cinque minuti di tempo di parete se i task vengono eseguiti in parallelo.

In sintesi

wan2.7-image/text-to-image offre ai team e-commerce fotografia di prodotto a livello studio con una singola chiamata API asincrona: $0.08 unificati fino al 4K a qualsiasi risoluzione, forte aderenza ai requisiti compositivi, rendering affidabile di testi brevi per il packaging. Fai attenzione alla lista rigida dei rapporti d'aspetto, scarica gli output prima che gli URL scadano, e controlla qualsiasi testo generato.

Pronto a provarlo sul tuo catalogo? Ottieni una chiave API, inizia dalla pagina del modello Wan 2.7 Image Pro, e la guida di avvio rapido dell'API asincrona renderà la tua prima immagine di prodotto in 4K in circa novanta secondi.