Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
prompt | Sì | Describe the subject, action, camera, light and sound for the shot. |
quality | No | Più tempo e prezzo per dettagli più fini. standard · draft · Predefinito: standard |
resolution | No | Dimensione dell'output. Più grande è più nitido e costa di più. 720p · 1080p · Predefinito: 720p |
aspect_ratio | No | La forma dell'inquadratura: larga, quadrata o verticale. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1 · Predefinito: 16:9 |
generate_audio | No | Aggiunge un audio adatto all'immagine: voci, ambiente ed effetti. Predefinito: true |
duration_seconds | No | Quanto dura la clip. Si paga al secondo. 5–20 · Predefinito: 5 |
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 al secondo | ≈ USD |
|---|---|---|
| quality draft · resolution 1080p | 9 | 0,09 USD |
| quality draft · resolution 720p | 9 | 0,09 USD |
| quality standard · resolution 720p | 25,5 | 0,26 USD |
| quality standard · resolution 1080p | 43,5 | 0,44 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 3 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-3/text-to-video 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-3/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"quality": "standard",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 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 3
Quanto costa l’API di FLUX 3?
FLUX 3 costa da 45 crediti (0,45 USD) per una clip di 5 secondi con Crea video, il suo task più economico. Prezzi per opzione: draft · 1080p 9 crediti al secondo, draft · 720p 9 crediti al secondo, standard · 720p 25,5 crediti al secondo, standard · 1080p 43,5 crediti al secondo. 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 3 nell’API?
Inserisci black-forest-labs/flux-3/text-to-video per Crea video; black-forest-labs/flux-3/image-to-video per Da immagine a video; black-forest-labs/flux-3/video-extend per Allunga video; black-forest-labs/flux-3/upscale per Ingrandisci video nel campo model di POST /jobs/createTask.
L’estensione video restituisce l’intera clip?
No. Il risultato contiene solo il segmento appena generato, non la tua clip di partenza, quindi unisci le due parti in un editor. Il nuovo segmento parte dall’ultimo fotogramma della sorgente; nel nostro test è iniziato con una breve dissolvenza per poi passare all’azione successiva.
Posso fare un’unica inquadratura lunga di 20 secondi?
Puoi chiedere fino a 20 secondi, ma il modello può comunque tagliare o sfumare dentro la clip, soprattutto quando luce o azione cambiano molto. Per avere più controllo, crea clip più brevi e concatenale con l’estensione.
Posso indicare un ultimo fotogramma?
Sì, nel da immagine a video. La clip passa dalla prima immagine all’ultima. Se i due fotogrammi differiscono molto per luce o luogo, il modello può usare uno stacco netto a metà invece di un cambiamento graduale, quindi tieni i fotogrammi vicini quando vuoi un passaggio fluido.
Quali sono i limiti dell’API di FLUX 3?
Durata della clip: 5–20 s; Risoluzioni: 720p · 1080p; Proporzioni: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1; Lunghezza del prompt (caratteri): 5,000. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare FLUX 3 senza scrivere codice?
Sì. Il Playground esegue FLUX 3 con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli FLUX
LTX 2.5 arriva al 4K nativo e arriva anche a 20 secondi. FLUX 3 aggiunge un livello bozza economico più extend e upscale nello stesso posto.
- 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

