Qwen Image 2.0 Pro fotografia di prodotti e-commerce: workflow API hiapi

TL;DR

• Cos'è: un workflow di produzione e-commerce reale che utilizza qwen-image-2.0-pro tramite l'API hiapi — un'immagine hero del prodotto, un banner promozionale con testo promozionale renderizzato e una griglia di varianti, tutti generati con i prompt e le richieste esatti mostrati in questa pagina.
• Perché scegliere il tier Pro per il lavoro sui prodotti: dettagli fotorealistici più fini, rendering del testo nell'immagine più affidabile (testo promozionale reale, non caratteri illeggibili) e migliore aderenza semantica ai prompt dettagliati — al prezzo di $0.107/immagine, fino a 2048×2048, rispetto al tier base qwen-image-2.0 a $0.025/immagine (prezzi).
• Fatti verificati sull'API: lo schema di input accetta un prompt e una stringa size ("2048*2048", "2688*1536", "2368*1728", "1728*2368" o "1536*2688") — nessun campo aspect_ratio, e solo text-to-image (nessun image_input / i2i).
• Workflow: invia in parallelo un task per ogni asset tramite /v1/tasks, esegui il polling di ciascuno fino al completamento, scarica subito output[0].url (scade), poi ricontrolla il testo renderizzato prima di qualsiasi consegna dei contenuti.

Perché scegliere qwen-image-2.0-pro per la fotografia di prodotti

Una scheda prodotto di solito richiede tre asset diversi, che devono sembrare parte della stessa sessione fotografica: un'immagine hero pulita per la pagina di listing, un banner promozionale con testo promozionale reale per le campagne marketing, e una griglia di varianti per le pagine di catalogo multi-SKU. È una superficie di lavoro più ampia rispetto a una singola immagine hero, ed è qui che il tier Pro giustifica il suo sovrapprezzo rispetto al base qwen-image-2.0:

• Dettagli fotorealistici più fini. Vetro, metallo spazzolato, pietra — i dettagli delle luci speculari in questa categoria si leggono come "foto reale" e non come "render" anche alla dimensione delle miniature di catalogo.
• Rendering del testo più affidabile. Banner promozionali e confezioni richiedono che il testo esatto finisca nell'immagine, scritto correttamente e con spaziatura pulita. Il tier Pro è ottimizzato per questo; il banner più sotto in questa pagina ne è un esempio non ritoccato.
• Migliore aderenza semantica. I tre prompt di questa pagina sono lunghi e specifici su superfici, luci e layout — il tier Pro li ha seguiti tutti scrupolosamente, comprese le istruzioni "nessun testo" su due delle immagini.

Il costo è il prezzo: $0.107/immagine rispetto a $0.025 del tier base (prezzi verificati in tempo reale, 2026-08). Per una singola immagine hero è solo un errore di arrotondamento. Per un catalogo di centinaia di SKU sono soldi veri — per come distribuire il lavoro tra i due, vedi la sezione Pro vs tier base più sotto.

Configurazione

Ti serve solo una chiave API hiapi, nient'altro — nessun SDK:

export HIAPI_API_KEY="sk-..."

qwen-image-2.0-pro funziona tramite l'endpoint unificato per task asincroni: POST https://api.hiapi.ai/v1/tasks restituisce immediatamente un taskId, poi esegui il polling di GET /v1/tasks/{taskId} finché non è completato.

I tre asset che servono a ogni scheda prodotto

1. Immagine hero del prodotto

Immagine per la pagina di listing: prodotto singolo, centrato, sfondo pulito, niente che rubi l'attenzione. Prompt completo, identico a quello inviato:

Studio product photograph of a single amber glass skincare dropper bottle with a blank matte white label, standing centered on a round travertine stone pedestal, seamless warm off-white studio background, soft diffused key light from the upper left, a subtle soft shadow falling to the right, hyper-detailed macro texture on the glass and brushed-metal dropper cap, photorealistic, catalog-ready e-commerce hero shot, no text, no logos, no props

2. Banner promozionale con testo renderizzato

È qui che entra in gioco il rendering del testo del tier Pro. Il prompt chiede due righe di testo promozionale specifico in angoli precisi — nessun testo segnaposto, nessun "inserisci qui il tuo testo":

