Cosa succede se l'URL dei pesi è sbagliato?

La richiesta viene accettata e torna un identificativo di attività: all'invio di path non si convalida nulla. L'errore arriva quando parte la generazione e il suo messaggio non nomina alcuna causa, perciò un percorso scritto male, un link firmato scaduto e un repository passato in privato sono indistinguibili dalla sola risposta. Un'attività che fallisce così non viene addebitata.

Come faccio a sapere se un LoRA è stato davvero scaricato?

Confrontate la durata con quella della stessa richiesta con loras vuoto. Il file viene tirato giù prima della generazione, quindi una chiamata con pesi dura sensibilmente di più: nelle nostre prove un render con array vuoto si chiudeva in otto-undici secondi, quelle con pesi in ventinove e trentasette, la più lunga con un file da 1,18 GB. Una chiamata che finisce alla velocità di riferimento non ha caricato nulla di nuovo.

Caricare tre LoRA costa più che caricarne uno?

No. Il preventivo di questo endpoint si muove con il livello di risoluzione e con nient'altro, quindi una voce e tre voci allo stesso livello danno lo stesso importo. A regolare è la stima in tempo reale mostrata più in alto in questa pagina. Aggiungere i file uno alla volta si giustifica con l'attribuzione del risultato, non con il costo.

In cosa differisce da Qwen Image 2.1 senza LoRA?

Di un campo. Le due famiglie pubblicano lo stesso limite di prompt, le stesse quindici proporzioni, gli stessi tre livelli di risoluzione, gli stessi contenitori di uscita e lo stesso intervallo di seed; questa aggiunge un array loras con al massimo tre voci {path, scale}. Una richiesta scritta per la famiglia base gira qui senza modifiche non appena quell'array è agganciato.

Ci sono pesi che questo endpoint si rifiuta di caricare?

Davanti all'array non c'è né un elenco di consentiti né un passaggio di revisione, nemmeno per pesi con contenuti senza censura: abbiamo percorso proprio quel caso e si è svolto come qualunque altra richiesta. Cosa fa un file una volta caricato è un'altra questione: pesi addestrati per un'altra generazione del modello base possono essere scaricati senza errori e lasciare comunque l'immagine quasi dov'era.

I pesi caricati limitano la proporzione o il livello?

No. loras sta accanto ai controlli di inquadratura e dimensione, non in cambio di essi: le quindici proporzioni e i tre livelli restano disponibili anche con tre file caricati. Chiudete i pesi al livello predefinito, poi alzate il livello della richiesta finita senza toccare l'array.

API di Qwen Image 2.1 LoRA: immagini NSFW, i tuoi pesi

alibaba/qwen-image-2.1-lora/text-to-image

Il text-to-image Qwen Image 2.1 LoRA rende un prompt fino a 5.000 caratteri con fino a tre tuoi pesi LoRA, ciascuno con intensità da 0 a 4. Scegli 1k, 1.5k o 2k in quindici proporzioni, senza alcuna revisione dei pesi.

Da $0.03/immagine

Esegui il modello Vedi l’API

Input

Da testo a immagine

Testo del prompt445/5000

Proporzioni

Risoluzioneincide sul prezzo

LoRA di stile1/3

2512 Storybook Anime

Formato di output

JPEGPNGWebP

Seed

Controllo di sicurezzaDisattivato

SpicyAPI non applica nessun controllo di sicurezza a questo modello. Il tuo prompt e i tuoi media arrivano al modello così come li hai scritti, ed è il modello stesso a decidere che cosa torna indietro.

Controllo del tuo account prima di abilitare invio e prezzi.

Output

Pronto per una nuova esecuzione

Risultato di esempio

Anima

Modifica

Separa in livelli

