API Z-Image: $0,008 per immagine, output reali e codice

In sintesi

• Z-Image è un modello veloce di text-to-image lanciato da Alibaba Tongyi. Su HiAPI l'id del modello è z-image e il costo è di $0,008 per immagine: 1.000 immagini costano $8.
• La richiesta contiene solo due campi: prompt (massimo 1.000 caratteri) e aspect_ratio (1:1, 4:3, 3:4, 16:9, 9:16). Non ci sono dimensioni, risoluzione, seed o input immagine.
• È bravo a generare immagini di prodotto fotorealistiche con brevi testi in inglese. Nei quattro test seguenti, ogni testo è stato reso correttamente. Apri la pagina del modello Z-Image per provarlo; i nuovi account ricevono 200 crediti gratuiti.

Prezzi

Numero di immagini	Costo di z-image
1	$0,008
100	$0,80
600 (200 prodotti × 3 immagini)	$4,80
1.000	$8,00

Prezzi HiAPI in tempo reale, verificati il 20 ottobre 2026. Prezzo unico per tutti gli aspect ratio. Le attività fallite non vengono addebitate.

Confronto con altri modelli a basso costo su HiAPI:

Modello	Per immagine	Testo nelle immagini
flux-schnell/text-to-image	$0,005	Non è il suo punto di forza
z-image	$0,008	Testo breve in inglese, affidabile nei nostri test
qwen-image-2.1-turbo	$0,02	Supporta cinese e inglese; accetta anche immagini di riferimento
gpt-image-2/text-to-image	$0,03 a risoluzione 1K	Prestazioni elevate; può anche modificare immagini

Per ulteriori opzioni (inclusi i video), vedi le API di generazione immagini e video più economiche su HiAPI.

Output reali: immagini di prodotto con testo

Cartellino del prezzo (1:1)

Fotografia di prodotto e-commerce da studio: una borraccia termica in acciaio inossidabile nero opaco centrata su uno sfondo grigio chiaro uniforme con ombra morbida. Un biglietto rettangolare in carta corallo è appoggiato obliquamente accanto alla borraccia. Il biglietto contiene SOLO queste due righe di testo in grassetto, sans-serif pulito, e nessun'altra parola: prima riga "SUMMER SALE", seconda riga "$19.99". Testo frontale rispetto alla fotocamera, in piano, grande e perfettamente leggibile. Fotorealistico.

Genera con questo prompt →

z-image, 1:1, 1536×1536, $0,008.

Entrambe le righe di testo sono corrette. Il cartellino finisce appeso al manico della borraccia invece che appoggiato di fianco. La prima versione di questo prompt diceva "reads exactly: SUMMER SALE on the first line and $19.99 on the second line" e il modello ha stampato una parola in più "ON" tra le due righe. Metti il testo esatto tra virgolette e le istruzioni fuori dalle virgolette.

Banner orizzontale (16:9)

Banner promozionale e-commerce panoramico, flat-lay fotorealistico: scarpe da ginnastica bianche e una scatola di spedizione in carta kraft su uno sfondo azzurro pastello. A destra, testo in grassetto blu navy sans-serif con esattamente queste quattro parole e l'importo, nient'altro: "FREE SHIPPING OVER $50". Tutte e quattro le parole devono comparire. Testo grande, dritto, perfettamente leggibile. Illuminazione da studio commerciale pulita.

Genera con questo prompt →

z-image, 16:9, 1344×768, $0,008.

Card per social media (3:4)

Card di prodotto verticale per social media: un piccolo flacone contagocce in vetro marrone per cosmetici su un podio color beige caldo, luce diurna morbida. Sopra il flacone, un titolo in grassetto nero moderno sans-serif recita esattamente: 30% OFF TODAY ONLY. Testo frontale rispetto alla fotocamera, in piano, grande e perfettamente leggibile. Stile e-commerce minimal premium, fotorealistico.

Genera con questo prompt →

z-image, 3:4, 928×1232, $0,008.

Il testo è corretto, ma il contagocce si sovrappone alla parola "ONLY". Se il titolo deve restare ben leggibile, specifica la posizione del prodotto ("in the lower half, below the text", cioè nella metà inferiore, sotto il testo).

Testo piccolo sull'etichetta (3:4)

Fotografia macro di prodotto e-commerce: un flacone per skincare in vetro smerigliato con un'etichetta bianca pulita. Il testo dell'etichetta, stampato in un'elegante sans-serif scuro, recita esattamente: GLOW SERUM sulla prima riga e VITAMIN C 10% sulla seconda riga. Angolazione frontale, etichetta completamente visibile e nitida, illuminazione da studio morbida, fotorealistico, sfondo bianco.

