Z-Image Spicy e Spicy Pro: progetta l'inquadratura prima di generare

Scegli Z-Image Spicy per immagini generate da testo fino a 1536 pixel per lato, a partire da $0.01235 a immagine. Scegli Spicy Pro quando un lato deve superare 1536, fino a 2560 pixel, a $0.019. Entrambe sono attività da testo a immagine senza censura. Nessuna accetta un'immagine di riferimento, quindi usa un editor separato quando un volto approvato deve restare identico.

Entrambe accettano brief senza censura così come sono scritti con l'espansione del prompt disattivata; nei nostri test di settembre 2026 Spicy ha perso una parte della scena una volta sulla richiesta più forte, Pro no (dettagli: Z-Image è senza censura?). Qui sotto: una ballerina adulta fittizia completamente vestita con un ventaglio corallo, prima un ritratto, poi un'immagine larga da annuncio.

Scegli tela e prezzo insieme

Invia width e height; non esiste il campo aspect_ratio. Tele utili: 960 × 1200 per una scheda 4:5, 864 × 1536 per un formato story 9:16, 1536 × 864 per 16:9, tutte dentro Spicy standard. Scegli Pro per 2560 × 1440 o per qualsiasi inquadratura larga 1600 pixel: Spicy rifiuta una larghezza di 1600 e ridurre solo la larghezza a 1536 cambia il rapporto d'aspetto in silenzio.

La fatturazione è per immagine, non per pixel, quindi un fotogramma Pro 2560 × 2560 costa gli stessi $0.019 di un quadrato 1024 e una bozza piccola non fa risparmiare nulla. Una tela diversa cambia l'immagine anche con lo stesso seed, quindi fai la bozza nella dimensione che consegnerai. Tieni il lato lungo entro circa il doppio del lato corto, a meno che lo spazio vuoto non sia proprio lo scopo.

Prova prima il ritratto nel Playground

1. Apri la pagina di Z-Image Spicy e resta nella scheda Playground, in vista Form. Accedi con un account con saldo per eseguire.
2. Imposta Width su 960 e Height su 1200, lascia Prompt expansion disattivata e inserisci un Seed come 314159.
3. Incolla il prompt qui sotto in Prompt ed esegui il modello; controlla il ventaglio, le mani e le scarpe prima di usare il risultato.

La pagina gemella di Z-Image da testo a immagine, non la pagina Spicy: la vista Form con il campo Prompt e il pulsante Run.

Immagine editoriale di moda naturale di una ballerina adulta fittizia di 32 anni, che prova da sola in uno studio tranquillo. Indossa una camicia blu cobalto a maniche lunghe, una gonna avorio e semplici scarpe da prova. Corpo intero in un leggero quarto di giro, entrambe le scarpe appoggiate sul pavimento di legno. Una mano tiene il manico di un ventaglio pieghevole corallo aperto accanto alla spalla, con la presa visibile e il ventaglio lontano dal viso. L'altra mano resta rilassata. Muro ocra uniforme, luce laterale morbida, spazio generoso sopra il ventaglio e sotto le scarpe. Nessuna scritta, nessuno specchio, nessuna persona in più e nessun ventaglio aggiuntivo.

Senza un campo per il prompt negativo, le esclusioni vanno nel prompt, quindi l'ultima frase è la tutela. Le parole che definiscono il ventaglio, la mano e l'inquadratura lavorano più di una sfilza di aggettivi da "capolavoro". Tieni la prima posa abbastanza ferma da capire quale mano regge l'oggetto; esplora un movimento di danza completo solo una volta che il concept dell'abbigliamento funziona.

Illustrazione, non un risultato del modello trattato nell’articolo: la presa visibile al perno del ventaglio è la relazione che questo prompt chiede.

Per confrontare le candidate, modifica una clausola ed esegui di nuovo con un seed diverso ogni volta. Il corpo della richiesta nel Playground è lo stesso JSON che accetta l'API, quindi una configurazione che funziona qui si copia direttamente nel codice. Per Pro, apri la pagina di Z-Image Spicy Pro e usa gli stessi campi con limiti più alti.

Poi eseguilo dal codice

Installa l'SDK Python (pip install spicyapi), imposta SPICY_API_KEY nell'ambiente del tuo server ed esegui:

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

