PopNowDocs API
Contenuto principale

Riferimento API di FLUX.1 Dev LoRA

Il classico FLUX.1 Dev con fino a tre tue LoRA

Con una sola chiave API di PopNow chiami FLUX.1 Dev LoRA dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da
Black Forest Labs
Risultato
Immagine
Da
2.7 crediti per immagine ($0.027)
Tempo tipico
circa 15 s

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Crea immagine

black-forest-labs/flux-1-dev-lora/text-to-image

Prezzo

OpzioneCrediti (per immagine)Dollari USA
Predefinito2.7$0.027

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 5000 caratteriDescribe the subject, composition and lighting. If a LoRA has a trigger word, put it first.
aspect_ratioFacoltativostring1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21Output aspect ratio.
lorasFacoltativoarray<object>[]fino a 3 elementiUp to three LoRA weight files, each with its own strength.
guidance_scaleFacoltativonumber3.5da 0 a 20How closely the image follows the prompt, from 0 to 20.
stepsFacoltativointeger28da 1 a 50Denoising steps, from 1 to 50. Fewer steps return faster and a little softer.
output_formatFacoltativostringjpegjpeg, png, webpContainer of the returned image.
seedFacoltativointeger—da 0 a 2147483647Random seed for controlled comparisons.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-1-dev-lora/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Modifica immagine

black-forest-labs/flux-1-dev-lora/edit

Prezzo

OpzioneCrediti (per immagine)Dollari USA
Predefinito2.7$0.027

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 5000 caratteriDescribe the whole image you want back; with a mask, describe what belongs in the white area.
image_urlObbligatoriostring (uri)——Source image to edit. The result keeps its shape.
mask_urlFacoltativostring (uri)——Optional black-and-white mask the size of the source: white areas are redrawn, black areas are kept.
strengthFacoltativonumber0.8da 0 a 1How far to move away from the source, from 0 to 1.
lorasFacoltativoarray<object>[]fino a 3 elementiUp to three LoRA weight files, each with its own strength.
guidance_scaleFacoltativonumber3.5da 0 a 20How closely the image follows the prompt, from 0 to 20.
stepsFacoltativointeger28da 1 a 50Denoising steps, from 1 to 50. Fewer steps return faster and a little softer.
output_formatFacoltativostringjpegjpeg, png, webpContainer of the returned image.
seedFacoltativointeger—da 0 a 2147483647Random seed for controlled comparisons.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in image_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-1-dev-lora/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Passi successivi

In questa pagina