Generare immagini di prodotto e-commerce con hiapi API e seedream-4.5/text-to-image

Non ogni immagine di prodotto nasce da una fotografia. Prima che esista un campione, prima di organizzare un servizio fotografico, o quando una promozione stagionale richiede un banner per domani mattina, serve generare un'immagine partendo solo da una descrizione testuale — un render pulito del prodotto, una scena lifestyle, una grafica promozionale con un titolo leggibile e nitido.

seedream-4.5/text-to-image è pensato proprio per questo scenario zero-shot. Gli si fornisce una descrizione in linguaggio naturale e restituisce un'immagine fotorealistica, senza alcuna foto di riferimento — incluso testo accurato all'interno dell'immagine, la parte su cui la maggior parte dei modelli text-to-image sbaglia ancora. Su hiapi funziona tramite lo stesso endpoint asincrono /v1/tasks di tutti gli altri modelli, al prezzo di $0,045 per immagine, con risoluzione 2K o 4K.

I due esempi seguenti sono chiamate API reali, con i rispettivi prompt esatti e le immagini generate — senza alcuna modifica successiva.

Generazione zero-shot vs. modifica di foto reali

seedream-4.5 è rilasciato in due modelli con compiti diversi:

• seedream-4.5/text-to-image (oggetto di questo articolo) genera immagini da una descrizione, senza foto in input. Usalo quando il prodotto non ha ancora una foto di riferimento pulita, quando serve una scena o un concept che non esiste in catalogo, o quando il deliverable è grafica di marketing anziché la foto di un prodotto fisico specifico.
• seedream-4.5/image-to-image modifica le foto di prodotto reali che già possiedi, conservandone forma esatta e identità di brand, cambiando sfondo o contesto — per questo workflow consulta la guida e-commerce image-to-image.

Se devi mantenere una coerenza pixel-perfect con uno SKU fisico, usa il modello di modifica. Se devi generare qualcosa di completamente nuovo — un render concettuale, un banner stagionale, una scena che ancora non esiste — text-to-image è lo strumento giusto, ed è ciò che copre questo articolo.

Esempio 1: foto di prodotto da studio generata da testo

Prompt inviato al modello:

a minimalist amber glass skincare serum bottle with a brushed silver cap
standing on a polished travertine surface, soft diffused window light
casting a gentle gradient shadow, sage green linen backdrop, one small
dried eucalyptus sprig beside the bottle, e-commerce product photography,
sharp focus, clean composition, no text, no logo, subtle reflection on
the stone surface

Parametri della richiesta: aspect_ratio: "1:1", resolution: "2K".

Qui non ci sono flacone, studio fotografico né fotografo — la sfumatura dell'ombra, il riflesso sulla pietra e la luce morbida della finestra provengono tutti dalla descrizione. È qui che text-to-image batte la modifica: generare un render per la scheda prodotto o una moodboard per un prodotto ancora in sviluppo richiede circa un minuto, invece di pianificare uno shooting.

Esempio 2: grafica promozionale con titoli leggibili e accurati

Il rendering del testo è la metà più difficile del compito di questo modello — la maggior parte dei generatori di immagini produce testo illeggibile o con errori di ortografia. Due prompt, nessun nuovo tentativo:

Banner promozionale flat-lay:

a flat-lay e-commerce marketing banner for a summer skincare sale, an
arrangement of amber glass bottles and dried botanicals on a warm
terracotta background, bold sans-serif headline text 'SUMMER GLOW SALE'
near the top in cream white lettering, smaller text 'Up to 30% Off'
beneath it in matching cream, clean modern layout with generous negative
space on the right third, professional marketing design, crisp legible
typography, warm cinematic lighting

Parametri della richiesta: aspect_ratio: "4:3", resolution: "2K".

Grafica story verticale:

a vertical social media story graphic for a candle brand product launch,
a single black matte ceramic candle jar centered on a deep charcoal
gradient background, bold white headline text 'NEW ARRIVAL' near the
top, smaller subtext 'Shop the Collection' below the product, minimalist
premium aesthetic, soft rim lighting on the candle jar, generous margin
for mobile screen safe zones

Parametri della richiesta: aspect_ratio: "9:16", resolution: "2K".

Entrambi i titoli e entrambi i sottotitoli sono scritti correttamente, con spaziatura uniforme, e posizionati esattamente dove richiesto dal prompt — già alla prima generazione, senza bisogno di riprovare. È proprio questa affidabilità che rende il text-to-image adatto a materiali promozionali con scadenze strette: un banner promozionale o una story che prima richiedeva un designer ora si può abbozzare con una singola chiamata API.

Chiamare direttamente l'API

seedream-4.5/text-to-image funziona tramite l'endpoint asincrono di hiapi: invii il task, esegui il polling fino al completamento, poi scarichi il risultato.

