FLUX 3: dokumentacja API

Jednym kluczem API PopNow wywołasz FLUX 3 z własnego kodu. Znajdziesz tu identyfikatory modelu, które trzeba wysłać, każde pole wejściowe, koszt zapytania w kredytach i gotowe zapytanie do wklejenia w terminalu.

Opisy parametrów pochodzą ze schematu wejściowego modelu i są dostępne tylko po angielsku.

W skrócie

Twórca: Black Forest Labs
Wynik: Wideo
Od: 9 kr. za sekundę wyniku ($0.09)
Identyfikatory modelu: 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 kredyt = 0,01 USD. Po przyjęciu zadanie blokuje najwyższą możliwą kwotę, a na koniec rozlicza faktyczne zużycie, zaokrąglone w górę do pełnych kredytów; resztę zwalnia. Za zadania zakończone błędem nie płacisz. Dokładną kwotę przed uruchomieniem poda POST /api/v1/jobs/quote.

Popraw jakość wideo

black-forest-labs/flux-3/upscale

Cena

Opcja	Kredyty (za sekundę wyniku)	Dolary USA
`precise`	79.2	$0.792
`creative`	113.76	$1.1376

Parametry

Pole	Typ	Domyślnie	Dozwolone wartości	Do czego służy
`video_url`Wymagane	`string (uri)`	—	—	The clip to upscale, an MP4 of up to 20 seconds. Billed by its length, rounded up to whole seconds.
`upscale_mode`Opcjonalne	`string`	`precise`	precise, creative	precise stays faithful to the source; creative also rebuilds fine detail and costs more.
`upscale_factor`Opcjonalne	`number`	`2`	od 1.5 do 3	How many times larger, from 1.5 to 3. The aspect ratio is kept and the factor does not change the price.
`prompt`Opcjonalne	`string`	—	do 5000 znaków	Optional, creative mode only: the detail you want added, such as skin texture or fabric weave.

Przykładowe zapytanie

To zapytanie działa w obecnej postaci; pominięte pola mają wartości domyślne. Najpierw zapisz klucz w zmiennej POPNOW_API_KEY.

Przykład używa w video_url przykładowych plików PopNow. Zamień je na własne publiczne linki HTTPS, przesłane pliki albo zapisane zasoby.

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

Odpowiedź od razu zawiera taskId. Wynik pobierzesz przez GET /api/v1/jobs/recordInfo albo dodaj callBackUrl, by dostać powiadomienie.

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"

Utwórz wideo

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

Cena

Opcja	Kredyty (za sekundę wyniku)	Dolary USA
`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

Parametry

Pole	Typ	Domyślnie	Dozwolone wartości	Do czego służy
`prompt`Wymagane	`string`	—	do 5000 znaków	Describe the subject, action, camera, light and sound for the shot.
`aspect_ratio`Opcjonalne	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1	Output aspect ratio.
`quality`Opcjonalne	`string`	`standard`	standard, draft	standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p.
`resolution`Opcjonalne	`string`	`720p`	720p, 1080p	Output resolution. draft renders at 720p only.
`duration_seconds`Opcjonalne	`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`Opcjonalne	`boolean`	`true`	—	Generate synchronized sound with the video. The price is the same either way.

Przykładowe zapytanie

To zapytanie działa w obecnej postaci; pominięte pola mają wartości domyślne. Najpierw zapisz klucz w zmiennej 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"
  }
}'

Odpowiedź od razu zawiera taskId. Wynik pobierzesz przez GET /api/v1/jobs/recordInfo albo dodaj callBackUrl, by dostać powiadomienie.

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"

Obraz w wideo

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

Cena

Opcja	Kredyty (za sekundę wyniku)	Dolary USA
`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

Parametry

Pole	Typ	Domyślnie	Dozwolone wartości	Do czego służy
`prompt`Wymagane	`string`	—	do 5000 znaków	Describe the subject, action, camera, light and sound for the shot.
`image_url`Wymagane	`string (uri)`	—	—	Opening frame. The subject keeps its look from this image.
`last_image_url`Opcjonalne	`string (uri)`	—	—	Optional closing frame: the clip moves from the opening image to this one.
`aspect_ratio`Opcjonalne	`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`Opcjonalne	`string`	`standard`	standard, draft	standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p.
`resolution`Opcjonalne	`string`	`720p`	720p, 1080p	Output resolution. draft renders at 720p only.
`duration_seconds`Opcjonalne	`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`Opcjonalne	`boolean`	`true`	—	Generate synchronized sound with the video. The price is the same either way.

Przykładowe zapytanie

To zapytanie działa w obecnej postaci; pominięte pola mają wartości domyślne. Najpierw zapisz klucz w zmiennej POPNOW_API_KEY.

Przykład używa w image_url przykładowych plików PopNow. Zamień je na własne publiczne linki HTTPS, przesłane pliki albo zapisane zasoby.

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

Odpowiedź od razu zawiera taskId. Wynik pobierzesz przez GET /api/v1/jobs/recordInfo albo dodaj callBackUrl, by dostać powiadomienie.

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"

Wydłuż wideo

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

Cena

Opcja	Kredyty (za sekundę wyniku)	Dolary USA
`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

Parametry

Pole	Typ	Domyślnie	Dozwolone wartości	Do czego służy
`prompt`Wymagane	`string`	—	do 5000 znaków	Describe what happens next: the action, camera and sound that continue the clip.
`video_url`Wymagane	`string (uri)`	—	—	The clip to continue, an MP4 of up to 15 seconds. The new segment picks up from its last frame.
`aspect_ratio`Opcjonalne	`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`Opcjonalne	`string`	`standard`	standard, draft	standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p.
`resolution`Opcjonalne	`string`	`720p`	720p, 1080p	Output resolution. draft renders at 720p only.
`duration_seconds`Opcjonalne	`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`Opcjonalne	`boolean`	`true`	—	Generate synchronized sound with the video. The price is the same either way.

Przykładowe zapytanie

To zapytanie działa w obecnej postaci; pominięte pola mają wartości domyślne. Najpierw zapisz klucz w zmiennej POPNOW_API_KEY.

Przykład używa w video_url przykładowych plików PopNow. Zamień je na własne publiczne linki HTTPS, przesłane pliki albo zapisane zasoby.

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

Odpowiedź od razu zawiera taskId. Wynik pobierzesz przez GET /api/v1/jobs/recordInfo albo dodaj callBackUrl, by dostać powiadomienie.

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"

FLUX 3: dokumentacja API

W skrócie

Popraw jakość wideo

Cena

Parametry

Przykładowe zapytanie

Utwórz wideo

Cena

Parametry

Przykładowe zapytanie

Obraz w wideo

Cena

Parametry

Przykładowe zapytanie

Wydłuż wideo

Cena

Parametry

Przykładowe zapytanie

Co dalej

Na tej stronie