Prendi la chiave API

di Black Forest Labs

Controllo di posa, profondità o contorni su FLUX.1, con le tue LoRA

black-forest-labs/flux-1-dev-controlnet-lora/text-to-imageDa 6 creditiper immagine · 0,06 USD
  • Fino a 1.5K
  • Fino a 4 per generazione
  • Carica i tuoi LoRA
  • Crea immagine
Atelier night grayscaleGuarda gli esempi

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

ParametroObbligatorioDescrizione
control_guidance_endNoFraction 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_startNoFraction of the denoising steps at which the control image starts to apply, from 0 to 1. ≥ 0 · ≤ 1 · Predefinito: 0
control_image_urlSì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_strengthNoHow strongly the result follows the control image, from 0 to 1. ≥ 0 · ≤ 1 · Predefinito: 0.7
guidance_scaleNoQuanto rigidamente il modello segue il prompt. ≥ 0 · ≤ 20 · Predefinito: 3.5
lorasNoCarica i tuoi file LoRA per fissare uno stile o un personaggio. Predefinito: []
num_outputsNoQuanti risultati creare in una volta. ≥ 1 · ≤ 4 · Predefinito: 1
output_formatNoTipo di file del risultato. jpeg · png · webp · Predefinito: jpeg
promptSìDescribe the picture you want: subject, clothing, setting and light. The control image only sets the layout.
resolutionNoDimensione dell'output. Più grande è più nitido e costa di più. 1k · 1.5k · Predefinito: 1k
seedNoLo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647
stepsNoPiù 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.

OpzioneCrediti per immagine≈ USD
Standard5,40,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

  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 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à.
  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": "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.

Altro su FLUX.1 Dev ControlNet LoRA