De FLUX 3 API gebruiken: volledige ontwikkelaarsgids

Kort antwoord

FLUX 3 is Black Forest Labs’ multimodale videomodel voor tekst-naar-video en beeld-naar-video met gesynchroniseerde audio. Op CometAPI is de productie-model-ID flux-3. De geverifieerde asynchrone workflow gebruikt POST /v1/videos om een taak te maken, GET /v1/videos/{task_id} om te pollen, en GET /v1/videos/{task_id}/content om de voltooide MP4 te downloaden.

Beschikbaarheidsupdate (gecontroleerd op 24 september 2026): Black Forest Labs heeft FLUX 3 Video voorbij de Early Access-fase van juli gebracht en maakte de initiële tekst-naar-video- en beeld-naar-video-release algemeen beschikbaar via de BFL API en geselecteerde partners op 4 augustus 2026. CometAPI voegde de productie-model-ID flux-3 toe in zijn Video API-format op 13 augustus 2026. Gebruik de BFL-releaseaankondiging en de live CometAPI-modelpagina als bron van waarheid voor beschikbaarheid, velden en prijzen.

Wat is er veranderd sinds FLUX 3 Early Access?

De belangrijke verandering is operationele beschikbaarheid. Vroege berichtgeving richtte zich op de uitrol op basis van aanmelding in juli, maar BFL’s release in augustus introduceerde een aanroepbare video-endpoint, gepubliceerde beperkingen en productieprijzen. CometAPI stelde vervolgens flux-3 beschikbaar via zijn uniforme Video API-workflow.

Het eerdere artikel van CometAPI, FLUX 3 API: Availability, Early Access, Video & Dev, blijft nuttig voor lanceringsgeschiedenis en de voorlopige evaluatie in juli. De bredere vergelijking Best AI Video APIs in 2026 dekt marktbrede selectie. Deze gids houdt die onderwerpen beknopt en focust op werkende aanvragen, polleren, prompts, kostenbeheersing en productie-afhandeling.

Wat is FLUX 3?

FLUX 3 is BFL’s multimodale modellenfamilie voor video, audio, beelden en actiegerelateerde voorspelling. De huidige videorelease ondersteunt tekst-naar-video, beeld-naar-video en videovervolg via één provider-native endpoint.

Voor videodevelopers zijn de belangrijkste mogelijkheden: tot 20 seconden op 24 fps, HD of Full HD output, gesynchroniseerde audio, meertalige spraak met lip-sync, meerdere shots in één generatie en tot tien gepinde keyframes voor beeld-naar-video-sturing.

FLUX 3 API-specificaties

Hoe goed is FLUX 3 Video?

BFL rapporteert een tekst-naar-video Elo-score van 1135 in zijn all-vs-all evaluatie op basis van menselijke voorkeur. In dezelfde gepubliceerde vergelijking eindigde FLUX 3 gelijk met Seedance 2.0 in beeld-naar-video-voorkeur en scoorde hoger dan de andere geteste modellen.

Deze resultaten zijn nuttig als positioneringsbewijs, maar het zijn door de leverancier uitgevoerde evaluaties van menselijke voorkeur, geen onafhankelijke productiebenchmark. Ze meten geen gateway-latentie, wachtrijbetrouwbaarheid, kostconsistentie of stabiliteit bij herhaalde generaties, dus productieteams moeten nog steeds hun eigen promptset evalueren.

Benchmarkprestaties van FLUX 3

Bron: Black Forest Labs — FLUX 3 Video, Part 1: Generation.

Wat u nodig hebt voordat u de FLUX 3 API gebruikt

• Een CometAPI-account en een API-sleutel opgeslagen in een backend-omgevingsvariabele.
• Een prompt die het onderwerp, de beweging, de cameravoering, de atmosfeer en eventuele vereiste audio of dialoog definieert.
• Een duurzame pad voor taakafhandeling omdat videogeneratie asynchroon is.
• Genoeg tegoed voor iteratieve tests; facturering is afhankelijk van gegenereerde duur en resolutie.

Maak de sleutel aan in het CometAPI API-dashboard. Plaats deze niet in frontend-JavaScript, mobiele bundels, openbare repositories of screenshots.

FLUX 3-model-ID en endpoints

Hoe u de FLUX 3 API gebruikt met CometAPI

Stap 1: Stel uw API-sleutel in