Genera con questo prompt →

z-image, 3:4, 928×1232, $0,008.

Il testo piccolo su superfici curve è il più difficile dei quattro, ma l'output è pulito. Il modello ha disposto "VITAMIN C 10%" su due righe.

Regole per ottenere il testo corretto

1. Metti il testo esatto tra virgolette.
2. Aggiungi "and no other words" (nessun'altra parola), così il modello non inventa ulteriori testi sui badge.
3. Fai in modo che il testo sia frontale rispetto alla fotocamera e in piano. I testi inclinati o curvi sono i primi a sbagliare.
4. Inserisci solo uno o due blocchi di testo per immagine. I testi più lunghi vanno impaginati successivamente in uno strumento di design.
5. Controlla ogni immagine prima di pubblicarla. A $0,008, rigenerare una volta costa quasi nulla.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image",
    "input": {
      "prompt": "A cozy coffee shop at golden hour, a wooden A-frame sign on the sidewalk reading \"FRESH COFFEE\", warm window light, photorealistic",
      "aspect_ratio": "16:9"
    }
  }'

Riceverai un taskId. Esegui il polling di GET https://api.hiapi.ai/v1/tasks/{taskId} finché data.status non è success, poi scarica data.output[0].url. Lo stato passa in sequenza da queued, handling e archiving, per poi diventare success o fail. I link scadono circa 7 giorni dopo il completamento dell'attività.

Python: elaborazione in piccoli lotti

# pip install requests; prima esegui export HIAPI_KEY=your-key
import os, time, requests

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

def submit(prompt, ratio="1:1"):
    r = requests.post(API, json={"model": "z-image", "input": {"prompt": prompt, "aspect_ratio": ratio}},
                      headers=H, timeout=30).json()
    if r.get("code") != 200:
        raise RuntimeError(r)
    return r["data"]["taskId"]

def wait(task_id, timeout_s=300):
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] in ("success", "fail"):
            return d
        time.sleep(3)
    raise TimeoutError(task_id)

products = {"mug-sage": "sage green", "mug-navy": "navy blue", "mug-terracotta": "terracotta"}
tasks = {sku: submit(f'Studio photo of a {color} ceramic coffee mug on white, a small card reads "NEW"')
         for sku, color in products.items()}   # invia prima tutti, poi raccogli insieme

for sku, task_id in tasks.items():
    d = wait(task_id)
    if d["status"] == "success":
        with open(f"{sku}.png", "wb") as f:
            f.write(requests.get(d["output"][0]["url"], timeout=120).content)
    else:
        print(sku, "failed:", d.get("error"))

Parametri ed errori

Campo	Obbligatorio	Valori
prompt	Sì	Massimo 1.000 caratteri
aspect_ratio	No	1:1, 4:3, 3:4, 16:9, 9:16

Nei seguenti casi viene restituito HTTP 400 al momento dell'invio, senza creare l'attività né addebitare costi:

• additional properties 'size' not allowed (oppure resolution, width): usa invece aspect_ratio.
• aspect_ratio: value must be one of ...: 21:9 e 4:5 non sono supportati. Genera prima in 16:9 o 3:4 e poi ritaglia.
• Uso di un id modello come z-image-turbo: su HiAPI l'unico id è z-image.

Quando conviene usare un altro modello

• Devi modificare un'immagine esistente: Z-Image genera solo da testo. Usa un modello image-to-image, come qwen-image-2.1-turbo ($0,02) o gpt-image-2/image-to-image.
• Testo lungo o denso, o molto cinese: prova Qwen Image, progettato per la tipografia bilingue.
• Cerchi il prezzo più basso e non ti serve il testo: flux-schnell/text-to-image costa $0,005.

Domande frequenti

Qual è l'id del modello?

z-image. Su HiAPI non esiste un id separato z-image-turbo; Turbo è il nome con cui questa variante veloce è nota a monte.

Come si ottiene la chiave API?

Registrati su hiapi.ai, crea una chiave nella console e inviala come Authorization: Bearer <key>. La stessa chiave vale per tutti i modelli.

Riesce a renderizzare testo in cinese?

Alibaba elenca la tipografia bilingue tra i punti di forza. I quattro test sopra sono tutti in inglese, quindi prima di affidarti a questa funzione verifica l'output in cinese con i tuoi prompt.

C'è un'impostazione della risoluzione?

No. Le dimensioni di output dipendono dall'aspect ratio: nei test sopra, 1:1 restituisce 1536×1536, 16:9 restituisce 1344×768 e 3:4 restituisce 928×1232.

Vuoi provare il prompt senza scrivere codice? Apri la pagina del modello Z-Image.