Guida all'uso
Flusso di lavoro per immagini di prodotto e-commerce con Qwen Image 3.0 Pro
TL;DR (versione breve)
- Cos'è: un flusso di lavoro e-commerce reale basato su qwen-image-3.0-pro tramite l'API hiapi — genera foto prodotto principali di livello studio, immagini in contesto lifestyle e ridisegna lo stesso prodotto in nuove scene a partire da un'immagine di riferimento, il tutto usando i prompt mostrati in questa pagina.
- Il vero vantaggio del livello Pro nel lavoro sulle immagini di prodotto non è solo un rendering più fine — è l'endpoint image-to-image, che accetta una foto di riferimento e la ridisegna in una nuova scena mantenendo il prodotto riconoscibile. La versione base qwen-image-3.0 e il precedente qwen-image-2.0-pro non offrono questa capacità.
- Prezzi verificati (a partire da 2026-09): $0,0497/immagine a risoluzione 1K, $0,0993/immagine a 2K, stesso prezzo per gli endpoint text-to-image e image-to-image; image-to-image costa $0,004 in più per ogni immagine di riferimento (supporta 1-3 immagini di riferimento). La versione base qwen-image-3.0 ha un prezzo unico di $0,0358/immagine, senza fasce di risoluzione.
- Flusso di lavoro: invia ogni asset come attività separata a
/v1/tasks, esegui il polling fino al completamento, scarica subitooutput[0].url— poi valuta per ogni asset se è più veloce rifare un rendering text-to-image o ridisegnare una foto esistente con image-to-image.
Perché il flusso di lavoro di ridisegno è più importante dell'immagine principale
La maggior parte degli articoli su «fotografia di prodotto con AI» si ferma alla foto principale: un rendering pulito del prodotto su sfondo bianco. È solo il 20% facile — qualsiasi modello text-to-image capace può farlo, incluso il più economico qwen-image-3.0 base.
La parte più difficile e costosa di un vero flusso di lavoro sulle immagini di prodotto è tutto ciò che viene dopo l'immagine principale: lo stesso prodotto deve apparire in immagini lifestyle, banner stagionali e decine di varianti «come starebbe a casa tua» — restando sempre lo stesso prodotto riconoscibile. Ci sono due strade per raggiungere questo obiettivo:
- Riscrivere i prompt da zero per ogni scena, sperando che il modello riproduca ogni volta la stessa forma, colore e proporzioni del prodotto. Questo genera derive — i dettagli sottili (la posizione esatta del logo, la curvatura esatta della scocca) cambiano tra una generazione e l'altra.
- Generare prima un'immagine di riferimento pulita, poi ridisegnarla in nuove scene con image-to-image, indicando esplicitamente al modello di mantenere forma e proporzioni invariate. Questo è esattamente lo scopo dell'endpoint image-to-image di qwen-image-3.0-pro, nonché la capacità assente dallo schema solo text-to-image di qwen-image-3.0 base e qwen-image-2.0-pro in questo confronto.
Il resto di questa pagina percorre entrambe le strade con lo stesso prodotto (una custodia di ricarica per auricolari wireless) — un nuovo rendering dell'immagine principale, un nuovo rendering lifestyle e un ridisegno dell'immagine principale in un'atmosfera completamente diversa a partire da un riferimento — così puoi vedere direttamente la differenza.
Costruire gli asset
Ognuna delle immagini seguenti viene inviata tramite POST https://api.hiapi.ai/v1/tasks, interrogata con GET /v1/tasks/{taskId} fino a status: "success", quindi scaricata da output[0].url (il link scade, scaricalo subito).
1. Foto prodotto principale in studio (text-to-image)
Modello: qwen-image-3.0-pro/text-to-image · input: {prompt, aspect_ratio: "1:1", resolution: "1K"} · costo: $0,0497

