Immagini prodotto e-commerce con Recraft V4.1 Flash: immagini catalogo in batch a $0,01 ciascuna

TL;DR

• Su HiAPI, recraft-v4.1-flash/text-to-image costa solo $0,01 per immagine, quindi 1.000 immagini di catalogo costano $10,00. La versione standard recraft-v4.1/text-to-image costa $0,05 per immagine e accetta gli stessi parametri (confronto prezzi).
• Nella nostra esecuzione, le 4 immagini prodotto inviate in parallelo sono state completate in 21,5 secondi di tempo reale, circa 19–20 secondi per ciascun task (incluso il download). Costo totale: $0,04.
• Impostando background_color su bianco, lo sfondo generato è quasi bianco ma non un #FFFFFF uniforme. Se il marketplace richiede il bianco puro, è necessario un passaggio di pulizia aggiuntivo.

Quando scegliere il tier Flash per il catalogo

Usa Flash quando il volume è elevato: ogni SKU necessita di un'immagine di listino su sfondo bianco, più una o due immagini contestuali, e prevedi di revisionare ciascuna prima della pubblicazione. A $0,01 per immagine, 500 SKU con 3 immagini ciascuno costano $15,00 in totale. Le stesse 1.500 immagini con la versione standard V4.1 costerebbero $75,00.

Flash e la versione standard V4.1 accettano gli stessi campi di input, quindi promuovere le immagini selezionate a un tier superiore richiede solo di cambiare model. Questo articolo non confronta la qualità delle immagini dei due tier, perché non li abbiamo eseguiti separatamente con prompt corrispondenti. Prima di decidere quale tier usare per gli asset finali, controlla tu stesso gli output.

Schema di input verificato

Abbiamo verificato lo schema rispetto all'API live inviando valori volutamente non validi:

Campo	Tipo	Note
prompt	string	obbligatorio
image_size	enum	square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
colors	array di {r,g,b}	Guida della palette. Passare una stringa restituisce 400 INVALID_REQUEST: colors: got string, want array
background_color	{r,g,b}	Colore di sfondo

I campi sconosciuti vengono rifiutati (additional properties ... not allowed) e qualsiasi image_size al di fuori dei sei preset viene rifiutato. Le dimensioni personalizzate in pixel non sono supportate. Le dimensioni ottenute: square_hd 1024×1024, portrait_4_3 896×1216, landscape_4_3 1216×896.

Output reali di un batch

Le quattro immagini seguenti provengono tutte dallo stesso batch parallelo. Le didascalie indicano le dimensioni; ogni immagine costa $0,01.

Immagine di listino su sfondo bianco

E-commerce product photo of a matte sage-green ceramic coffee mug with a curved handle, centered, front three-quarter view, pure white seamless background, soft even studio lighting, gentle contact shadow, no props, no text

recraft-v4.1-flash/text-to-image, square_hd, 1024×1024, background_color bianco, $0,01.

E-commerce product photo of a single white leather low-top sneaker with gum rubber sole, side profile facing left, pure white seamless background, soft even studio lighting, subtle shadow under the sole, no props, no text

recraft-v4.1-flash/text-to-image, square_hd, 1024×1024, background_color bianco, $0,01.

La tazza corrisponde fedelmente al prompt: centrata, ombra di contatto pulita, nessun oggetto di scena. La sneaker mostra perché serve ancora una revisione. Avevamo richiesto una suola in gomma naturale (gum rubber sole), ma abbiamo ottenuto una suola color crema, e la scarpa si trova nella metà inferiore dell'inquadratura anziché centrata. Senza un confronto con il prodotto reale, nessuna delle due immagini è utilizzabile come immagine di listino per uno SKU reale.

Immagini di scena

Lifestyle product photo of an amber glass dropper serum bottle with a plain white label, standing on a travertine stone tray beside a eucalyptus sprig, bathroom shelf, soft morning window light, shallow depth of field, premium skincare catalog look

recraft-v4.1-flash/text-to-image, portrait_4_3, 896×1216, $0,01.

Lifestyle product photo of a charcoal canvas rolltop backpack leaning against a wooden bench in a sunlit train station, warm afternoon light, shallow depth of field, travel catalog look, no people, no logos

recraft-v4.1-flash/text-to-image, landscape_4_3, 1216×896, $0,01.

Entrambe le scene includono tutti gli oggetti di scena e gli indizi di illuminazione dei rispettivi prompt. L'etichetta del flacone di siero è vuota come richiesto. Utile se in seguito prevedi di sovrapporre un'etichetta reale, e più sicuro che lasciare che il modello inventi del testo.

Cosa restituisce effettivamente lo "sfondo bianco"

Abbiamo campionato i pixel delle due immagini di listino:

Immagine	Campioni angoli / bordi (RGB)	Esattamente 255,255,255	Quasi bianco (tutti i canali ≥ 250)
Tazza	255,255,255 · 255,255,253 · 253,254,252	48,1% dei pixel	75,4%
Sneaker	254,253,253 · 251,250,249 · 255,255,255	58,3% dei pixel	79,3%

