HiAPI
Blog

Guida all'uso

Seedream 5.0 Pro fotografia di prodotto per e-commerce: workflow text-to-image

Genera immagini principali, banner promozionali e flat lay di prodotto partendo solo da un prompt testuale

Aug 3, 2026
Seedream 5.0 Pro fotografia di prodotto per e-commerce: workflow text-to-image

La maggior parte dei workflow di fotografia di prodotto inizia con una fotocamera. Questo invece inizia con un prompt testuale — saltando completamente studio, modelli e scatti da rifare.

In sintesi

  • L'endpoint text-to-image di Seedream 5.0 Pro genera, partendo solo da una descrizione testuale, scene di prodotto pronte per l'e-commerce — primi piani del prodotto per l'immagine principale, banner promozionali con testo renderizzato, flat lay stilizzati — senza bisogno di una foto di partenza.
  • Il rendering del testo è un vero punto di forza: il copy del banner esce pulito e leggibile già alla prima generazione, senza bisogno di rigenerare.
  • Il prezzo è a scaglioni per risoluzione: $0.05/immagine a 1K, $0.10/immagine a 2K.
  • Il modello accetta solo 8 rapporti d'aspetto fissi — 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 — verificati tramite API reale, non sulla base della documentazione.
  • Se parti da una foto di prodotto esistente invece che da una pagina bianca, usa la modalità image-to-image di Seedream 5.0 Pro — questo articolo tratta specificamente di come generare nuove scene da zero.

Perché generare le immagini di prodotto invece di fotografarle

Ogni pagina prodotto ha bisogno di almeno tre tipi di immagini: un'immagine principale pulita, un banner promozionale per la campagna in corso e un'immagine lifestyle o flat lay per i social e le griglie dei marketplace. Fotografare tutte e tre per ogni SKU significa prenotare uno studio, preparare oggetti di scena, allestire le luci e fare un giro di post-produzione — immagini che poi vanno rifatte alla stagione successiva.

La modalità text-to-image di Seedream 5.0 Pro tratta l'intero set di immagini come un problema di prompt, non di produzione. Descrivi il prodotto, la superficie su cui poggia, la luce e l'atmosfera — e il modello renderizza l'immagine finita, incluso qualsiasi testo da sovrapporre necessario per i banner. Nessuna foto di partenza e nessuna di quelle texture «sembra generato dall'AI» che ogni tanto comparivano nei modelli precedenti — la fedeltà è proprio il motivo per cui questo modello appartiene al livello Pro e non al Lite entry-level.

Questo è un workflow che parte da zero. Se hai già una foto di prodotto reale e vuoi inserirla in una nuova scena o sostituirne lo sfondo, si tratta di un'attività image-to-image — consulta l'articolo complementare sui prompt image-to-image di Seedream 5.0 Pro per l'altra metà del workflow.

Configurazione

Seedream 5.0 Pro gira sull'API unificata di task asincroni di hiapi. Ogni richiesta segue la stessa struttura in tre passaggi: invia il task, esegui il polling fino al completamento, scarica l'output.

import requests
import time

API_KEY = "YOUR_HIAPI_KEY"
BASE = "https://api.hiapi.ai/v1/tasks"

def generate(prompt: str, aspect_ratio: str = "1:1", resolution: str = "1K") -> str:
    resp = requests.post(
        BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "seedream-5.0-pro/text-to-image",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
            },
        },
    ).json()
    task_id = resp["data"]["taskId"]

    while True:
        task = requests.get(f"{BASE}/{task_id}", headers={"Authorization": f"Bearer {API_KEY}"}).json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(task["error"])
        time.sleep(5)

image_url = generate("your prompt here", aspect_ratio="1:1", resolution="1K")

A parte la stringa model e i campi input, qui non c'è nulla di specifico di Seedream — la struttura invio/polling/download è identica per tutti i modelli della piattaforma.

I tre elementi che servono a ogni pagina prodotto

Per questo articolo abbiamo generato tre immagini reali, con tre rapporti d'aspetto diversi, che coprono le tre attività di cui una pagina prodotto ha effettivamente bisogno. Ogni prompt qui sotto è il testo esatto che abbiamo inviato, senza modifiche — se cerchi un punto di partenza, puoi copiarlo direttamente.

1. Primo piano del prodotto per l'immagine principale

L'immagine predefinita che serve a ogni pagina prodotto: il prodotto centrato, sfondo pulito, nessun elemento che distragga.

