Référence API de FLUX 3

Une seule clé API PopNow suffit pour appeler FLUX 3 depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur: Black Forest Labs
Résultat: Vidéo
À partir de: 9 crédits par seconde produite ($0.09)
Identifiants de modèle: black-forest-labs/flux-3/upscale
black-forest-labs/flux-3/text-to-video
black-forest-labs/flux-3/image-to-video
black-forest-labs/flux-3/video-extend

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Agrandir une vidéo

black-forest-labs/flux-3/upscale

Prix

Option	Crédits (par seconde produite)	Dollars US
`precise`	79.2	$0.792
`creative`	113.76	$1.1376

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`video_url`Obligatoire	`string (uri)`	—	—	The clip to upscale, an MP4 of up to 20 seconds. Billed by its length, rounded up to whole seconds.
`upscale_mode`Facultatif	`string`	`precise`	precise, creative	precise stays faithful to the source; creative also rebuilds fine detail and costs more.
`upscale_factor`Facultatif	`number`	`2`	de 1.5 à 3	How many times larger, from 1.5 to 3. The aspect ratio is kept and the factor does not change the price.
`prompt`Facultatif	`string`	—	jusqu’à 5 000 caractères	Optional, creative mode only: the detail you want added, such as skin texture or fabric weave.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans video_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

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-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"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

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"

Créer une vidéo

black-forest-labs/flux-3/text-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`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

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 5 000 caractères	Describe the subject, action, camera, light and sound for the shot.
`aspect_ratio`Facultatif	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1	Output aspect ratio.
`quality`Facultatif	`string`	`standard`	standard, draft	standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p.
`resolution`Facultatif	`string`	`720p`	720p, 1080p	Output resolution. draft renders at 720p only.
`duration_seconds`Facultatif	`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_audio`Facultatif	`boolean`	`true`	—	Generate synchronized sound with the video. The price is the same either way.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans 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-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"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

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"

Image vers vidéo

black-forest-labs/flux-3/image-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`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

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 5 000 caractères	Describe the subject, action, camera, light and sound for the shot.
`image_url`Obligatoire	`string (uri)`	—	—	Opening frame. The subject keeps its look from this image.
`last_image_url`Facultatif	`string (uri)`	—	—	Optional closing frame: the clip moves from the opening image to this one.
`aspect_ratio`Facultatif	`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.
`quality`Facultatif	`string`	`standard`	standard, draft	standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p.
`resolution`Facultatif	`string`	`720p`	720p, 1080p	Output resolution. draft renders at 720p only.
`duration_seconds`Facultatif	`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_audio`Facultatif	`boolean`	`true`	—	Generate synchronized sound with the video. The price is the same either way.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

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-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"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

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"

Prolonger une vidéo

black-forest-labs/flux-3/video-extend

Prix

Option	Crédits (par seconde produite)	Dollars US
`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

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 5 000 caractères	Describe what happens next: the action, camera and sound that continue the clip.
`video_url`Obligatoire	`string (uri)`	—	—	The clip to continue, an MP4 of up to 15 seconds. The new segment picks up from its last frame.
`aspect_ratio`Facultatif	`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.
`quality`Facultatif	`string`	`standard`	standard, draft	standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p.
`resolution`Facultatif	`string`	`720p`	720p, 1080p	Output resolution. draft renders at 720p only.
`duration_seconds`Facultatif	`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_audio`Facultatif	`boolean`	`true`	—	Generate synchronized sound with the video. The price is the same either way.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans video_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

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-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"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

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"

Référence API de FLUX 3

En bref

Agrandir une vidéo

Prix

Paramètres

Exemple de requête

Créer une vidéo

Prix

Paramètres

Exemple de requête

Image vers vidéo

Prix

Paramètres

Exemple de requête

Prolonger une vidéo

Prix

Paramètres

Exemple de requête

Pour aller plus loin

Sur cette page