Introduzione
Qwen Image 2.1 LoRA Editing applica i tuoi pesi LoRA mentre rielabora da una a dieci immagini di riferimento. È lo stesso impianto a pesi personalizzati dell'endpoint text-to-image, puntato su lavori che hai già invece che su un'inquadratura vuota.
Non c'è revisione dei pesi che carichi e non c'è filtro sui contenuti del risultato.
Scegli la modalità di Qwen Image 2.1 LoRA in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| Immagini sorgente più i tuoi pesi | Qwen Image 2.1 LoRA Modifica immagine |
| Un brief più i tuoi pesi | Qwen Image 2.1 LoRA Testo in immagine |
| Modifica senza pesi personalizzati | Qwen Image 2.1 Modifica immagine |
Caratteristiche principali
Porta un LoRA di personaggio su un lavoro già avviato
Un LoRA con cui puoi solo iniziare qualcosa di nuovo serve molto meno di uno che puoi applicare a un'inquadratura già approvata. Questo endpoint accetta entrambe le cose: fino a dieci riferimenti e fino a tre file di pesi nella stessa richiesta.
Pesi e riferimenti risolvono due metà diverse della coerenza
I riferimenti tengono la composizione, l'ambiente e l'inquadratura specifica; il LoRA tiene l'identità su ogni inquadratura. Usarli insieme è più stabile che appoggiarsi troppo a uno solo dei due.
Senza censura da entrambi i lati
Nessuna revisione dei pesi, nessun filtro sull'output, e una sorgente resta com'è se l'istruzione non dice diversamente.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. In questa famiglia non c'è un negative prompt, quindi anche le esclusioni stanno qui. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Da una a dieci immagini di riferimento. Il modello non assegna i ruoli da solo, quindi dichiara nel prompt che cosa porta ogni sorgente. almeno 1 elementi · al massimo 10 elementi |
aspect_ratio | No | Compone l'inquadratura prima della generazione invece di ritagliarla dopo. Quindici opzioni, dalle strisce 3:1 e 21:9 alle colonne 1:3 e 9:21. |
resolution | No | Fissa dimensione dell'output e prezzo: 1k di default, 1.5k in mezzo, 2k dove la grana della pelle e i tessuti reggono. Itera a 1k, promuovi a 2k l'immagine che tieni. |
loras | No | Fino a tre file di pesi, ciascuno {path, scale}. Predefinito: |
output_format | No | JPEG di default; PNG per il compositing, WebP per andare dritti in pagina. Non cambia né il prezzo né la resa. |
seed | No | Stabilizza l'estrazione, così una serie resta nella stessa zona. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.042 / immagine |
| $0.078 / immagine |
| $0.15 / immagine |
Casi d’uso
Applicare un LoRA di personaggio a scatti già approvati
La parte costosa di uno shooting raramente è la generazione: è arrivare a un'inquadratura su cui tutti sono d'accordo. Questo endpoint ti permette di tenere quell'inquadratura e cambiare chi c'è dentro: manda la composizione approvata come riferimento, carica il LoRA di personaggio e lascia che siano i pesi a portare l'identità, mentre luce, messa in scena e taglio restano esattamente dove erano.
Riportare un archivio nello stile attuale della casa
Punta un LoRA di stile su lavori generati mesi fa. Manda le vecchie inquadrature come riferimenti, carica i pesi di stile a un'intensità moderata e rigenerale, così uno scatto d'archivio e uno nuovo stanno sulla stessa pagina senza una cucitura evidente in mezzo.
Scene costruite da un riferimento che controlli
Parti da una figura che hai già generato e aggiungi il secondo soggetto, l'abbigliamento, la costrizione o l'ambiente. Le istruzioni vengono eseguite come sono scritte e i pesi senza censura si caricano senza revisione, quindi la scena si può montare per passi invece di giocarsela tutta in un solo prompt.
Cambi di abbigliamento e di ambiente con la persona fissa
Due riferimenti — uno che porta la persona, uno che porta il capo o la stanza — più un LoRA di personaggio, e un prompt che dice quale sorgente è quale. Cambia la stanza, tieni il volto; cambia l'outfit, tieni tutti e due.
Consigli avanzati
Dichiara che cosa porta ogni riferimento prima di dichiarare la modifica
Il modello non deduce i ruoli dall'ordine o dal nome del file. Scrivilo per esteso: «la prima immagine è la donna, la seconda è la stanza in cui si trova, la terza è il cappotto». Senza quella frase una richiesta con più riferimenti fonde le sorgenti invece di usarle per modificare, e il risultato sembra un artefatto da media aritmetica più che un errore che puoi debuggare.
Non far descrivere la stessa cosa al prompt e al LoRA
Quando è caricato un LoRA di personaggio, descrivi la scena, l'azione e la luce, non il volto. Ripetere i tratti che i pesi già codificano tira la resa in due direzioni e di solito produce qualcosa che non somiglia a nessuna delle due. Lascia al LoRA l'identità e al prompt tutto ciò che le sta intorno.
Metti le protezioni nell'istruzione, perché non c'è un negative prompt
Di' chiaramente che cosa deve sopravvivere alla modifica: «mantienila esattamente come nella sorgente, senza aggiungere nulla al suo abbigliamento» oppure «non cambiare la lunghezza dei capelli». Un modello di modifica lasciato al proprio giudizio mette in ordine cose che non gli hai chiesto di sistemare, e sul lavoro per adulti quel mettere in ordine è esattamente il modo in cui fallisce.
Calcola il prezzo prima di inviare, non dopo
Qui il costo è mosso da due cose insieme: il numero di riferimenti e la fascia di risoluzione, con sopra il sovrapprezzo dei LoRA. Dieci riferimenti con tre LoRA a 2k è la forma più costosa che questa famiglia accetti. La stima mostrata prima dell'invio fa fede: leggila sulle richieste grandi invece di dare per scontato che sia solo la fascia a fissare il prezzo.
Verifica che un LoRA nuovo cambi qualcosa prima di affidargli un lotto
I pesi costruiti per un'architettura base diversa possono caricarsi senza errori e avere un effetto visibile quasi nullo. Lancia un prompt volutamente vistoso sui pesi nuovi, verifica che l'output si sia spostato, e solo dopo metti in coda il lotto.
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/qwen-image-2.1-lora/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"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.