Op macOS of Linux:

export COMETAPI_KEY="your_api_key"

Op Windows PowerShell:

$env:COMETAPI_KEY="your_api_key"

Stap 2: Maak een FLUX 3-video

De huidige FLUX 3 quickstart gebruikt een multipart-aanvraag met model, prompt, seconds en size. Dit voorbeeld vraagt een clip van vijf seconden in 720p aan:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=flux-3" \
  -F "prompt=A paper boat glides across a still pond in soft morning light" \
  -F "seconds=5" \
  -F "size=1280x720"

Deze aanvraag start een taak. Ontwerp de applicatie niet rond het ontvangen van een voltooide MP4 in dezelfde HTTP-respons.

Stap 3: Sla de taak-ID op

Bewaar de identificator direct nadat de maak-aanvraag slaagt:

{
  "id": "video_task_id",
  "status": "queued"
}

Sla de taak-ID op naast het gebruikers- of taakrecord voordat het polleren begint. Een procesherstart mag een generatie die al is gefactureerd niet verliezen.

Stap 4: Poll de videostatus

curl https://api.cometapi.com/v1/videos/{task_id} \
  -H "Authorization: Bearer $COMETAPI_KEY"

Begin met een gematigd interval, zoals tien seconden. Behandel completed, succeeded of success als terminale successtatussen; behandel failed, failure, cancelled of canceled als terminale fouten.

Stap 5: Download de MP4

curl https://api.cometapi.com/v1/videos/{task_id}/content \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output flux3_output.mp4

Kopieer het bestand na voltooiing naar uw eigen objectopslag of mediapipeline in plaats van een tijdelijke provider-URL als permanent asset te behouden.

Complete Python-workflow voor FLUX 3-videogeneratie

Het volgende voorbeeld maakt een taak, slaat de ID op, pollt tot voltooiing, controleert foutstatussen, valideert de MP4-handtekening en schrijft de output naar schijf.

import os
import time
from pathlib import Path

import requests

api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files={
        "model": (None, "flux-3"),
        "prompt": (
            None,
            "A product bottle rotates slowly on wet black stone, "
            "soft rim lighting, macro lens, realistic reflections.",
        ),
        "seconds": (None, "5"),
        "size": (None, "1280x720"),
    },
    timeout=120,
)
response.raise_for_status()

task = response.json()
data = task.get("data") or {}
task_id = (
    task.get("id")
    or task.get("task_id")
    or data.get("id")
    or data.get("task_id")
)
if not task_id:
    raise RuntimeError(f"Create response has no task ID: {task}")

while True:
    response = requests.get(
        f"{base_url}/v1/videos/{task_id}",
        headers=headers,
        timeout=60,
    )
    response.raise_for_status()
    task = response.json()
    data = task.get("data") or {}
    status = str(task.get("status") or data.get("status") or "").lower()
    progress = task.get("progress") or data.get("progress") or "unknown"
    print(f"Status: {status or 'unknown'}; progress: {progress}")

    if status in {"failed", "failure", "cancelled", "canceled"}:
        raise RuntimeError(f"Video generation failed: {task}")
    if status in {"completed", "succeeded", "success"} or progress == "100%":
        break
    time.sleep(10)

response = requests.get(
    f"{base_url}/v1/videos/{task_id}/content",
    headers=headers,
    timeout=300,
)
response.raise_for_status()
video = response.content

if len(video) < 12 or video[4:8] != b"ftyp":
    raise RuntimeError("Content response is not a non-empty MP4 file")

output_dir = Path("output")
output_dir.mkdir(parents=True, exist_ok=True)
output_path = output_dir / f"{task_id}.mp4"
output_path.write_bytes(video)
print(f"Saved: {output_path} ({len(video)} bytes)")

Beeld-naar-video en keyframes gebruiken

De CometAPI FLUX 3-pagina vermeldt beeld-naar-video als een ondersteunde capaciteit. Het huidige openbare voorbeeld demonstreert tekst-naar-video, dus verifieer de live gatewaydocumentatie voordat u aanneemt dat een referentie-afbeeldingsveld gekopieerd van een ander model ongewijzigd zal werken.

BFL’s native API is expliciet: beeld-naar-video gebruikt modus i2v en het keyframes-veld. Eén beeld zet het startframe vast, twee beelden kunnen het begin en einde vastzetten, en tot tien getimede beelden kunnen een doorlopende clip storyboarden.