{
  "model": "alibaba/qwen-image-2.1-lora/text-to-image",
  "input": {
    "aspect_ratio": "3:4",
    "resolution": "1k",
    "loras": [
      {
        "path": "https://huggingface.co/neonforestmist/qwen-image-2512-storybook-anime-lora/resolve/main/qwen_image_2512_storybook_anime_lora.safetensors",
        "scale": 1
      }
    ],
    "output_format": "jpeg",
    "prompt": "storybook anime illustration of a grown woman in her early thirties with mature features, a long face, defined cheekbones and a calm confident gaze, tall and long-limbed, wearing an oversized cream knit sweater slipping off one shoulder and long knit socks, curled up on a rainy window seat with a cup of tea, looking back at the viewer with a knowing smile. Warm lamp inside, rain streaking the glass, honey and slate palette, soft cel shading."
  }
}

Introduzione

Qwen Image 2.1 LoRA Text to Image fa girare il più recente modello di immagini a pesi aperti di Alibaba con i tuoi pesi LoRA caricati sopra: fino a tre file per richiesta, ciascuno con la propria intensità.

Qui un LoRA è un URL, non un upload. Non c'è revisione dei pesi a cui punti e non c'è filtro su ciò che torna indietro, ed è questo a rendere il servizio utilizzabile proprio con i pesi che la maggior parte delle API ospitate esclude in silenzio.

Scegli la modalità di Qwen Image 2.1 LoRA in base al materiale di partenza

Materiale di partenza	Modalità
Un brief più i tuoi pesi	Qwen Image 2.1 LoRA Testo in immagine
Immagini sorgente più i tuoi pesi	Qwen Image 2.1 LoRA Modifica immagine
Nessun peso personalizzato	Qwen Image 2.1 Testo in immagine

Caratteristiche principali

Nessun upload, nessuna allow-list, nessuna coda di approvazione

Quasi tutte le API ospitate che accettano pesi personalizzati li vogliono caricati, revisionati o scelti da un elenco curato, il che esclude proprio i pesi che la maggior parte delle persone vuole usare. Qui indichi un link diretto a un file .safetensors o a un repository Hugging Face e un'intensità, e il file viene scaricato quando la richiesta parte. Abbiamo verificato il caso che conta davvero con un LoRA dichiaratamente per adulti: si è caricato e ha generato senza fare storie.

Tre slot, intensità indipendenti

Tre voci per chiamata, ciascuna con il proprio scale da 0 a 4, coprono lo stack che la produzione usa davvero: un LoRA di personaggio che tiene la persona, un LoRA di stile della casa a un peso più basso che colora l'inquadratura, un LoRA di dettaglio per pelle o tessuti. Cambia uno scale per volta: muoverne due insieme ti lascia senza modo di attribuire il risultato.

Anche il modello base sotto è senza censura

I pesi sono solo metà della storia. Il modello su cui si appoggiano non ha filtro sui contenuti, né flag per adulti, né analisi del prompt, quindi un LoRA per adulti non deve combattere contro un filtro in uscita.

Parametri della richiesta

Parametri della richiesta di Qwen Image 2.1 LoRA · Text to Image
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
`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. `1:1` · `16:9` · `9:16` · `4:3` · `3:4` · `3:2` · `2:3` · `21:9` · `9:21` · `2:1` · `1:2` · `3:1` · `1:3` · `5:4` · `4:5` · Predefinito: `1:1`
`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. `1k` · `1.5k` · `2k` · Predefinito: `1k`
`loras`	No	Fino a tre file di pesi, ciascuno {path, scale}. Predefinito: `[]` al massimo 3 elementi
`output_format`	No	JPEG di default; PNG per il compositing, WebP per andare dritti in pagina. Non cambia né il prezzo né la resa. `jpeg` · `png` · `webp` · Predefinito: `jpeg`
`seed`	No	Stabilizza l'estrazione, così una serie resta nella stessa zona. `≥ 0` · `≤ 2147483647`

Prezzi

Prezzi
Specifiche	Prezzo
`1k`	$0.03 / immagine
`1.5k`	$0.054 / immagine
`2k`	$0.102 / immagine

Casi d’uso

LoRA senza censura

I pesi di personaggio, di stile e non filtrati si caricano come qualsiasi altro file. Nessuna allow-list, nessuna revisione, nessun filtro sull'output.

Personaggi coerenti su larga scala

Un LoRA di personaggio tiene un volto e un corpo su centinaia di inquadrature in modo molto più affidabile dei seed o del concatenamento di riferimenti.

