popnow
AccediInizia a creare

alibaba/z-image-turbo/text-to-imageDa 2 crediti per immagine

Z-Image è la famiglia di immagini compatta da 6B di Tongyi, tarata su output fotorealistici in circa un secondo e pubblicata come un unico endpoint text-to-image. Cinque proporzioni, PNG senza perdita, prompt fino a 1.000 caratteri.

Lo chiami con il nome di modello alibaba/z-image-turbo/text-to-image su POST /jobs/createTask, da 2 crediti per immagine (0,02 USD). I nuovi account ricevono 30 crediti gratuiti per provarlo prima nel Playground.

  • Crea immagine
  • 5 formati
di AlibabaOttieni una chiave APIEsempi e prompt di Z-Image →

Per ora questa guida è solo in inglese. →

Parametri della richiesta

ParametroObbligatorioDescrizione
seedNoLo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647
promptSìDescribe the image to generate: subject, composition, style, and lighting.
aspect_ratioNoLa forma dell'inquadratura: larga, quadrata o verticale. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · Predefinito: 1:1
output_formatNoTipo di file del risultato. png · Predefinito: png
enable_prompt_expansionNoLascia che il modello arricchisca un prompt breve. Predefinito: false

Prezzi

I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.

OpzioneCrediti per immagine≈ USD
Standard1,50,015 USD
enable_prompt_expansion true2,40,024 USD

Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 2 crediti per immagine (0,02 USD).

Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.

Guida rapida all'API

Chiama l'API di Z-Image in tre passaggi

  1. Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
  2. Invia la richiesta. Invia POST /jobs/createTask con model alibaba/z-image-turbo/text-to-image e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
  3. Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $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"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.

Domande sull’API di Z-Image

Quanto costa l’API di Z-Image?

Z-Image costa 2 crediti (0,02 USD) per immagine. Prezzi per opzione: Standard 1,5 crediti per immagine, true 2,4 crediti per immagine. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.

Qual è il nome del modello di Z-Image nell’API?

Inserisci alibaba/z-image-turbo/text-to-image per Crea immagine nel campo model di POST /jobs/createTask.

Quanto è veloce davvero Z-Image?

Circa un secondo per un fotogramma text-to-image. È il senso della famiglia: il ciclo è abbastanza corto da trattare la formulazione come un esperimento e non come un impegno.

Che cosa controlla davvero aspect_ratio?

Le dimensioni in pixel dell'output. Ogni proporzione corrisponde a una dimensione fissa intorno al megapixel nativo del modello, così la qualità resta uniforme tra le proporzioni invece di crollare agli estremi.

Posso riprodurre un'immagine di prima?

Molto da vicino, se hai conservato il seed: con lo stesso prompt, le stesse proporzioni e lo stesso seed il risultato torna molto vicino al fotogramma di prima, anche se un seed non garantisce pixel identici. Senza seed, richieste identiche restituiscono fotogrammi diversi, quindi conserva prompt e seed accanto a ogni asset che vuoi tenere.

Perché il limite del prompt è di soli 1.000 caratteri?

È il massimo che questo endpoint accetta: un prompt più lungo viene rifiutato prima dell'invio, non troncato in silenzio. Corrisponde anche a ciò che un modello compatto da 6B sfrutta davvero: qui una descrizione stretta di soggetto, luce e texture batte una lunga lista di inquadrature.

Quali sono i limiti dell’API di Z-Image?

Proporzioni: 1:1 · 4:3 · 3:4 · 16:9 · 9:16; Lunghezza del prompt (caratteri): 1,000. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.

Posso provare Z-Image senza scrivere codice?

Sì. Il Playground esegue Z-Image con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.

Tutti i modelli Z-Image

Z-Image Turbo LoRA esegue la stessa famiglia con i tuoi LoRA e aggiunge il da immagine a immagine.

Altro su Z-Image