Prompt: «Professional e-commerce product photography of a minimalist matte-black wireless earbuds charging case, closed lid, resting at a slight angle on a pure white seamless studio background, soft box lighting from upper left creating a gentle gradient shadow beneath the product, subtle reflection on the surface, sharp focus, high dynamic range, no text, no watermark, studio product shot style, centered composition with even margin on all sides»
Questa è l'immagine principale della scheda prodotto, nonché l'immagine di riferimento usata per il ridisegno qui sotto — un'immagine prodotto pulita e uniformemente illuminata su sfondo tinta unita offre al passaggio image-to-image la forma più chiara da preservare.
2. Immagine lifestyle (text-to-image)
Modello: qwen-image-3.0-pro/text-to-image · input: {prompt, aspect_ratio: "3:4", resolution: "1K"} · costo: $0,0497

Prompt: «Lifestyle product photography: a minimalist matte-black wireless earbuds charging case placed on a light oak wooden desk next to a small potted succulent and a closed notebook, warm natural window light from the right, shallow depth of field with soft background blur, cozy modern home-office mood, no text overlays, photorealistic, editorial e-commerce lifestyle style»
Nota che questo è un secondo rendering indipendente, non un ridisegno — vale la pena confrontarlo con il ridisegno qui sotto, che fa proseguire l'identità dello stesso prodotto tra scene diverse invece di reimmaginarla solo dal prompt.
3. Ridisegno da immagine di riferimento (image-to-image) — la capacità distintiva del livello Pro
Modello: qwen-image-3.0-pro/image-to-image · input: {prompt, image_urls: [<URL immagine principale>], resolution: "1K"} · costo: $0,0497 + $0,004 (1 immagine di riferimento) = $0,0537

