Introduzione
Z-Image Testo in immagine trasforma una descrizione scritta in una sola immagine, di solito in circa un secondo. Il punto è la velocità: rende la generazione così economica da poterla trattare come un ciclo e non come un impegno.
Z-Image è la famiglia di immagini compatta da 6B di Tongyi, messa a punto per risultati fotorealistici in circa un secondo e pubblicata qui come unico endpoint testo in immagine. Cinque formati, PNG senza perdita, prompt fino a 1.000 caratteri. Senza censura.
Caratteristiche principali
Venti iterazioni invece di un prompt prudente
A circa un secondo per immagine, smetti di scrivere prompt sulla difensiva. Scrivi una riga, guarda, correggi, guarda di nuovo: il ciclo è così breve che l’intuito si costruisce sulle prove e non sulle supposizioni, e venti tentativi qui costano comunque meno di una chiamata a un modello di finitura pesante.
Texture da istantanea, non patina da studio
Il suo registro più forte è quello meno patinato: selfie allo specchio con lo smartphone, neon dall’alto, un leggero mosso, capelli umidi. Chiedi un’istantanea e ottieni qualcosa che sembra scattato e non renderizzato, proprio quello che i modelli più pesanti tendono a levigare via.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 1.000 caratteri: un budget piccolo di proposito. almeno 1 caratteri · al massimo 1000 caratteri |
aspect_ratio | No | Forma dell'output: cinque valori, quadrato per impostazione predefinita, dal 16:9 orizzontale al 9:16 verticale. |
enable_prompt_expansion | No | Disattivato di default, quindi il prompt viene usato così come l’hai scritto. Predefinito: |
output_format | No |
|
seed | No | Intero da 0 a 2147483647 per la partenza casuale; se lo ometti, ogni esecuzione ne estrae uno proprio. |
Prezzi
$0.01 / immagine
Casi d’uso
Partire da un brief scritto
Usa questo endpoint quando vuoi vedere un’idea scritta in tante versioni rapide: ogni chiamata restituisce un PNG senza perdita in circa un secondo, in uno di cinque formati. Conserva ogni prompt che funziona insieme al suo seed.
Serie di personaggi in volume
Ritratti di personaggi e ambientazioni da gioco di ruolo esplorati venti direzioni alla volta, senza nulla da segnalare e senza un endpoint separato. Ogni esecuzione estrae la propria immagine, quindi tieni i prompt che funzionano e varia guardaroba e ambientazione una parte alla volta.
Concept prima di un modello di finitura
Trova la composizione qui, dove un’immagine costa circa un secondo, poi porta la formulazione riuscita su un modello più lento e con un tetto più alto per la versione da consegnare. Stesso vocabolario fotografico, nessuna ristrutturazione.
Contenuti che sembrano una vera istantanea
Selfie allo specchio, luci al neon di palestra e lampadine dure dall’alto, inquadrature casual da fotocamera del telefono: il registro che in un feed sembra una foto vera. Chiedi esplicitamente i difetti: dominante fluorescente, mosso, messa a fuoco irregolare.
Consigli avanzati
Tieni il brief stretto e concreto
1.000 caratteri sono un budget piccolo: spendili per luce, obiettivo e texture. L’immagine pubblicata è nata da: «iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look.»
Tieni il prompt insieme all’immagine buona
Senza seed, richieste identiche estraggono immagini diverse. Salva prompt e seed accanto al file e cambia una sola parte alla volta mentre cerchi qualcosa di meglio; con il seed fermo, la differenza che vedi viene da quella parte.
Adatta l’esempio incluso
Parti dall’esempio pubblicato con aspect_ratio: 1:1 e output_format: png. Sostituisci soggetto e direzione creativa mantenendo intatto il contratto di input di questa modalità.
iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look.
Una versione quadrata della richiesta dietro l’immagine pubblicata: un brief da istantanea che nomina la sorgente di luce, il mosso e l’inquadratura invece di chiedere qualità.
Controlla il risultato prima di iterare
Il limite del prompt è di 1.000 caratteri, e un prompt più lungo viene rifiutato prima dell’invio invece di essere troncato: questo modello premia un brief stretto, non una lista di inquadrature. Ogni formato corrisponde a una dimensione fissa intorno al megapixel nativo del modello, quindi non c’è un selettore di risoluzione né un modo per arrivare a un’immagine grande da consegnare. Tipografia fine e dettagli piccoli e fitti non sono ciò per cui è fatto un modello da 6B.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/z-image-turbo/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "png",
"enable_prompt_expansion": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
