Introduzione
Z-Image Base LoRA Immagine in immagine ridisegna un’immagine sorgente con Z-Image, il modello base da 6 miliardi di parametri del team Tongyi-MAI di Alibaba, con fino a tre file LoRA tuoi caricati. Un controllo della strength stabilisce quanto il risultato si allontana dalla sorgente. L’output mantiene le proporzioni della sorgente. La piattaforma non aggiunge alcun filtro sui contenuti a prompt, pesi o immagine.
Scegli la modalità in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| una descrizione scritta | Z-Image Base LoRA Testo in immagine |
| un’immagine a cui dare un nuovo stile | Z-Image Base LoRA Immagine in immagine |
Caratteristiche principali
Cambia stile con un LoRA, mantieni la composizione
Con un LoRA di stile a strength 0,6, le nostre foto di prova sono state ridisegnate come illustrazioni mentre posa, inquadratura e abiti restavano esattamente al loro posto.
Un solo cursore di strength
La strength va da 0 a 1 (default 0,7). Sotto 0,6 la sorgente torna quasi invariata; da circa 0,75 la scena viene riposizionata e rimessa in scena con la stessa luce e la stessa tavolozza.
Due livelli di risoluzione
1k restituisce un lato lungo di 1.024 pixel e 1.5k un lato lungo di 1.536 pixel, nelle proporzioni della sorgente. Costano uguale.
Nessun filtro sui contenuti
Le immagini di partenza possono essere ridisegnate con qualsiasi prompt. Nulla viene filtrato in entrata né in uscita; nei nostri test il livello Molto forte è uscito confuso anziché bloccato.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Descrivi l’intera immagine che vuoi ottenere, non solo il cambiamento. Metti per prima la frase trigger di un LoRA. almeno 1 caratteri · al massimo 5000 caratteri |
image_url | Sì | L’immagine da ridisegnare. Il risultato ne mantiene le proporzioni; il livello di risoluzione stabilisce il lato lungo. |
resolution | No | 1k restituisce un lato lungo di 1.024 pixel ed è il valore predefinito; 1.5k ne restituisce 1.536. Costano uguale e le proporzioni seguono sempre la sorgente. |
strength | No | Quanto allontanarsi dalla sorgente, da 0 a 1; di default 0,7. |
loras | No | Fino a tre voci {path, scale} addestrate su Z-Image Base; scale da 0 a 4, 1 è neutro. Qui è soprattutto un LoRA di stile a fare il cambio di aspetto. Predefinito: |
output_format | No | JPEG di default, oppure PNG o WebP. Il formato non cambia il prezzo. |
seed | No | Mantiene confrontabili i risultati mentre regoli la strength. Non garantisce gli stessi identici pixel a ogni esecuzione. |
Prezzi
$0.014 / immagine
Addebitato per immagine, alla stessa tariffa del testo in immagine. Il livello di risoluzione, il formato di output e il caricamento dei LoRA non cambiano il prezzo.
Casi d’uso
Da foto a illustrazione
Carica un LoRA di illustrazione e passa le tue foto a 0,6 per ottenere una serie illustrata coordinata.
Varianti di uno scatto
Tra 0,75 e 0,8 il modello mantiene la luce e l’atmosfera di una foto ma ridisegna posa e ambientazione, utile per ottenere versioni alternative.
Provare un LoRA addestrato su immagini reali
Verifica come un LoRA che hai addestrato su Z-Image Base tratta fotografie reali prima di costruirci sopra.
Consigli avanzati
Descrivi l’intera immagine
Scrivi l’immagine che vuoi ottenere, non il cambiamento. "A woman in a green velvet dress singing on a dark stage" funziona; "make it black and white" da solo non ha funzionato nei nostri test.
Lascia che sia il LoRA a cambiare stile
Senza LoRA, le istruzioni per cambiare il medium o l’abito hanno cambiato poco sotto 0,8. Un LoRA di stile ha cambiato il medium già a 0,6.
Scegli la strength in base al lavoro
0,6 per un cambio di stile che lascia tutto al suo posto, 0,7 per piccoli cambiamenti di contenuto, da 0,75 a 0,8 per una nuova versione della scena, da 0,85 in su per un’immagine nuova.
Usa LoRA per Base
Un LoRA addestrato su Z-Image Turbo ha rovinato l’immagine su questa versione nel nostro test. Usa file addestrati su Z-Image Base.
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-base-lora/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.