Prompt: «Redraw the exact same matte-black wireless earbuds charging case from the reference image, keep its shape, color and proportions identical, but place it standing upright on a wet dark charcoal-grey stone surface outdoors at dusk, with soft cyan and violet neon reflections bleeding across the wet stone, shallow depth of field, moody editorial product photography, no text, no watermark»
Questo è il flusso di lavoro che l'immagine principale e l'immagine lifestyle da sole non possono riprodurre: la stessa custodia di ricarica del passaggio 1, portata in un moodboard completamente diverso, senza dover ridescrizionare la sua forma da zero e sperare che il rendering coincida. Per campagne stagionali che richiedono lo stesso prodotto attraverso cinque atmosfere, è il percorso più rapido e coerente — basta renderizzare una volta un'immagine di riferimento pulita e poi ridisegnarla ripetutamente.
Per altri prompt di partenza pronti da copiare, consulta le ricette di prompt text-to-image e le ricette di prompt image-to-image di questo modello.
Codice batch: generare un set di immagini in parallelo
Con un vero catalogo prodotti, non invii un'immagine alla volta. Ecco una distribuzione concorrente minima su /v1/tasks:
import requests, time
API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
jobs = [
{"model": "qwen-image-3.0-pro/text-to-image",
"input": {"prompt": hero_prompt, "aspect_ratio": "1:1", "resolution": "1K"}},
{"model": "qwen-image-3.0-pro/text-to-image",
"input": {"prompt": lifestyle_prompt, "aspect_ratio": "3:4", "resolution": "1K"}},
{"model": "qwen-image-3.0-pro/image-to-image",
"input": {"prompt": redraw_prompt, "image_urls": [hero_url], "resolution": "1K"}},
]
task_ids = [requests.post(API, headers=HEADERS, json=j).json()["data"]["taskId"] for j in jobs]
results = {}
while len(results) < len(task_ids):
for tid in task_ids:
if tid in results:
continue
data = requests.get(f"{API}/{tid}", headers=HEADERS).json()["data"]
if data["status"] == "success":
results[tid] = data["output"][0]["url"]
elif data["status"] == "fail":
results[tid] = None
time.sleep(3)
Invia tutte le attività prima, poi esegui il polling dell'intero batch — così i tempi di attesa si sovrappongono invece di pagarli uno per uno in sequenza.
Pro, base e 2.0-pro: per quali attività è adatto ciascuno
- qwen-image-3.0 base ($0,0358/immagine, prezzo unico sia per text-to-image sia per image-to-image, senza fasce di risoluzione): adatto a varianti bozza, mockup interni o qualsiasi uso non destinato alla pubblicazione. Se è tutto ciò che ti serve, consulta la guida all'API della versione base.
- qwen-image-3.0-pro (descritto in questa pagina): le fasce di risoluzione (1K/2K) e il percorso di ridisegno image-to-image sono i motivi per cui vale la pena pagare un sovrapprezzo — usalo per qualsiasi asset destinato alla pubblicazione, soprattutto per flussi di lavoro che richiedono lo stesso prodotto attraverso più scene.
- qwen-image-2.0-pro (descritto qui): resta un'opzione text-to-image affidabile per prodotti principali e per renderizzare testi promozionali, ma il suo schema è del tutto privo di campi image-to-image — se il ridisegno da riferimento è importante per il tuo catalogo, 3.0-pro è il livello che offre questa capacità.
I prezzi sopra riportati sono aggiornati a 2026-09 — prima di pianificare un budget per grandi volumi, consulta sempre la pagina dei prezzi in tempo reale, perché il prezzo per immagine può cambiare.
Domande frequenti
qwen-image-3.0-pro supporta image-to-image?
Sì — qwen-image-3.0-pro/image-to-image accetta un prompt più 1-3 immagini di riferimento passate tramite image_urls, al costo di $0,0497-$0,0993/immagine (a seconda della risoluzione), più $0,004 per ogni immagine di riferimento.
Quali risoluzioni supporta qwen-image-3.0-pro? 1K e 2K, con prezzi separati per gli endpoint text-to-image e image-to-image (rispettivamente $0,0497 e $0,0993).
Posso mantenere la forma esatta del prodotto in più scene generate? È esattamente lo scopo dell'endpoint image-to-image: genera prima un'immagine di riferimento pulita, poi ridisegnala in nuove scene con un prompt che chiede esplicitamente al modello di mantenere forma, colore e proporzioni — come mostrato nell'esempio di ridisegno sopra.
Per la fotografia di prodotto, qwen-image-3.0-pro vale di più della versione base? Se le immagini vanno consegnate a un cliente, sì — le fasce di risoluzione e l'endpoint image-to-image (assente in qwen-image-3.0 base) sono le due capacità per cui paghi il sovrapprezzo. Per bozze interne o mockup rapidi, qwen-image-3.0 base costa meno ed è sufficiente.
Punti chiave
- qwen-image-3.0-pro ha due endpoint importanti per la fotografia di prodotto:
text-to-imageper nuovi rendering,image-to-imageper ridisegnare foto prodotto esistenti in nuove scene mantenendone l'identità. - Il ridisegno image-to-image — non solo un output text-to-image più fine — è il flusso di lavoro che distingue questo livello da qwen-image-3.0 base e qwen-image-2.0-pro, nessuno dei quali offre editing di immagini basato su riferimento.
- Prezzi (2026-09): $0,0497/immagine a 1K, $0,0993/immagine a 2K, stesso prezzo per entrambi gli endpoint; image-to-image costa $0,004 in più per ogni immagine di riferimento (supporta 1-3).
- Per cataloghi che richiedono lo stesso prodotto attraverso più scene o atmosfere, genera una volta un'immagine di riferimento pulita e ridisegnala ripetutamente — è più veloce che riscrivere i prompt ogni volta e garantisce una coerenza del prodotto più stabile.
Articoli correlati
Vedi tutti gli articoli →-
Guida all'uso
Guida introduttiva a seedream-5.0-pro/image-to-image: capacità, prezzi e punti chiave di integrazione
Limiti di capacità, modalità di fatturazione e pratiche di integrazione ingegneristica del modello di editing immagini di ByteDance
-
Guida all'uso
Guida pratica al text-to-image con seedream-5.0-pro: limiti di capacità, integrazione API e controllo dei costi
Prospettiva operativa per sviluppatori: dai punti chiave sui parametri alla stima di costo di $0,05 per immagine
-
Guida all'uso
Guida introduttiva a Hailuo 2.3 Fast image-to-video: limiti delle capacità, prezzi e pratiche di integrazione
Selezione e integrazione del modello MiniMax image-to-video per sviluppatori