Informazioni su FLUX.1 Dev ControlNet LoRA
FLUX.1 Dev ControlNet LoRA genera immagini con FLUX.1 [dev] di Black Forest Labs, guidato da ControlNet Union Pro 2.0 di Shakker Labs, con fino a tre file LoRA addestrati per FLUX.1 dev. Un’unica immagine di controllo (uno scheletro di posa, una mappa di profondità, linee canny o soft edge, oppure una foto in scala di grigi) fissa la composizione; il prompt decide tutto il resto, e nulla viene filtrato.
Lo chiami con il nome di modello black-forest-labs/flux-1-dev-controlnet-lora/text-to-image su POST /jobs/createTask, da 6 crediti per immagine (0,06 USD). I nuovi account ricevono 30 crediti gratuiti per provarlo prima nel Playground.
Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
control_guidance_end | No | Fraction of the denoising steps at which the control image stops applying, from 0 to 1; not before the start. ≥ 0 · ≤ 1 · Predefinito: 0.8 |
control_guidance_start | No | Fraction of the denoising steps at which the control image starts to apply, from 0 to 1. ≥ 0 · ≤ 1 · Predefinito: 0 |
control_image_url | Sì | Control image: a pose skeleton, depth map, canny or soft-edge line map, or a grayscale or plain photo. The result keeps its aspect ratio. |
control_strength | No | How strongly the result follows the control image, from 0 to 1. ≥ 0 · ≤ 1 · Predefinito: 0.7 |
guidance_scale | No | Quanto rigidamente il modello segue il prompt. ≥ 0 · ≤ 20 · Predefinito: 3.5 |
loras | No | Carica i tuoi file LoRA per fissare uno stile o un personaggio. Predefinito: [] |
num_outputs | No | Quanti risultati creare in una volta. ≥ 1 · ≤ 4 · Predefinito: 1 |
output_format | No | Tipo di file del risultato. jpeg · png · webp · Predefinito: jpeg |
prompt | Sì | Describe the picture you want: subject, clothing, setting and light. The control image only sets the layout. |
resolution | No | Dimensione dell'output. Più grande è più nitido e costa di più. 1k · 1.5k · Predefinito: 1k |
seed | No | Lo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647 |
steps | No | Più passaggi aggiungono dettaglio ma richiedono più tempo. ≥ 1 · ≤ 50 · Predefinito: 28 |
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.
| Opzione | Crediti per immagine | ≈ USD |
|---|---|---|
| Standard | 5,4 | 0,054 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 6 crediti per immagine (0,06 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 FLUX.1 Dev ControlNet LoRA in tre passaggi
- 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.
- Invia la richiesta. Invia POST /jobs/createTask con model black-forest-labs/flux-1-dev-controlnet-lora/text-to-image e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- 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": "black-forest-labs/flux-1-dev-controlnet-lora/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"control_image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "1k",
"num_outputs": 1,
"output_format": "jpeg"
}
}'
# 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 FLUX.1 Dev ControlNet LoRA
Quanto costa l’API di FLUX.1 Dev ControlNet LoRA?
FLUX.1 Dev ControlNet LoRA costa 6 crediti (0,06 USD) 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 FLUX.1 Dev ControlNet LoRA nell’API?
Inserisci black-forest-labs/flux-1-dev-controlnet-lora/text-to-image per Crea immagine nel campo model di POST /jobs/createTask.
Che cos’è un’immagine di controllo?
Una mappa della struttura che vuoi ottenere: uno scheletro di posa colorato, una mappa di profondità in scala di grigi, linee canny o soft edge bianche su nero, oppure una foto in scala di grigi. Il modello ne copia composizione e posa e prende tutto il resto dal prompt.
Rileva lui la posa o la profondità al posto mio?
No. Invia direttamente la mappa. Anche una foto normale viene accettata, ma vincola l’immagine come farebbe una mappa in scala di grigi, quindi contorni e forme degli abiti si riportano nel risultato.
Quali LoRA funzionano qui?
I LoRA addestrati per FLUX.1 dev, passati come link di download diretto al file .safetensors. Nei nostri test un LoRA per SDXL ha fatto fallire la richiesta, quindi controlla il modello base nella pagina del LoRA prima di caricarlo.
Posso usare le immagini a fini commerciali?
La licenza FLUX.1 [dev] di Black Forest Labs consente di usare le immagini generate per scopi personali, scientifici e commerciali. La licenza di ogni LoRA che carichi è decisa dal suo autore, quindi controlla la relativa scheda del modello.
Quali sono i limiti dell’API di FLUX.1 Dev ControlNet LoRA?
Risoluzioni: 1K · 1.5K; Risultati per chiamata: 1–4; Lunghezza del prompt (caratteri): 5,000; Caricamento massimo: 10 MB. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare FLUX.1 Dev ControlNet LoRA senza scrivere codice?
Sì. Il Playground esegue FLUX.1 Dev ControlNet LoRA con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli FLUX
FLUX.1 Dev LoRA non ha un'immagine di controllo e va bene per la composizione libera.
- API di FLUX.2 MaxIl FLUX di punta: luce fotorealistica e colori di brand esattiDa 11 crediti per immagine
- API di FLUX 3Video con audio sincronizzato e un livello bozza veloceDa 45 crediti per una clip di 5 secondi
- API di FLUX.2 Klein 9B LoRAFLUX.2 Klein 9B veloce che carica fino a tre tue LoRADa 3 crediti per immagine
- API di FLUX.2 Klein Base 9B LoRAKlein 9B non distillato per look vari con le tue LoRADa 4 crediti per immagine
- API di FLUX.2 Klein 4B LoRAFLUX.2 Klein 4B piccolo e veloce con le tue LoRADa 3 crediti per immagine
- API di FLUX.2 Klein Base 4B LoRAKlein 4B non distillato che carica le tue LoRADa 3 crediti per immagine
- API di FLUX.2 Klein 9BModifiche FLUX veloci che preservano volti e poseDa 2 crediti per immagine
- API di FLUX.2 Klein 4BIl FLUX più piccolo e rapido, per bozze velociDa 2 crediti per immagine
- API di FLUX.2 Dev LoRAImmagini e modifiche FLUX.2 Dev con le tue LoRADa 4 crediti per immagine
- API di FLUX.2 ProImmagini fotorealistiche con testo leggibile e colori in esadecimaleDa 5 crediti per immagine
- API di FLUX.2 FlexScrive titoli ed etichette esattamente come li hai scrittiDa 9 crediti per immagine
- API di FLUX.2 DevFLUX a pesi aperti che unisce più persone in una scenaDa 2 crediti per immagine
- API di FLUX.1 Krea Dev LoRAFLUX.1 Krea fotografico con le tue LoRADa 4 crediti per immagine
- API di FLUX.1 Dev ControlNet LoRAControllo di posa, profondità o contorni su FLUX.1, con le tue LoRADa 6 crediti per immagine
- API di FLUX.1 Fill Dev LoRAInpainting a maschera su FLUX.1 Fill con le tue LoRADa 7 crediti per immagine
- API di FLUX.1 Dev LoRAIl classico FLUX.1 Dev con fino a tre tue LoRADa 3 crediti per immagine
- API di FLUX.1 Schnell LoRAFLUX.1 Schnell veloce che carica le tue LoRADa 1 credito per immagine