BFL-natief keyframevoorbeeld

curl -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v",
    "prompt": "They sprint through the lantern-lit alley as the camera tracks behind them.",
    "keyframes": [
      [0, "data:image/png;base64,<first-frame>"],
      [8, "data:image/png;base64,<last-frame>"]
    ],
    "duration": 8
  }'

Houd provider-native en gatewayparameters gescheiden in afzonderlijke adapters. BFL gebruikt velden zoals mode, keyframes, start_video, resolution en draft; het geverifieerde voorbeeld van CometAPI gebruikt model, prompt, seconds en size.

Uitleg van FLUX 3 API-parameters

Betere FLUX 3-prompts schrijven

BFL’s videopromptinggids raadt duidelijke richting aan voor het onderwerp en de actie, camera, scène en atmosfeer, bewegingskwaliteit en continuïteit. Voor audio-geleide scènes specificeert u dialoog, stem, geluidseffecten en ambience.

Een praktische promptstructuur

Subject + Environment + Action + Camera + Lighting
+ Dialogue/Voice + Sound Effects + Ambience + Constraints

Filmische prompt

A lone cyclist rides through a rain-soaked neon street at midnight.
The camera begins low beside the rear wheel, then rises into a smooth tracking shot.
Reflections stretch across wet asphalt under moving cyan and magenta light.
Audio: steady rainfall, chain noise, distant traffic, no music, no dialogue.
Keep the same rider, bicycle, jacket, and weather throughout the shot.

Productvideoprompt

A premium stainless-steel espresso machine stands on a dark stone counter.
Begin with a macro close-up of water droplets on the metal housing.
Orbit clockwise as the machine brews; steam catches warm side light.
Finish on a clean three-quarter hero angle with the cup in the foreground.
Audio: pump vibration, steam hiss, ceramic contact, quiet cafe ambience.
Do not change the product shape, logo placement, material, or color.

Dialoog- en native-audioprompt

A young chef works alone in a compact Tokyo ramen shop at night.
Start close on boiling broth, then pull back as the chef sets down a bowl.
Warm tungsten lighting, natural reflections, documentary handheld motion.
The chef quietly says in Japanese: 「お待たせしました。」
Audio: bubbling broth, soft rain outside, distant street traffic.
No subtitles and no background music.

Een prompt zoals “maak een filmische ramen-shopvideo” laat beweging, kadrering, geluid en continuïteit ongespecificeerd. Expliciete regie levert een beter testbare productiebrief op.

Prijzen van de FLUX 3 API

BFL-prijzen zijn workflowspecifiek: volledige tekst-naar-video- en beeld-naar-video-renders kosten $0.17/s in HD of $0.29/s in FHD, met HD Draft-modus op $0.06/s. Videovervolg kost $0.43/s in HD of $0.54/s in FHD, met HD-concepts op $0.12/s. CometAPI vermeldt momenteel flux-3 op $0.136/s voor 720p en $0.232/s voor 1080p. Verifieer live prijzen vóór een grote batch.

De laatste twee kolommen lezen: waarden worden eerst als HD/720p en vervolgens als FHD/1080p weergegeven.

Iteratiekosten verlagen

• Prototypen op 720p voordat u een geselecteerde prompt naar 1080p verplaatst.
• Gebruik clips van vijf seconden om compositie, beweging en promptinterpretatie te valideren.
• Verander één grote promptvariabele tegelijk.
• Wanneer u de native BFL API gebruikt, test de Draft-modus voordat u een render van volledige kwaliteit maakt.
• Sla succesvolle prompts en referentiekeuzes op in applicatiemetadata.

FLUX 3 versus Wan 3.0 versus Seedance 2.5

Vergelijk FLUX 3, Wan 3.0 en Seedance 2.5 per workflow in plaats van te zoeken naar één universele winnaar. De gezaghebbende specificatielinks blijven in de tabelkop hieronder.

Prijsopmerking: Begintarieven zijn geen een-op-een vergelijking van kwaliteit of resolutie. Gebruik de resolutie-specifieke tabel op elke live modelpagina voor budgettering.

Welke Video API moet u kiezen?

