Generare immagini di prodotti e-commerce con flux-2-klein-9b/text-to-image tramite l'API hiapi

La maggior parte dei modelli text-to-image veloci ed economici ti costringe a scegliere: o il testo nell'immagine è leggibile, oppure il prezzo è basso. flux-2-klein-9b/text-to-image è uno dei pochi modelli della fascia «veloce ed economico» che non ti obbliga a rinunciare a una delle due cose. hiapi lo etichetta come Text Rendering, High Fidelity (rendering del testo, alta fedeltà) — e in pratica questo significa che riesce a rendere in un'unica generazione il logo testuale del brand, una riga di testo in piccolo e un grande titolo promozionale ben visibile, senza dover fare un secondo passaggio per correggere lettere illeggibili.

Questo è particolarmente importante per le immagini di prodotti e-commerce: proprio le immagini che hanno davvero bisogno di testo — la hero image con l'etichetta visibile, il banner promozionale a tempo con il prezzo indicato — sono quelle che i modelli «veloci» ed economici tendono a rovinare più facilmente.

In questo articolo tutte e tre le immagini sono state generate con flux-2-klein-9b/text-to-image, senza alcun retry: il testo dell'etichetta, il grande titolo promozionale e la riga con lo sconto sono tutti venuti puliti e corretti alla prima generazione. Questo non significa che ogni prompt possa garantirlo (vedi la nota sulla revisione più sotto), ma per un modello di questa fascia di prezzo è un buon segno.

Prezzi: confronto tra flux-2-klein-9b e flux-2-klein-4b (text-to-image)

I due modelli appartengono alla stessa famiglia «Klein» e puntano entrambi su velocità e basso costo. La differenza sta in cosa paghi:

Modello	Prezzo per immagine	Tag
flux-2-klein-9b/text-to-image	Tariffa unica $0.00858	Text-to-Image, Text Rendering, High Fidelity
flux-2-klein-4b/text-to-image	Tariffa unica $0.00143	Text-to-Image, Fast, Cost Efficient

(Prezzi aggiornati a 2026-08, verificati su /api/pricing.)

flux-2-klein-4b/text-to-image costa circa 6 volte meno — è la scelta predefinita per sfondi, scene di lifestyle o qualsiasi immagine in cui il testo non fa parte della composizione. Ma non ha il tag di rendering del testo, quindi se il testo su card, etichette o banner deve essere davvero leggibile, anche a un prezzo più alto klein-9b è la scelta più sicura. E a meno di un centesimo per immagine, qui «sicuro» costa comunque meno di una singola chiamata API a un LLM.

Una richiesta reale

Ecco una richiesta funzionante verso l'endpoint /v1/tasks per generare una card promozionale con testo renderizzato:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Banner social per una promozione a tempo di e-commerce: un flacone contagocce in vetro sabbiato con l'etichetta che riporta 'VELURA HYDRA SERUM', centrato su uno sfondo sfumato morbido che passa dal rosa cipria al color crema, in alto un grande titolo sans-serif in grassetto e ben allineato con il testo 'FLASH SALE' in lettere grigio antracite, sotto una riga di testo più piccola con il testo '30% OFF' nello stesso font, in basso a destra un badge a rettangolo arrotondato con contorno sottile contenente il testo 'VELURA', tipografia chiara e leggibile, spaziatura equilibrata, design marketing moderno e minimale, nessun altro testo, nessuna filigrana",
      "aspect_ratio": "1:1"
    }
  }'

La richiesta restituisce un taskId. Fai polling su GET /v1/tasks/{taskId} finché status non diventa success, poi scarica output[0].url — i link firmati scadono, quindi recupera subito i byte e salvali per conto tuo.

Note sullo schema: cosa funziona davvero

Prima di sviluppare su questo modello, ci sono alcuni punti che vale la pena conoscere, basati su ciò che l'API accetta realmente (non solo sulla documentazione):