Fotografia di prodotto: flacone di siero in vetro ambra opaco con tappo contagocce dorato spazzolato, appoggiato su una base in pietra beige levigata. Luce da studio morbida in alto a sinistra, ombra delicata sotto il flacone. Due piccoli rametti di eucalipto appoggiati accanto alla base. Sfondo crema morbido senza giunture, ampio spazio vuoto minimalista, profondità di campo ridotta, immagine di prodotto e-commerce di fascia alta, senza testo, senza loghi, fotorealistico, composizione quadrata 1:1.

La base in pietra e i rametti di eucalipto sono dettagli inventati nel prompt — non compositati in post-produzione — e l'ombra cade correttamente sotto il profilo reale del flacone, senza sembrare incollata. Questa coerenza fisica è ciò che distingue un primo piano di prodotto utilizzabile da un collage palesemente sintetico.

2. Banner promozionale (con testo renderizzato)

Questo è ciò che mette davvero alla prova il «Pro» di Seedream 5.0 Pro: il copy promozionale del banner deve essere impresso nell'immagine come testo reale e leggibile, non aggiunto a posteriori in uno strumento di design.

Banner promozionale per siero skincare a tema autunnale. Terzo sinistro dell'immagine: lo stesso flacone di siero in vetro ambra con tappo contagocce dorato, appoggiato su una pila di libri rilegati arancioni, con qualche foglia d'acero sparsa intorno alla base, tonalità autunnali calde. Due terzi destri dell'immagine: titolo ben visibile in marrone "AUTUMN GLOW SALE", con font serif pulito, e sotto un testo più piccolo "Save 20% This Week Only". Sfondo crema caldo e arancio bruciato, luce da studio morbida, layout da banner promozionale e-commerce, formato panoramico, testo renderizzato nitido e leggibile, stile fotografia di prodotto fotorealistica.

Entrambe le righe di copy sono scritte correttamente e con spaziatura uniforme già alla prima generazione — nessuna lettera mancante, nessun carattere deformato. Detto questo: prima di pubblicare, controlla sempre carattere per carattere il testo renderizzato. Il rendering del testo nei modelli di immagine è molto buono, ma non infallibile, e un singolo carattere errato in un banner sconti è esattamente il tipo di errore che i clienti notano davvero. Se il risultato contiene un refuso, la soluzione è rieseguire lo stesso prompt, non mettere mano a uno strumento di design.

3. Flat lay stilizzato

Per le griglie dei marketplace e i post social, un primo piano di prodotto didascalico tende a risultare piatto. Un flat lay stilizzato con oggetti di scena dà allo stesso prodotto un contesto lifestyle senza servizio fotografico reale.

Fotografia di prodotto flat lay dall'alto: vasetto cosmetico rosa con coperchio bianco, accompagnato da un fiore di orchidea bianca, un piccolo cristallo di quarzo rosa e un asciugamano crema piegato, disposti su una superficie in lino grigio chiaro. Luce zenitale morbida e uniforme, ombre minime, estetica beauty leggera e pulita, senza testo, senza loghi, fotorealistico, composizione verticale 3:4.

Nota che qui il prodotto è diverso (un vasetto cosmetico invece del flacone di siero) — il valore del formato flat lay è che si può riutilizzare su tutto il catalogo, senza legarlo a uno SKU specifico. Cambia la descrizione del prodotto e gli oggetti di scena, e lo stesso stile di composizione funziona per articoli completamente diversi.

Schema di input (verificato tramite API reale)

La documentazione generica elenca un insieme più ampio di rapporti d'aspetto supportati, ma l'endpoint text-to-image effettivo di Seedream 5.0 Pro è più restrittivo. Lo abbiamo sondato direttamente, invece di fidarci dello schema generico:

Campo Tipo Note
prompt string obbligatorio
aspect_ratio string uno tra 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 — 4:5 e 5:4 vengono rifiutati, nonostante compaiano nella documentazione generica
resolution string 1K o 2K

Se invii 4:5 o 5:4, aspettati un 400. Per ritagli di prodotto quasi quadrati, usa 4:3/3:4 come alternativa supportata più vicina.

Prezzi: 1K e 2K, Pro e Lite

I prezzi seguenti provengono direttamente dall'endpoint prezzi in tempo reale di hiapi, validi al 2026-08.

Modello Modalità Risoluzione Prezzo
Seedream 5.0 Pro text-to-image 1K $0.05/immagine
Seedream 5.0 Pro text-to-image 2K $0.10/immagine
Seedream 5.0 Lite text-to-image — $0.035/immagine

Le tre immagini di questo articolo sono state generate tutte a 1K, $0.05 ciascuna — un set completo immagine principale/banner/flat lay per $0.15 in totale.