curl:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5/text-to-image",
    "input": {
      "prompt": "a minimalist amber glass skincare serum bottle on a travertine surface, soft window light, sage linen backdrop, e-commerce product photography, no text",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

La risposta restituisce un task_id. Esegui il polling su GET /v1/tasks/{task_id} finché status non è succeeded, poi leggi l'immagine da output[0].url. L'URL ha una scadenza temporale — scarica subito.

Python (invio task + polling + download):

import os
import time
import requests

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


def generate_product_image(prompt: str, aspect_ratio: str = "1:1",
                            resolution: str = "2K") -> bytes:
    resp = requests.post(
        f"{API_BASE}/tasks",
        headers=HEADERS,
        json={
            "model": "seedream-4.5/text-to-image",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
            },
        },
        timeout=30,
    )
    resp.raise_for_status()
    task_id = resp.json()["task_id"]

    while True:
        poll = requests.get(f"{API_BASE}/tasks/{task_id}", headers=HEADERS, timeout=30)
        poll.raise_for_status()
        data = poll.json()
        if data["status"] == "succeeded":
            image_url = data["output"][0]["url"]
            return requests.get(image_url, timeout=30).content
        if data["status"] == "failed":
            raise RuntimeError(f"task {task_id} failed: {data.get('error')}")
        time.sleep(3)

Generare in batch un'intera linea di prodotti

La stessa chiamata si può estendere a un'intera linea di prodotti: una lista di tuple (name, prompt, aspect_ratio), un task per ogni elemento, salvando su disco con il nome corrispondente.

JOBS = [
    {
        "name": "serum-hero",
        "prompt": "a minimalist amber glass skincare serum bottle on a travertine "
                   "surface, soft window light, sage linen backdrop, e-commerce "
                   "product photography, no text",
        "aspect_ratio": "1:1",
    },
    {
        "name": "sale-banner",
        "prompt": "a flat-lay e-commerce marketing banner for a summer skincare "
                   "sale, amber glass bottles on a terracotta background, bold "
                   "headline text 'SUMMER GLOW SALE', smaller text 'Up to 30% Off'",
        "aspect_ratio": "4:3",
    },
    {
        "name": "story-launch",
        "prompt": "a vertical social story graphic, a black matte ceramic candle "
                   "jar on a charcoal gradient background, bold white headline "
                   "'NEW ARRIVAL', subtext 'Shop the Collection'",
        "aspect_ratio": "9:16",
    },
]

for job in JOBS:
    image_bytes = generate_product_image(
        prompt=job["prompt"],
        aspect_ratio=job["aspect_ratio"],
        resolution="2K",
    )
    with open(f"{job['name']}.jpg", "wb") as f:
        f.write(image_bytes)
    print(f"{job['name']}: done")

A $0,045 per immagine, un lancio stagionale con 20 asset — hero image, banner e story messi insieme — costa circa $0,90. Poiché ogni task è indipendente, inviare più chiamate /v1/tasks in contemporanea ed eseguire il polling in parallelo (rispettando i limiti di rate del tuo account) è più veloce che eseguire la lista in sequenza.

Confronto con seedream-5.0-pro

hiapi mette a disposizione anche seedream-5.0-pro, come livello separato e più recente per il text-to-image e-commerce. Non sono lo stesso modello: prezzi, opzioni di risoluzione e caratteristiche di output differiscono, e il workflow di seedream-5.0-pro è illustrato nella sua guida dedicata. Quando il deliverable richiede testo affidabile nell'immagine — banner promozionali, story, card promozionali — e vuoi un prezzo fisso di $0,045 per immagine, senza dover pianificare una struttura di prezzi a scaglioni per risoluzione, seedream-4.5/text-to-image è il modello da scegliere.

Domande frequenti

seedream-4.5/text-to-image accetta foto di riferimento? No — text-to-image accetta solo prompt, aspect_ratio e resolution. Per modificare una foto di prodotto esistente invece di generarne una nuova, usa seedream-4.5/image-to-image.

Quali risoluzioni e aspect ratio supporta? resolution accetta solo 2K o 4K — non esiste il livello 1K. aspect_ratio accetta 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2 e 21:9.

Riesce a rendere in modo affidabile il testo dei titoli all'interno dell'immagine? Sì — entrambi gli esempi promozionali sopra hanno reso correttamente titoli e sottotitoli composti da più parole alla prima generazione, senza errori di ortografia né glifi illeggibili.

Quanto costa generare in batch un'intera linea di prodotti? $0,045 per immagine, indipendentemente dal livello di risoluzione. Un set stagionale da 20 immagini costa circa $0,90; un set da 100 immagini costa circa $4,50.

Posso eseguire le generazioni in parallelo per velocizzare i task in batch? Sì — ogni task è indipendente, quindi inviare più chiamate /v1/tasks in contemporanea ed eseguire il polling in parallelo è il modo più veloce per produrre grandi volumi di asset.

Provalo tu stesso

Il riferimento completo dei parametri e i prezzi in tempo reale sono sulla pagina del modello e sulla pagina dei prezzi. Per altri esempi di prompt per questo modello, consulta le ricette di prompt text-to-image per seedream-4.5. Se il tuo workflow parte da foto reali del prodotto anziché da una pagina bianca, la guida e-commerce image-to-image di seedream-4.5 illustra come modificarle direttamente.

Ottieni una chiave API e genera la tua prima immagine di prodotto o banner promozionale — il codice sopra è pronto da copiare e incollare ed eseguirlo direttamente contro l'API hiapi.