• resolution viene rifiutato. A differenza di altri modelli di immagini di hiapi, inviare il campo resolution restituisce 400 (additional properties not allowed). Invia solo aspect_ratio.
• aspect_ratio è una lista breve e fissa: 1:1, 4:3, 3:4, 16:9, 9:16. Non ci sono 4:5 né 21:9 — se il tuo layout richiede un ritaglio verticale più alto, 3:4 è il rapporto supportato più vicino (è quello che abbiamo usato per la foto lifestyle più sotto).
• aspect_ratio è facoltativo. Ometterlo del tutto genera comunque un'immagine valida, usando il valore predefinito del server — ma nel lavoro e-commerce vuoi quasi sempre un formato preciso (quadrato per i post del feed, 16:9 per il banner principale), quindi conviene impostarlo esplicitamente invece di affidarti al default.
• Prezzo unico per immagine, senza scaglioni di risoluzione. A differenza di flux-2-klein-4b/image-to-image (con cinque scaglioni di prezzo in base ai megapixel), klein-9b/text-to-image ha una tariffa unica indipendentemente dal rapporto d'aspetto.

Prompt + output: immagine hero

Prompt (16:9, usato così com'è, senza modifiche dopo la generazione):

Immagine hero di prodotto e-commerce: un flacone contagocce in vetro sabbiato pieno di un siero skincare premium, appoggiato su una lastra di marmo grigio bagnata, la luce morbida del giorno da sinistra crea un riflesso delicato, sfondo beige minimale, piccole gocce d'acqua sul marmo, sull'etichetta del flacone è chiaramente scritto 'VELURA' in un font serif moderno e pulito, sotto un testo più piccolo 'HYDRA SERUM', fotografia di prodotto professionale in studio, messa a fuoco nitida, luce di contorno sottile, nessun altro testo, nessuna mano, nessuna filigrana con logo

(L'immagine è quella mostrata all'inizio dell'articolo.) Il nome del brand e la linea di prodotto sono resi in modo pulito a normale distanza di lettura — nessuna lettera duplicata, nessuna serif deformata, che è proprio il tipico modo in cui falliscono i modelli text-to-image economici di questa fascia.

Prompt + output: scena lifestyle

Prompt (3:4):

Foto lifestyle per e-commerce: un flacone contagocce in vetro sabbiato con l'etichetta che riporta 'VELURA HYDRA SERUM', appoggiato su un luminoso piano bagno, accanto a un asciugamano bianco piegato e a un piccolo rametto di eucalipto in vaso, calda luce del mattino che entra dalla finestra, ombre morbide, profondità di campo ridotta, styling naturale e spontaneo, il testo dell'etichetta del flacone 'VELURA' e 'HYDRA SERUM' resta nitido e leggibile, nessuna persona, nessuna mano, nessun testo sovrapposto aggiuntivo

Una foto lifestyle come questa spesso non ha affatto bisogno di testo sopra — ma l'etichetta deve comunque reggere in condizioni di luce più morbida e diffusa rispetto alla hero image in studio, e questo è un test più difficile per la fedeltà del testo del modello.

Prompt + output: card promozionale a tempo

Prompt (1:1):

Banner social per una promozione a tempo di e-commerce: un flacone contagocce in vetro sabbiato con l'etichetta che riporta 'VELURA HYDRA SERUM', centrato su uno sfondo sfumato morbido che passa dal rosa cipria al color crema, in alto un grande titolo sans-serif in grassetto e ben allineato con il testo 'FLASH SALE' in lettere grigio antracite, sotto una riga di testo più piccola con il testo '30% OFF' nello stesso font, in basso a destra un badge a rettangolo arrotondato con contorno sottile contenente il testo 'VELURA', tipografia chiara e leggibile, spaziatura equilibrata, design marketing moderno e minimale, nessun altro testo, nessuna filigrana

Questa è davvero l'immagine che mette alla prova il tag «Text Rendering, High Fidelity» del modello: due righe di grande titolo più un piccolo testo nel badge, tutte completate in un'unica generazione. Ogni parola è scritta correttamente e la spaziatura tra le lettere resta adeguata — ma proprio per questo dovresti comunque controllare di persona prima di pubblicare (vedi sotto).

Non saltare la revisione

Le linee guida sui contenuti di hiapi lo dicono chiaramente: il rendering del testo con l'IA è «al 99%, non al 100%». Anche i modelli con il tag di testo ad alta fedeltà a volte sbagliano una parola, saltano una lettera o uniscono due parole — soprattutto con il testo piccolo delle etichette rispetto ai grandi titoli (i caratteri piccoli sono più difficili). Prima di pubblicare una card promozionale o un'etichetta di prodotto generata:

1. Ingrandisci al 100% e controlla ogni riga di testo renderizzata.
2. Verifica ortografia e spaziatura, non solo che «sembri testo».
3. Se qualcosa non va, rigenera — non ritoccare i pixel a mano, perché un nuovo tentativo costa solo una frazione di centesimo.
4. Per i testi che cambiano spesso (prezzi, date delle promozioni), valuta di sovrapporli nel tuo passaggio di template invece di inserirli in ogni generazione — aggiornare costa meno e elimina del tutto il rischio di dover rigenerare.

Generazione in batch con Python

Per un catalogo prodotti completo, incapsula lo stesso schema di richiesta in un ciclo:

import requests
import time

API_KEY = "your-api-key"
BASE = "https://api.hiapi.ai/v1/tasks"

def generate(prompt, aspect_ratio="1:1"):
    resp = requests.post(
        BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "flux-2-klein-9b/text-to-image",
            "input": {"prompt": prompt, "aspect_ratio": aspect_ratio},
        },
    )
    task_id = resp.json()["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)

prompts = [
    ("Hero shot for product SKU-001, studio lighting, label reads 'BRAND NAME'", "16:9"),
    ("Lifestyle shot for product SKU-001 on a wooden shelf", "3:4"),
    ("Flash sale card for product SKU-001, headline 'LIMITED TIME'", "1:1"),
]

for prompt, ratio in prompts:
    url = generate(prompt, ratio)
    print(url)  # download immediately — the URL expires

Calcolando $0.00858 per immagine, un catalogo di 50 SKU con 3 immagini ciascuno (hero, lifestyle, promozionale) costa in totale circa $1.29 — praticamente una miseria rispetto a un servizio fotografico di prodotto freelance.

Confronto tra flux-2-klein-9b/text-to-image e flussi di lavoro correlati

Se stai costruendo una pipeline più completa per le immagini di prodotto su hiapi, vale la pena leggere alcune sezioni correlate:

• Se devi modificare o cambiare stile a foto di prodotto esistenti invece di generarle da zero, vedi flux-2-klein-4b per il ritocco e-commerce image-to-image — è un compito diverso (i2i, non t2i), pensato per ritoccare foto reali invece di generare nuove scene.
• Per i pattern di prompt specifici della modalità image-to-image della fascia 9b (stessa potenza di rendering del testo, applicata all'editing), vedi prompt image-to-image per flux-2-klein-9b.
• Parametri completi, prezzi in tempo reale e una console per testare i prompt prima di eseguire i batch: pagina del modello flux-2-klein-9b/text-to-image.

FAQ

flux-2-klein-9b/text-to-image supporta l'image-to-image? No — questo specifico endpoint supporta solo il text-to-image. hiapi elenca separatamente un modello flux-2-klein-9b/image-to-image (prezzo $0.03143/immagine) per modificare foto esistenti.

Quali rapporti d'aspetto sono supportati? Cinque: 1:1, 4:3, 3:4, 16:9, 9:16. Non c'è 4:5 nativo — usa 3:4 per ottenere un ritaglio verticale simile.

Posso impostare la risoluzione di output? No. Inviare il campo resolution restituisce 400. Prezzo e dimensioni di output sono fissati in base al rapporto d'aspetto.

Passare a flux-2-klein-4b costa meno? Sì, circa 6 volte meno per immagine ($0.00143 contro $0.00858) — ma klein-4b non ha il tag di rendering del testo. Usalo per immagini senza testo (scene lifestyle pure o sfondi), e lascia klein-9b per qualsiasi immagine con etichette, titoli o indicazioni di prezzo.

Quanto tempo richiede la generazione? Tutte e tre le immagini di questo articolo, tramite il flusso di polling su /v1/tasks, sono state completate in meno di due minuti ciascuna.

Provalo

Puoi testare flux-2-klein-9b/text-to-image direttamente sulla pagina del modello con i tuoi prompt, prima di passare ai job in batch; e puoi consultare le tariffe attuali in qualsiasi momento sulla pagina dei prezzi. Lo schema completo di richiesta/risposta e la configurazione dell'autenticazione sono nella documentazione API.