task = client.create_task(
    model="alibaba/z-image-spicy/text-to-image",
    input_data={
        "prompt": "Natural editorial fashion image of one fictional adult dancer aged 32, rehearsing alone in a quiet studio. She wears a cobalt long-sleeved blouse, an ivory skirt and simple rehearsal shoes. Complete body in a gentle quarter turn, both shoes resting on the wooden floor. One hand holds the handle of one open coral folding fan beside her shoulder, with the grip visible and the fan away from her face. Her other hand hangs relaxed. Plain ochre wall, soft side light, generous room above the fan and below the shoes. No lettering, mirrors, extra people or additional fans.",
        "width": 960,
        "height": 1200,
        "enable_prompt_expansion": False,
        "seed": 314159,
    },
    idempotency_key=str(uuid.uuid4()),
)

print("Task", task["taskId"], flush=True)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
assets = output_assets(final)
if not assets or any(
    not asset.get("url") or asset.get("pending") or asset.get("unavailable")
    for asset in assets
):
    raise RuntimeError(f"{task['taskId']} has no complete downloadable output; look up this task before retrying")
print(assets[0]["url"])  # copy the image to your own storage now

Creazione, attesa, download, tentativi ed errori sono nella guida alle task e nel riferimento dell'SDK Python. I risultati scadono, quindi consulta conservazione e consegna prima di costruire sul link restituito.

Oppure lascia che sia un Agent a eseguirlo

Quando un assistente deve eseguire le generazioni, tutti e tre gli strumenti ufficiali mostrano il prezzo e chiedono conferma prima di una chiamata a pagamento.

• CLI. Metti lo stesso oggetto input in input.json, poi:

``bash spicyapi tasks create --model alibaba/z-image-spicy/text-to-image --input-file input.json --wait ``

Vedi la documentazione della CLI; npx @spicyapi/cli funziona senza installazione.

• Server MCP. Aggiungi il server MCP al tuo assistente, poi chiedi: "Run Z-Image Spicy at 960 by 1200 with this prompt, prompt expansion off." Chiama spicyapi_task_create, che si ferma per la tua conferma del prezzo, e poi spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill installa l'Agent Skill, che fa leggere a un assistente di codice lo schema del modello in tempo reale invece di indovinare i campi.

Rendi l'immagine larga una composizione nuova e voluta

Passa a width: 1536, height: 864. Nel prompt del ritratto, sostituisci "Corpo intero in un leggero quarto di giro, entrambe le scarpe appoggiate sul pavimento di legno." con le prime due frasi qui sotto e "spazio generoso sopra il ventaglio e sotto le scarpe" con la terza:

Colloca la ballerina intera a sinistra nell'inquadratura, in un leggero quarto di giro, con entrambe le scarpe appoggiate sul pavimento di legno. Tieni il ventaglio interamente aperto lontano dal bordo dell'immagine. Riserva il terzo destro a una parete ocra semplice, per il testo dell’evento da aggiungere separatamente.

Questa è una nuova immagine generata da testo, non una modifica del ritratto, e lo stesso seed non porterà il volto approvato da una tela all'altra. Quando l'identità deve coincidere, tieni il ritratto scelto e usa un editor di immagini che supporta i riferimenti o un normale processo di ritaglio e composizione per il banner.

Aggiungi in seguito il titolo, la data e il luogo reali nel tuo strumento di design; un muro vuoto è una richiesta di composizione, non la promessa di un testo generato scritto correttamente. Se il muro risulta troppo stretto, sposta il testo fuori dall'immagine invece di coprire il ventaglio.

Correggi questi problemi prima di passare a Pro

Pro non corregge anatomia né composizione; rivedi prima il brief e sali di livello solo quando un lato deve superare 1536.

Espansione e seed

Lascia disattivata l'espansione del prompt. Riscrive il prompt prima della generazione e può rendere generico un testo che hai scelto di proposito, e questo conta soprattutto per i brief rivolti a un pubblico adulto. Attivala solo per un concetto di una riga di cui accetterai una scena diversa; aggiunge $0.00095 a immagine su Spicy standard e nulla su Pro.

La pagina del modello dice che un seed omesso (o 0) estrae a caso, ma ripetere una richiesta senza seed ha restituito la stessa immagine su entrambi i livelli nei nostri test, quindi invia un seed diverso per ogni candidata. Un seed mantiene confrontabile un'estrazione ma non garantisce un'immagine identica, quindi salva i file che scegli invece di affidarti a un numero per ricrearli.

Illustrazione, non un risultato del modello trattato nell’articolo: le stampe fisiche sostituiscono l'esame di concept di ritratto.

Budget e decisione

Quattro candidate Spicy standard con espansione disattivata costano $0.0494; quattro candidate Pro costano $0.076. Inizia su Spicy per tutto ciò che rientra in 1536 pixel; paga Pro quando il posizionamento richiede un lato più lungo e correggi il brief, non la versione, quando anatomia o composizione sono sbagliate.