Il livello Lite costa meno per immagine, ma il divario che conta davvero non è la differenza di $0.015 — sono il rendering del testo e i dettagli. Se le tue immagini richiedono copy leggibile sovrapposto (banner, etichette, annotazioni), Pro è il livello che scrive le lettere correttamente in modo affidabile. Se generi sfondi semplici o immagini lifestyle che non richiedono testo, Lite è un punto di partenza ragionevole per ridurre i costi. Consulta il nostro workflow e-commerce con Seedream 5.0 Lite per un confronto concreto.

Consigli sui prompt che incidono davvero sull'output

  • Definisci la superficie, non solo il prodotto. «Base in pietra», «superficie in lino», «una pila di libri rilegati» — questi dettagli di ancoraggio fanno sì che ombre e luce si comportino correttamente. Un prompt con solo il prodotto e nessuna superficie tende a far sembrare il prodotto sospeso.
  • Metti il testo tra virgolette letterali. "AUTUMN GLOW SALE" viene renderizzato in modo più affidabile che descrivendo l'atmosfera senza citare la stringa esatta. Le virgolette sembrano dire al modello «questo è testo letterale», non solo un'atmosfera.
  • Specifica il rapporto d'aspetto che userai davvero, non ritagliare dopo. Comporre in 1:1 e poi ritagliare in 3:4 taglia il prodotto. Genera nel rapporto richiesto dal template della pagina prodotto.
  • Sulle immagini senza testo, scrivi esplicitamente «senza testo, senza loghi». Senza questa istruzione, le immagini di prodotto a volte tirano fuori marchi inventati o testo in stile filigrana negli angoli.
  • Riusa il linguaggio descrittivo di superfici e oggetti di scena lungo la linea di prodotto. Nei primi test, la stessa formulazione «base in pietra beige, luce da studio morbida» ha prodotto un aspetto coerente su flaconi diversi — utile se stai costruendo un catalogo e vuoi coerenza visiva senza un set fisico condiviso.

Domande frequenti

Seedream 5.0 Pro può generare più angolazioni di un prodotto con un solo prompt? No — ogni richiesta restituisce un'immagine per task. Per un set multi-angolazione (frontale, tre quarti, dall'alto), invia prompt separati che descrivano esplicitamente ciascuna angolazione.

Supporta sfondi trasparenti per immagini di prodotto ritagliabili? L'endpoint text-to-image restituisce una scena renderizzata, non un canale alfa. Per un ritaglio pulito e isolato, chiedi uno sfondo a tinta unita senza giunture (come nell'immagine principale qui sopra), invece di aspettarti trasparenza alpha.

E se ho già una foto reale del prodotto? Usa image-to-image invece di text-to-image — quella modalità modifica o riprogetta una foto esistente, invece di generare una nuova foto da una descrizione. Consulta la guida ai prompt image-to-image di Seedream 5.0 Pro.

Per una pagina prodotto e-commerce, vale la pena spendere di più per la risoluzione 2K? La maggior parte dei marketplace e dei template di negozio riduce le immagini a dimensioni molto inferiori a 2K in fase di visualizzazione, quindi 1K di solito basta e costa la metà. Il 2K vale la pena solo se devi ritagliare strettamente una zona dell'immagine dopo la generazione, o se la piattaforma richiede file sorgente di grandi dimensioni.

Perché il testo renderizzato è corretto al primo colpo — è garantito? No. La qualità del rendering del testo di questo modello è complessivamente elevata, ma non affidabile al 100% — considera ogni immagine renderizzata con testo sovrapposto una bozza da rileggere manualmente prima di pubblicarla, come abbiamo fatto con il banner qui sopra.

Conclusione

Per un catalogo che ha bisogno di un flusso costante di immagini principali, banner promozionali e flat lay lifestyle senza prenotare uno studio per ogni aggiornamento di SKU, generare da un prompt testuale è davvero un ciclo più rapido rispetto a fotografare e fare post-produzione — e il rendering del testo di Seedream 5.0 Pro rende praticabile proprio lo scenario dei banner promozionali, cosa che i modelli più deboli non riescono a fare. Se vuoi vedere il set completo di parametri e provarlo con la descrizione del tuo prodotto, la pagina del modello Seedream 5.0 Pro offre una modalità live con generazioni di prova eseguibili direttamente.

Inizia a creare con artefatti IA persistenti

Ottieni la tua chiave API e chiama modelli di immagini, video e audio tramite un'unica API basata sui task.

Leggi la documentazione API