• Kies FLUX 3 voor realistische beweging, gesynchroniseerd geluid, multi-shotlogica, native keyframes of continuatie.
• Kies Wan 3.0 wanneer de workflow begint met veel invoertypen en een generatievenster van 30 seconden belangrijk is.
• Kies Seedance 2.5 voor langere, referentierijke storytelling met sterke identiteit-, product- en stijlcontrole.

Best practices voor productie met de FLUX 3 API

Bewaar asynchrone taken als duurzame status

Sla de taak-ID direct na indiening op. Een serverherstart of werkhersturing mag de gebruiker niet dwingen te betalen voor een nieuwe generatie omdat de applicatie de oorspronkelijke taak verloor.

Vermijd agressief polleren

Begin rond een interval van tien seconden, tenzij de live documentatie anders aanbeveelt. Elke seconde polleren verhoogt de verzoekdruk zonder de ervaring materieel te verbeteren.

Valideer de download

Controleer de inhoudslengte en de MP4-handtekening voordat u een asset als voltooid markeert. Een succesvolle HTTP-respons bewijst niet altijd dat de body een geldige video is.

Scheid native en gateway-schema's

Onderhoud afzonderlijke adapters voor BFL-native en CometAPI-aanvragen. Dit voorkomt dat native velden zoals mode, keyframes en start_video doorsijpelen in een gateway-aanroep die model, prompt, seconds en size verwacht.

Bewaar volledige foutcontext

Log de HTTP-status, responsebody, taak-ID, model-ID, promptversie, size, duration en interne taak-ID. Redigeer de API-sleutel.

Gebruik een kleine evaluatieset voordat u live gaat

Bouw 10–30 representatieve prompts die camerabeweging, mensen, producten, typografie, dialoog, scènes met veel beweging en vereiste beeldverhoudingen dekken. Voer dezelfde set uit wanneer een model- of integratieversie verandert, en herhaal belangrijke prompts omdat videogeneratie stochastisch is.

Veelgestelde vragen

Wat is de FLUX 3 model-ID op CometAPI?

De huidige model-ID is flux-3.

Welke CometAPI-endpoint gebruikt FLUX 3?

De geverifieerde Video API-workflow gebruikt POST /v1/videos, gevolgd door GET /v1/videos/{task_id} en GET /v1/videos/{task_id}/content.

Is FLUX 3 synchroon?

Nee. Behandel het als een asynchrone taak: indienen, taak-ID opslaan, pollen en downloaden.

Hoe lang kan FLUX 3 genereren?

BFL documenteert 5–20 seconden voor T2V/I2V en 5–15 seconden voor continuatie.

Genereert FLUX 3 audio?

Ja. BFL documenteert gesynchroniseerde audio standaard ingeschakeld in zijn native API.

Ondersteunt FLUX 3 beeld-naar-video?

Ja. CometAPI vermeldt beeld-naar-video-ondersteuning, terwijl BFL’s native API dit implementeert via i2v-modus en keyframes.

Kan ik BFL-keyframes ongewijzigd via CometAPI gebruiken?

Ga daar niet van uit. De requestschema's verschillen; verifieer de huidige CometAPI-quickstart voordat u een gatewayworkflow met referentiebeelden in productie neemt.

Wat kost een vijf seconden FLUX 3-video op CometAPI?

Tegen de momenteel vermelde CometAPI-tarieven kost vijf seconden $0.68 op 720p of $1.16 op 1080p. Zie de geconsolideerde prijzentabel hierboven voor de live referentielink.

Is FLUX 3 beter dan Wan 3.0 of Seedance 2.5?

Dat hangt af van de workflow. FLUX 3 is overtuigend voor beweging-coherente audiovisuele shots en BFL-native keyframe- of continuatiesturing; Wan 3.0 benadrukt inputbreedte; Seedance 2.5 benadrukt langere, referentierijke storytelling.

Conclusie

FLUX 3 heeft nu een werkend asynchroon Video API-pad op CometAPI, terwijl BFL’s native documentatie diepere controle biedt voor keyframes, continuatie, audio en Draft-modus.

Een veilige integratiepad is eenvoudig: begin met een korte 720p tekst-naar-video-aanvraag, sla de taak-ID op, poll conservatief, download en valideer de MP4, voeg vervolgens prompttemplates, opslag, retrylogica en een herhaalbare evaluatieset toe. Houd native en gateway-schema's gescheiden en verifieer de live modelpagina voordat u velden of prijzen hardcodeert.