Flat-lay e-commerce promo banner photograph: three amber glass skincare dropper bottles arranged diagonally on a warm terracotta backdrop with dried eucalyptus sprigs, soft overhead studio lighting with gentle shadows, in the upper right corner bold clean white sans-serif text reading SUMMER GLOW SALE, directly beneath it smaller white text reading SAVE 20% TODAY, no other text anywhere, photorealistic commercial photography, sharp focus

Secondo il manuale operativo dei contenuti di hiapi, il testo renderizzato non va mai consegnato senza una rilettura umana — il rendering del testo AI è affidabile ma non infallibile, e ogni tanto una lettera mancante o un errore di spaziatura salta fuori solo al controllo. Questo banner è stato verificato carattere per carattere rispetto al prompt prima di essere pubblicato in questa pagina.

3. Griglia di varianti

Per le pagine di catalogo che elencano ogni formato o fragranza, una griglia piatta mantiene ogni variante visivamente coerente:

Overhead flat-lay product grid photograph of six amber glass skincare dropper bottles with blank matte white labels, arranged in two neat rows of three on a light grey seamless studio background, even soft diffused lighting with minimal shadows, consistent spacing between bottles, photorealistic catalog variant-grid layout, no text, no logos

Nota le etichette vuote su tutte e tre le immagini — le etichette per SKU (nome del brand, fragranza, formato) sono testo piccolo su una superficie piccola, un obiettivo di rendering più difficile rispetto al titolo del banner. Il pattern pratico: generare i flaconi con etichette vuote, poi comporre il testo dell'etichetta in post-produzione. Ed è anche più rapido da aggiornare quando cambiano i prezzi promozionali.

Schema di input, verificato rispetto all'API live

Lo schema di /v1/tasks per qwen-image-2.0-pro è più rigido di quanto sembri — niente aspect_ratio, niente n, e nessun campo di input immagine:

Campo	Tipo	Obbligatorio	Valori
prompt	string	✅	la tua descrizione della scena
size	string	✅	2048*2048, 2688*1536, 2368*1728, 1728*2368, 1536*2688
negative_prompt	string	opzionale	cosa escludere
seed	integer	opzionale	per la riproducibilità
watermark	boolean	opzionale
prompt_extend	boolean	opzionale	lascia che il modello espanda prompt brevi

Due cose da notare per chi porta richieste da altri modelli immagine hiapi: qui non c'è il parametro aspect_ratio (usa direttamente size), e questo modello è solo text-to-image — nessun campo per immagini di riferimento, quindi non puoi dargli una foto del tuo prodotto reale e chiedergli delle varianti. Il controllo tramite prompt è l'unico strumento a disposizione. La struttura completa di richiesta/risposta ed esempi di errori sono nel tutorial API; questa pagina si concentra sul caso d'uso e-commerce.

Script batch: tre asset, un unico ciclo di invio

Poiché /v1/tasks è asincrono, generare l'immagine hero, il banner e la griglia significa solo tre invii più tre polling — senza attese sequenziali:

import time
import requests

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}

def submit(prompt: str, size: str) -> str:
    r = requests.post(API, headers=HEADERS, json={
        "model": "qwen-image-2.0-pro",
        "input": {"prompt": prompt, "size": size},
    }, timeout=60)
    task_id = (r.json().get("data") or {}).get("taskId")
    if not task_id:
        raise RuntimeError(f"submit failed: {r.text}")
    return task_id

def wait(task_id: str, timeout_s: int = 600) -> dict:
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        task = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if task["status"] == "success":
            return task
        if task["status"] == "fail":
            raise RuntimeError(f"task failed: {task.get('error')}")
        time.sleep(5)
    raise TimeoutError(task_id)

jobs = [
    ("hero-packshot", "Studio product photograph of ...", "2048*2048"),
    ("promo-banner",  "Flat-lay e-commerce promo banner ...", "2688*1536"),
    ("variant-grid",  "Overhead flat-lay product grid ...", "2368*1728"),
]

task_ids = {name: submit(prompt, size) for name, prompt, size in jobs}   # fan out
for name, task_id in task_ids.items():                                    # collect
    result = wait(task_id)
    url = result["output"][0]["url"]           # expires — download immediately
    open(f"{name}.png", "wb").write(requests.get(url, timeout=120).content)