Stile della casa sopra un modello generalista

Un LoRA di stile addestrato sul tuo catalogo fa sembrare l'output tuo invece che un render generico.

Stack di produzione

Pesi di personaggio, stile e dettaglio insieme in un'unica richiesta, ciascuno con la propria intensità.

Esplora i tutorial sui casi d’uso principali

Consigli avanzati

Lascia lavorare i pesi

Descrivi la scena, non ciò che il LoRA già sa. Ripetere i tratti di un personaggio quando è caricato un LoRA di personaggio tende a contrastarlo invece che a rafforzarlo.

Parti da 1, poi muovi un solo valore

scale 1 è neutro. Scendi a 0,4-0,6 quando un peso sovrasta il prompt; supera 1 quando deve sopravvivere a una scena affollata. Una modifica per volta.

Metti in conto la prima chiamata

I pesi vengono scaricati prima della generazione. Nei nostri test un file da 1,2 GB ha aggiunto circa 25 secondi a quella richiesta. Le chiamate successive con lo stesso file sono più veloci.

Verifica che un LoRA nuovo faccia qualcosa

I pesi per un'architettura base diversa possono caricarsi senza errori e incidere pochissimo sull'immagine. Fai una prova con un prompt vistoso prima di lanciare un intero 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/text-to-image",
  "input": {
    "aspect_ratio": "1:1",
    "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.

Modelli correlati e attività successive

Manca il modello che ti serve?

Dicci cosa aggiungere e dove lo useresti. Le richieste arrivano a chi decide quali modelli integrare per primi.

L'URL dei pesi è una dipendenza, non un parametro

Qwen Image 2.1 LoRA rende un prompt caricando sopra il modello base fino a tre file di pesi vostri, e ciascuno viene scaricato al momento della generazione da un link che ospitate voi. Quando la richiesta viene accettata di quel link non si verifica nulla: un refuso, una firma scaduta o un repository passato in privato tornano tutti più tardi come lo stesso errore senza spiegazione. Questa pagina riguarda la metà dell'integrazione che sta dalla vostra parte dell'URL: come distinguere un link morto da pesi che non fanno presa, e da cosa dipendono davvero la forma della richiesta e il preventivo.

Apri il playground

L'URL dei pesi è una dipendenza, non un parametro

Voci LoRA: Fino a 3 per richiesta, ciascuna {path, scale}; scale da 0 a 4, valore predefinito 1
Origine dei pesi: Link HTTPS diretto a un file .safetensors, oppure un repository Hugging Face
Verifica del link: Nessuna all'invio; un percorso sbagliato emerge solo dopo, come attività fallita
Variabili del preventivo: Solo il livello di risoluzione: una voce costa quanto tre
Forma della richiesta: prompt obbligatorio, 5.000 caratteri; più proporzione, livello, formato e seed
Dichiarazione di contenuto: Nessun indicatore di maturità e nessuna revisione dei pesi che indicate

Forma dell'errore: Il link si legge all'esecuzione, non all'accettazioneUna richiesta con un percorso irraggiungibile o scritto male viene accettata come qualsiasi altra e restituisce un identificativo di attività. L'errore arriva in fase di inferenza e non nomina alcuna causa: nulla al suo interno punta al file, quindi la diagnosi parte per forza da voi. Un'attività che fallisce così non viene addebitata, il che rende economico provare ma non lo rende evidente.
Indizio: Il tempo trascorso dice se i pesi sono stati davvero scaricatiIl file viene tirato giù prima che esista un solo pixel, quindi una chiamata con pesi dura sensibilmente più di una senza. Nelle nostre prove un render con l'array vuoto si chiudeva in otto-undici secondi, mentre lo stesso prompt con pesi caricati ha richiesto ventinove secondi in un caso e trentasette nell'altro, con il più lungo corrispondente a un file da 1,18 GB.
Posti: Tre voci costano esattamente quanto unaIl preventivo di questo endpoint si muove con il livello di risoluzione e con nient'altro, quindi una richiesta che porta tre file di pesi costa quanto una che ne porta uno solo. Caricarne meno non fa risparmiare nulla. Il motivo per aggiungerli uno alla volta è l'attribuzione — poter dire quale file ha fatto cosa — non la fattura.

Integrare l'API di Qwen Image 2.1 LoRA

Distinguere un link morto da pesi che non fanno presa

A schermo i due problemi si somigliano: l'immagine torna identica. A separarli è la durata. Una chiamata che si chiude alla velocità di riferimento non ha scaricato nulla, e l'indiziato è il percorso. Una chiamata durata a lungo che ha comunque restituito un fotogramma immobile ha caricato il file; quello che succede dopo dipende da per quale generazione del modello base quei pesi sono stati addestrati e da quanto si impongono su questa.

Tenere un file già collaudato come canarino

Poiché il messaggio di errore non nomina cause, la via più rapida per separare il vostro problema dal nostro è una seconda richiesta che carichi un file che avete già visto funzionare. Se il canarino rende e il percorso nuovo fallisce, il link è l'unica differenza. Se falliscono entrambi, la causa sta sopra di essi. Tenete quell'URL insieme al resto della configurazione, non negli appunti di qualcuno.

Ospitare i pesi come si ospitano gli asset statici
Il file viene scaricato in fase di generazione da dove puntate voi, il che colloca disponibilità, banda e durata del link dentro la vostra integrazione e non nella nostra. Link firmati che scadono, repository che passano in privato e rami che si spostano finiscono tutti in attività fallite. Ciò che regge un anno è un indirizzo pubblico stabile con una versione nel percorso.
Ogni campo tranne loras appartiene alla famiglia base
Lunghezza del prompt, le quindici proporzioni, i tre livelli di risoluzione, i contenitori di uscita e l'intervallo di seed sono identici a Qwen Image 2.1, e lo schema rifiuta qualunque campo non dichiari. Portare qui una richiesta che già funziona nella famiglia base significa agganciare un array, non riscrivere il corpo; e tornare indietro significa staccarlo.
I pesi per contenuti senza censura non chiedono un secondo interruttore
Non c'è un indicatore di maturità sulla richiesta né un passaggio di revisione davanti all'array, quindi quei pesi si caricano attraverso gli stessi due campi di qualsiasi altro file e il prompt viene letto allo stesso modo. Abbiamo percorso questa strada noi stessi invece di dedurla da una pagina di regole: i pesi sono stati scaricati, la richiesta è arrivata in fondo, e nulla è stato rifiutato o sostituito in silenzio.

Chi chiama l'API di Qwen Image 2.1 LoRA

Team che lo collegano a un servizio
Meglio fallire subito sul link che lentamente sull'attività
Una sola richiesta verso l'URL dei pesi al deploy non costa nulla e intercetta l'intera classe di errori che altrimenti si presenterebbe minuti dopo come un fallimento inspiegato. Verificatelo dove il servizio verifica le altre dipendenze esterne, non dentro il percorso della richiesta, e trattate un cambio di URL come un cambio di configurazione.
Chi sta valutando pesi nuovi
Spendere la prima chiamata su una domanda con risposta
Date al file nuovo, al livello predefinito, un prompt il cui risultato riconoscereste al volo, e guardate la durata quanto l'immagine. Quella singola chiamata risponde se il file era raggiungibile e se fa presa: le due cose che il messaggio d'errore non dirà mai e su cui poggia tutto il resto.
Studi con uno stack fisso
Fissare il file, non solo il repository
Pesi che si muovono sotto un indirizzo invariato cambiano il vostro risultato senza cambiare il vostro codice, e la risposta non ne farà parola. Puntate a qualcosa di immutabile — una revisione, un tag di rilascio, una copia in un vostro bucket — così che un render del mese scorso resti spiegabile con gli input da cui è nato.
Chi arriva dalla famiglia base
Agganciare un array e non toccare altro
La famiglia base e questa pubblicano gli stessi campi tranne loras, quindi un corpo di richiesta esistente gira qui così com'è non appena l'array viene aggiunto. Mandate lo stesso prompt con lo stesso seed a entrambe e leggete la coppia: la differenza fra i due fotogrammi è tutto il contributo dei pesi, ed è proprio ciò che una singola immagine non mostra.

Come chiamare l'API di Qwen Image 2.1 LoRA

Mettere i pesi dove restano raggiungibili
path accetta un link HTTPS diretto a un file .safetensors o a un repository Hugging Face. Qui non si carica nulla e da noi non resta nulla, quindi il file deve essere in linea nel momento in cui il lavoro parte, che è più tardi — a volte molto più tardi — del momento in cui inviate.
Mandare una voce prima di mandarne tre
Cominciate con un solo oggetto {path, scale} così che dietro al primo risultato ci sia esattamente una spiegazione. L'array ne accetta tre e il preventivo non si muove con il numero, ma un'immagine prodotta da tre file sconosciuti è un'immagine che non potete né motivare né ripetere.
Cronometrare la prima chiamata e annotare il numero
Lo scaricamento avviene prima della generazione, quindi la prima richiesta con un file nuovo dura sensibilmente più di una senza pesi. Quel numero è il riferimento di quel file. Le chiamate successive che non superano mai il tempo con array vuoto vi stanno parlando del link, non dei pesi.
Inviare l'attività e interrogarla fino allo stato finale
L'endpoint è asincrono: la risposta porta un identificativo e l'immagine arriva dopo. Interrogate finché l'attività raggiunge uno stato finale, poi leggete l'immagine dal risultato: viene servita dallo storage della piattaforma, non da dove stavano i pesi.
Alzare il livello di risoluzione per ultimo
Qui il livello è l'unico campo che muove il preventivo. Iterate sul predefinito finché formulazione e pesi si stanno ancora muovendo, e rimandate la richiesta definitiva a un livello più alto quando c'è qualcosa da consegnare. In quel momento dell'array non va rivisto nulla.

Schemi di integrazione di Qwen Image 2.1 LoRA

Un riferimento e una chiamata con pesi, a un campo di distanza
Mandate il prompt una volta con loras vuoto e una con una sola voce alla forza predefinita, fissando il seed e tutto il resto. Due immagini e due durate dalla stessa identica formulazione: è l'esperimento più piccolo che risponde a entrambe le domande insieme.
```
Full-length studio portrait of a woman in a tailored charcoal coat, plain seamless backdrop, soft key light from the left, sharp focus on the weave of the fabric
```
Un peso di stile sotto una scena descritta
Lasciate che il prompt porti la scena e il file porti la resa. Scrivere anche la resa a parole tende a tirare il render in due direzioni e a restituire qualcosa che non somiglia a nessuna delle due.
```
A rain-slicked side street at night seen from across the road, one lit shopfront, reflections stretching across the wet asphalt, no people in frame
```
La stessa richiesta su un'inquadratura molto più larga
La proporzione si sceglie prima della generazione e non si ritaglia dopo, quindi pesi che funzionano nel quadrato non funzionano automaticamente in una fascia. Rimandate la richiesta definitiva sulla proporzione più larga che intendete davvero consegnare.
```
A long marble counter running the full width of the frame, rows of glassware catching a single overhead light, deep shadow at both ends
```

Domande di integrazione su Qwen Image 2.1 LoRA

Prima di collegarlo

Trattate l'URL dei pesi come una dipendenza esterna del vostro servizio e non come un parametro in più nel corpo della richiesta. Verificate che risponda dove verificate le altre dipendenze, fissatelo su qualcosa di immutabile e tenete un file che avete già visto funzionare: così qualsiasi errore si divide fra la vostra parte e la nostra in una sola chiamata. Sulla richiesta stessa: una voce per volta, la durata letta insieme all'immagine, e il livello di risoluzione lasciato stare finché formulazione e pesi non hanno smesso di muoversi.

Tutti i modelli Qwen Image11

Confronti correlati

Qwen Image 2.1 LoRA vs Qwen Image 2512 LoRA Qwen Image 2.1 LoRA vs Qwen Image 1.0 LoRA

Guida ai LoRA

Migliori LoRA NSFW per Qwen Image 2.1

Playground