FLUX 3 API-Referenz
Video mit synchronem Ton und schneller Entwurfsstufe
Mit einem einzigen PopNow-API-Schlüssel rufst du FLUX 3 aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.
Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.
Auf einen Blick
- Hersteller
- Black Forest Labs
- Ergebnis
- Video
- Ab
- 9 Credits pro Sekunde Ergebnis ($0.09)
1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.
Video hochskalieren
black-forest-labs/flux-3/upscale
Preis
| Option | Credits (pro Sekunde Ergebnis) | US-Dollar |
|---|---|---|
precise | 79.2 | $0.792 |
creative | 113.76 | $1.1376 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
video_urlPflicht | string (uri) | — | — | The clip to upscale, an MP4 of up to 20 seconds. Billed by its length, rounded up to whole seconds. |
upscale_modeOptional | string | precise | precise, creative | precise stays faithful to the source; creative also rebuilds fine detail and costs more. |
upscale_factorOptional | number | 2 | 1.5 bis 3 | How many times larger, from 1.5 to 3. The aspect ratio is kept and the factor does not change the price. |
promptOptional | string | — | bis zu 5.000 Zeichen | Optional, creative mode only: the detail you want added, such as skin texture or fabric weave. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
Das Beispiel nutzt in video_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.
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-3/upscale",
"input": {
"prompt": "Sharpen fine detail and keep the natural look",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"upscale_mode": "precise"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Video erstellen
black-forest-labs/flux-3/text-to-video
Preis
| Option | Credits (pro Sekunde Ergebnis) | US-Dollar |
|---|---|---|
quality = draft, resolution = 1080p | 9 | $0.09 |
quality = draft, resolution = 720p | 9 | $0.09 |
quality = standard, resolution = 720p | 25.5 | $0.255 |
quality = standard, resolution = 1080p | 43.5 | $0.435 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 5.000 Zeichen | Describe the subject, action, camera, light and sound for the shot. |
aspect_ratioOptional | string | 16:9 | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1 | Output aspect ratio. |
qualityOptional | string | standard | standard, draft | standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p. |
resolutionOptional | string | 720p | 720p, 1080p | Output resolution. draft renders at 720p only. |
duration_secondsOptional | integer | 5 | 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, … (+2) | Output length in whole seconds, 5 to 20. |
generate_audioOptional | boolean | true | — | Generate synchronized sound with the video. The price is the same either way. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
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-3/text-to-video",
"input": {
"prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
"duration_seconds": 5,
"resolution": "720p",
"quality": "standard"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Bild zu Video
black-forest-labs/flux-3/image-to-video
Preis
| Option | Credits (pro Sekunde Ergebnis) | US-Dollar |
|---|---|---|
quality = draft, resolution = 1080p | 9 | $0.09 |
quality = draft, resolution = 720p | 9 | $0.09 |
quality = standard, resolution = 720p | 25.5 | $0.255 |
quality = standard, resolution = 1080p | 43.5 | $0.435 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 5.000 Zeichen | Describe the subject, action, camera, light and sound for the shot. |
image_urlPflicht | string (uri) | — | — | Opening frame. The subject keeps its look from this image. |
last_image_urlOptional | string (uri) | — | — | Optional closing frame: the clip moves from the opening image to this one. |
aspect_ratioOptional | string | — | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1 | Output aspect ratio. Omit it to follow the opening image. |
qualityOptional | string | standard | standard, draft | standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p. |
resolutionOptional | string | 720p | 720p, 1080p | Output resolution. draft renders at 720p only. |
duration_secondsOptional | integer | 5 | 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, … (+2) | Output length in whole seconds, 5 to 20. |
generate_audioOptional | boolean | true | — | Generate synchronized sound with the video. The price is the same either way. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
Das Beispiel nutzt in image_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.
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-3/image-to-video",
"input": {
"prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"duration_seconds": 5,
"resolution": "720p",
"quality": "standard"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Video verlängern
black-forest-labs/flux-3/video-extend
Preis
| Option | Credits (pro Sekunde Ergebnis) | US-Dollar |
|---|---|---|
quality = draft, resolution = 1080p | 18 | $0.18 |
quality = draft, resolution = 720p | 18 | $0.18 |
quality = standard, resolution = 720p | 61.5 | $0.615 |
quality = standard, resolution = 1080p | 79.5 | $0.795 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 5.000 Zeichen | Describe what happens next: the action, camera and sound that continue the clip. |
video_urlPflicht | string (uri) | — | — | The clip to continue, an MP4 of up to 15 seconds. The new segment picks up from its last frame. |
aspect_ratioOptional | string | — | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1 | Output aspect ratio. Omit it to keep the shape of the source clip. |
qualityOptional | string | standard | standard, draft | standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p. |
resolutionOptional | string | 720p | 720p, 1080p | Output resolution. draft renders at 720p only. |
duration_secondsOptional | integer | 5 | 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, … (+2) | Length of the new segment in whole seconds, 5 to 20. The source clip is not included in the result. |
generate_audioOptional | boolean | true | — | Generate synchronized sound with the video. The price is the same either way. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
Das Beispiel nutzt in video_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.
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-3/video-extend",
"input": {
"prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"duration_seconds": 5,
"resolution": "720p",
"quality": "standard"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"