Lo sfondo appare bianco, ma non è un #FFFFFF piatto e uniforme. I marketplace che richiedono il bianco puro per le immagini principali necessitano di un passaggio di post-elaborazione. Puoi forzare i pixel quasi bianchi a 255, oppure ritagliare il prodotto e posizionarlo su una tela pulita. La guida alla rimozione dello sfondo di Recraft illustra la soluzione di scontorno sulla stessa API.

Script batch: invio parallelo, polling, download

Questo è lo script che abbiamo eseguito, semplificato. Ogni SKU ha il proprio Idempotency-Key, così i tentativi dopo un timeout di rete non creano task a pagamento duplicati. Gli URL di output sono temporanei: i nostri URL si trovano su temp.hiapi.ai e hanno un expireAt che scade esattamente 7 giorni dopo la creazione. Scarica ogni immagine il prima possibile dopo il successo del task.

import os, time, requests
from concurrent.futures import ThreadPoolExecutor

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}",
           "Content-Type": "application/json"}
WHITE = {"r": 255, "g": 255, "b": 255}
BATCH_ID = "catalog-2026-11-01"  # change per intentional new batch

JOBS = [
    {"sku": "mug-sage", "image_size": "square_hd", "background_color": WHITE,
     "prompt": "E-commerce product photo of a matte sage-green ceramic coffee mug ..."},
    {"sku": "serum-amber", "image_size": "portrait_4_3",
     "prompt": "Lifestyle product photo of an amber glass dropper serum bottle ..."},
    # one dict per SKU / shot
]

def run(job):
    payload = {"model": "recraft-v4.1-flash/text-to-image",
               "input": {k: v for k, v in job.items() if k != "sku"}}
    r = requests.post(BASE, json=payload, timeout=60,
                      headers={**HEADERS, "Idempotency-Key": f"{BATCH_ID}-{job['sku']}"})
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    while True:
        task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if task["status"] in ("success", "fail", "failed"):
            break
        time.sleep(3)
    if task["status"] != "success":
        return job["sku"], task["status"]
    img = requests.get(task["output"][0]["url"], timeout=60).content
    with open(f"{job['sku']}.webp", "wb") as f:  # output was WebP in our run
        f.write(img)
    return job["sku"], "saved"

with ThreadPoolExecutor(max_workers=4) as pool:
    for sku, status in pool.map(run, JOBS):
        print(sku, status)

La nostra esecuzione ha restituito quanto segue per ogni task (ne mostriamo uno solo):

{
  "taskId": "tk-hiapi-01M6AMTSX0B7Z531QT740DS54P",
  "model": "recraft-v4.1-flash/text-to-image",
  "status": "success",
  "storage": "temp",
  "output": [{"type": "image", "url": "https://temp.hiapi.ai/.../...-0.webp", "expireAt": 1794111048}]
}

I timestamp created e completed di quel task differiscono di 9 secondi. Il tempo rimanente lato client serve per l'intervallo di polling e il download dei file WebP da 0,45–1,26 MB. Per tutti i dettagli su richieste e polling, consulta la guida all'API di Recraft V4.1 e la documentazione di HiAPI.

Budget del catalogo

Immagini per SKU	100 SKU	1.000 SKU
1 (solo immagine di listino)	$1,00	$10,00
3 (immagine di listino + 2 immagini di scena)	$3,00	$30,00
3 + 2 rigenerazioni	$5,00	$50,00

Basato su Flash a $0,01 per immagine, con il listino HiAPI del 1 novembre 2026. Le rigenerazioni sono fatturate come qualsiasi altra immagine, quindi riserva una parte del budget.

Schemi di prompt per le immagini di listino

• Inizia con il tipo di scatto (E-commerce product photo of ...), poi materiale + colore + prodotto.
• Fissa l'angolo di ripresa (front three-quarter view, side profile facing left).
• Indica esplicitamente sfondo e illuminazione (pure white seamless background, soft even studio lighting), e passa anche background_color.
• Termina con le esclusioni: no props, no text.
• Verifica i dettagli specifici del prodotto rispetto all'oggetto reale. Il colore della suola della sneaker indica che il modello può sbagliare su questi dettagli.

Domande frequenti

Flash è sufficiente per le immagini principali del listino? Per prodotti semplici come la tazza, l'output è pulito. Ma i dettagli possono sbagliare (come la suola della sneaker) e lo sfondo non è un #FFFFFF puro. Controlla ogni immagine e, se il marketplace lo richiede, pulisci lo sfondo.

Posso mantenere coerenti i colori del brand in un batch? Sì. Passa lo stesso array colors in ogni richiesta. Guida la palette, ma non è un blocco del colore a livello di pixel.

Come promuovo le immagini selezionate alla versione standard V4.1? Reinvia lo stesso payload impostando model su recraft-v4.1/text-to-image, a $0,05 per immagine.

Questo genera il mio prodotto reale? No. Il text-to-image crea un prodotto che corrisponde alla tua descrizione. Per mostrare l'oggetto reale, usa la scena generata come sfondo o mockup, oppure passa a un flusso di lavoro image-to-image.

Pronto a redigere il catalogo? Apri la pagina del modello Recraft V4.1 Flash, prova prima un prompt per l'immagine di listino, poi esegui lo script batch per gli altri SKU.