Nei test, il rendering di ogni immagine a circa 2000px di lato ha richiesto più o meno un minuto; in caso di carico elevato, prevedi qualche minuto per immagine prima di considerarla in timeout.

Pro vs tier base: quale usare

I due tier condividono lo stesso schema prompt + size, quindi passare dall'uno all'altro richiede solo di cambiare il campo model:

	qwen-image-2.0 (base)	qwen-image-2.0-pro
Prezzo	$0.025/immagine	$0.107/immagine
Dimensione massima	2048×2048	2048×2048
Rendering del testo	Buono	Più forte — scelta predefinita per il testo promozionale
Dettagli fotorealistici	Buoni	Più fini — scelta predefinita per le immagini hero
Ideale per	Esplorazione dei prompt, bozze in grande volume, render interni	Asset hero/banner finali, qualsiasi contenuto con testo renderizzato

La distribuzione pratica per un catalogo reale: abbozza le composizioni sul tier base, dove un ciclo di iterazione costa poco, poi renderizza di nuovo i vincitori sul tier Pro per gli asset effettivamente consegnati. Il workflow del tier base — stessa API di task, stesso stile di prompt — è in Generare immagini di prodotti e-commerce con qwen-image-2.0.

Consigli sui prompt per foto di prodotto

Cosa ha funzionato costantemente in questi tre render:

• Specifica superfici e luci, non solo il soggetto. "Piedistallo in travertino", "luce principale morbida e diffusa dall'alto a sinistra" contribuiscono al fotorealismo più di aggettivi come "professionale" o "alta qualità".
• Dichiara "nessun testo, nessun logo" sulle immagini che non devono averne. Se non lo specifichi, i prompt per foto di prodotto a volte includono tracce di etichette indesiderate; un vincolo negativo esplicito mantiene pulita l'immagine del prodotto.
• Scrivi il testo esatto per i banner tra virgolette. "Testo bianco sans-serif in grassetto e pulito che recita SUMMER GLOW SALE" viene renderizzato con precisione; un più vago "un po' di testo promozionale" lascia la formulazione al caso.
• Richiedi etichette vuote sulle confezioni, non testo minuscolo del brand. Il testo su superfici piccole è l'obiettivo di rendering più difficile per qualsiasi modello di immagine — componilo invece in post-produzione.

FAQ

Posso dare in input a qwen-image-2.0-pro una foto del mio prodotto reale per generare varianti? No — questo modello è solo text-to-image, e il suo schema non ha campi di input immagine. Per i workflow image-to-image ti serve un altro modello su hiapi che supporti esplicitamente i2i.

Il testo renderizzato è abbastanza affidabile da consegnarlo senza controllo? No — è affidabile, ma non perfetto. Leggi carattere per carattere confrontandolo con il prompt prima di pubblicare, e rigenera in caso di rari errori. Vedi la nota sotto il banner promozionale più sopra.

Quali dimensioni usare per l'immagine hero del listing e per il banner? Il quadrato 2048*2048 copre i requisiti di listing della maggior parte dei marketplace. Per banner promozionali larghi o caroselli hero, 2688*1536 o 2368*1728 (orizzontale/verticale) si avvicinano di più alle proporzioni comuni dei banner web, senza bisogno di ritagli in post-produzione.

Il tier Pro offre sconti sul volume? No — il prezzo è fisso a $0.107 per immagine, indipendentemente dal volume; la leva sui costi è quante immagini generi, non una tariffa a volume.

In sintesi

Per i cataloghi e-commerce, i vantaggi di qwen-image-2.0-pro rispetto al tier base cadono esattamente dove serve alla fotografia di prodotto: dettagli fotorealistici più puliti per le immagini hero, rendering del testo affidabile per i banner promozionali, a un prezzo ancora contenuto di $0.107/immagine. Invia in parallelo le richieste per immagine hero, banner e griglia di varianti tramite /v1/tasks, correggi qualsiasi contenuto con testo renderizzato prima della consegna, e passa al tier base quando stai iterando sulle composizioni anziché consegnando gli asset finali. La pagina del modello qwen-image-2.0-pro ha prezzi in tempo reale e il riferimento dei parametri per continuare da qui.