Slik bruker du FLUX 3 API: komplett utviklerveiledning

Kort svar

FLUX 3 er Black Forest Labs’ multimodale videomodell for tekst-til-video og bilde-til-video-generering med synkronisert lyd. På CometAPI er produksjonsmodell-ID-en flux-3. Den verifiserte asynkrone arbeidsflyten bruker POST /v1/videos for å opprette en oppgave, GET /v1/videos/{task_id} for å polle den, og GET /v1/videos/{task_id}/content for å laste ned den ferdige MP4-filen.

Tilgjengelighetsoppdatering (bekreftet 24. september 2026): Black Forest Labs flyttet FLUX 3 Video forbi juli-fasen med tidlig tilgang og gjorde den første tekst-til-video- og bilde-til-video-utgivelsen allment tilgjengelig via BFL API og utvalgte partnere 4. august 2026. CometAPI la til produksjonsmodell-ID-en flux-3 i sitt Video API-format 13. august 2026. Bruk BFLs lanseringskunngjøring og den levende CometAPI-modellsiden som sannhetskilder for tilgjengelighet, felt og priser.

Hva er endret siden FLUX 3 tidlig tilgang?

Den viktige endringen er operasjonell tilgjengelighet. Tidlig dekning fokuserte på utrullingen i juli basert på søknader, men BFLs augustlansering introduserte et kallbart video-endepunkt, publiserte begrensninger og produksjonsprising. CometAPI eksponerte deretter flux-3 gjennom sin enhetlige Video API-arbeidsflyt.

CometAPIs tidligere artikkel, FLUX 3 API: Availability, Early Access, Video & Dev, er fortsatt nyttig for lanseringshistorikk og den foreløpige evalueringen i juli. Den bredere sammenligningen Best AI Video APIs in 2026 dekker valg på markedsnivå. Denne veiledningen holder de temaene konsise og fokuserer på fungerende forespørsler, polling, prompter, kostnadskontroll og produksjonshåndtering.

Hva er FLUX 3?

FLUX 3 er BFLs multimodale modelfamilie for video, lyd, bilder og handlingsrelaterte prediksjoner. Den nåværende videoutgivelsen støtter tekst-til-video, bilde-til-video og videofortsettelse via ett leverandør-native endepunkt.

For videoutviklere er hovedfunksjonene opptil 20 sekunder ved 24 fps, HD- eller Full HD-utgang, synkronisert lyd, flerspråklig tale med leppesynk, flere opptak i én generering, og opptil ti festede nøkkelbilder for bilde-til-video-kontroll.

FLUX 3 API-spesifikasjoner

Hvor god er FLUX 3 Video?

BFL rapporterer en tekst-til-video Elo-score på 1135 i sin all-mot-alle evaluering av menneskelige preferanser. I den samme publiserte sammenligningen tangerte FLUX 3 Seedance 2.0 i bilde-til-video-preferanse og rangerte foran de andre testede modellene.

Disse resultatene er nyttig posisjoneringsdokumentasjon, men de er leverandørstyrte evalueringer av menneskelige preferanser, ikke en uavhengig produksjonsbenchmark. De måler ikke gateway-latens, køpålitelighet, kostnadskonsistens eller stabilitet ved gjentatt generering, så produksjonsteam bør fortsatt evaluere sitt eget promptsett.

FLUX 3 benchmark-ytelse

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

Dette trenger du før du bruker FLUX 3 API-et

• En CometAPI-konto og en API-nøkkel lagret i en backend-miljøvariabel.
• En prompt som definerer motiv, bevegelse, kameraretning, atmosfære og eventuell nødvendig lyd eller dialog.
• En robust håndtering av jobber fordi videogenerering er asynkron.
• Nok kreditt til iterativ testing; fakturering avhenger av generert varighet og oppløsning.

Opprett nøkkelen i CometAPI API-dashbordet. Ikke plasser den i frontend-JavaScript, mobilpakker, offentlige repositorier eller skjermbilder.

FLUX 3-modell-ID og endepunkter

Slik bruker du FLUX 3 API med CometAPI

Trinn 1: Sett API-nøkkelen din

På macOS eller Linux:

export COMETAPI_KEY="your_api_key"

På Windows PowerShell:

$env:COMETAPI_KEY="your_api_key"

Trinn 2: Opprett en FLUX 3-video

Den nåværende FLUX 3-quickstarten bruker en multipart-forespørsel med model, prompt, seconds og size. Dette eksempelet ber om et fem sekunders 720p-klipp:

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"

Denne forespørselen starter en jobb. Ikke design applikasjonen rundt å motta en ferdig MP4 i samme HTTP-respons.

Trinn 3: Lagre oppgave-ID-en

Vedvar identifikatoren umiddelbart etter at opprettelsesforespørselen lykkes:

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

Lagre oppgave-ID-en sammen med bruker- eller jobbposten før polling begynner. En prosessomstart bør ikke miste en generering som allerede er belastet.

Trinn 4: Poll videostatusen

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

Start med et moderat intervall, for eksempel ti sekunder. Behandle completed, succeeded eller success som terminale suksess-tilstander; behandle failed, failure, cancelled eller canceled som terminale feil.

Trinn 5: Last ned MP4-filen

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

Etter fullføring, kopier filen til din egen objektlagring eller mediapipeline i stedet for å beholde en midlertidig leverandør-URL som det permanente assetet.

Komplett Python-arbeidsflyt for FLUX 3-videogenerering

Følgende eksempel oppretter en jobb, lagrer ID-en, polller til fullføring, sjekker feiltilstander, validerer MP4-signaturen og skriver utgangen til disk.

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)")

Slik bruker du bilde-til-video og nøkkelbilder

CometAPI-siden for FLUX 3 lister bilde-til-video som en støttet kapasitet. Dens nåværende offentlige eksempel demonstrerer tekst-til-video, så verifiser levende gateway-dokumentasjon før du antar at et referansebildefelt kopiert fra en annen modell vil fungere uendret.

BFLs native API er eksplisitt: bilde-til-video bruker mode i2v og feltet keyframes. Ett bilde fester startbildet, to bilder kan feste begynnelse og slutt, og opptil ti tidsbestemte bilder kan storyboarde et kontinuerlig klipp.

BFL-native nøkkelbilde-eksempel

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

Hold leverandør-native og gateway-parametere i separate adaptere. BFL bruker felt som mode, keyframes, start_video, resolution og draft; CometAPIs verifiserte eksempel bruker model, prompt, seconds og size.

Forklaring av FLUX 3 API-parametere

Slik skriver du bedre FLUX 3-prompter

BFLs veiledning for videoprompting anbefaler klar retning for motiv og handling, kamera, scene og atmosfære, bevegelseskvalitet og kontinuitet. For lydstyrte scener, spesifiser dialog, stemme, lydeffekter og atmosfære.

En praktisk promptstruktur

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

Filmatisk 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.

Produktvideoprompt

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.

Dialog og native-lyd-prompt

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.

En prompt som «lag en filmatisk ramen-shops-video» lar bevegelse, innramming, lyd og kontinuitet stå uspesifisert. Tydelig retning gir en mer testbar produksjonsbrief.

Priser for FLUX 3 API

BFL-prising er arbeidsflytspesifikk: full tekst-til-video- og bilde-til-video-rendring koster $0.17/s i HD eller $0.29/s i FHD, med HD Draft Mode til $0.06/s. Videofortsettelse koster $0.43/s i HD eller $0.54/s i FHD, med HD-utkast til $0.12/s. CometAPI lister for øyeblikket flux-3 til $0.136/s for 720p og $0.232/s for 1080p. Verifiser levende priser før et stort parti.

Slik leser du de to siste kolonnene: verdier vises som HD/720p først og FHD/1080p deretter.

Slik reduserer du iterasjonskostnader

• Prototyp på 720p før du flytter en valgt prompt til 1080p.
• Bruk femsekunders klipp for å validere komposisjon, bevegelse og tolkning av prompt.
• Endre én stor promptvariabel om gangen.
• Når du bruker BFLs native API, test Draft Mode før en fullkvalitetsrendring.
• Lagre vellykkede prompter og referansebeslutninger i applikasjonsmetadata.

FLUX 3 vs Wan 3.0 vs Seedance 2.5

Sammenlign FLUX 3, Wan 3.0 og Seedance 2.5 per arbeidsflyt i stedet for å lete etter én universell vinner. De autoritative spesifikasjonslenkene står i tabellhodet nedenfor.

Prishinweis: Startpriser er ikke en én-til-én sammenligning av kvalitet eller oppløsning. Bruk hver levende modellsides oppløsningsspesifikke tabell for budsjettering.

Hvilken video-API bør du velge?

• Velg FLUX 3 for realistisk bevegelse, synkronisert lyd, fleropptakslogikk, native nøkkelbilder eller fortsettelse.
• Velg Wan 3.0 når arbeidsflyten starter med mange inndatatyper og et 30-sekunders generasjonsvindu er viktig.
• Velg Seedance 2.5 for lengre, referansetung historiefortelling med sterk identitets-, produkt- og stilkontroll.

Beste praksis for FLUX 3 API i produksjon

Vedvar asynkrone jobber som slitesterk tilstand

Lagre oppgave-ID-en umiddelbart etter innsending. En serveromstart eller arbeider-retry skal ikke tvinge brukeren til å betale for en ny generering fordi applikasjonen mistet den opprinnelige oppgaven.

Unngå tett polling

Start rundt et intervall på ti sekunder med mindre levende dokumentasjon anbefaler noe annet. Polling hvert sekund øker forespørselspresset uten å forbedre opplevelsen nevneverdig.

Valider nedlastingen

Sjekk innholdslengde og MP4-signatur før du markerer et asset som komplett. En vellykket HTTP-respons beviser ikke alltid at kroppen er en gyldig video.

Skill native og gateway-skjemaer

Vedlikehold separate adaptere for BFL-native og CometAPI-forespørsler. Dette forhindrer at native felt som mode, keyframes og start_video lekker inn i en gateway-kall som forventer model, prompt, seconds og size.

Lagre full feil-kontekst

Logg HTTP-status, responskropp, oppgave-ID, modell-ID, promptversjon, størrelse, varighet og intern jobb-ID. Rediger bort API-nøkkelen.

Bruk et lite evalueringssett før lansering

Bygg 10–30 representative prompter som dekker kamerabevegelse, mennesker, produkter, typografi, dialog, høybevegelsesscener og nødvendige sideforhold. Kjør det samme settet når en modell- eller integrasjonsversjon endres, og gjenta viktige prompter fordi videogenerering er stokastisk.

Vanlige spørsmål

Hva er FLUX 3-modell-ID-en på CometAPI?

Den nåværende modell-ID-en er flux-3.

Hvilket CometAPI-endepunkt bruker FLUX 3?

Den verifiserte Video API-arbeidsflyten bruker POST /v1/videos, etterfulgt av GET /v1/videos/{task_id} og GET /v1/videos/{task_id}/content.

Er FLUX 3 synkron?

Nei. Behandle den som en asynkron jobb: send inn, vedvar oppgave-ID, poll og last ned.

Hvor lenge kan FLUX 3 generere?

BFL dokumenterer 5–20 sekunder for T2V/I2V og 5–15 sekunder for fortsettelse.

Genererer FLUX 3 lyd?

Ja. BFL dokumenterer synkronisert lyd aktivert som standard i sin native API.

Støtter FLUX 3 bilde-til-video?

Ja. CometAPI lister støtte for bilde-til-video, mens BFLs native API implementerer det via i2v-modus og keyframes.

Kan jeg bruke BFL-nøkkelbilder via CometAPI uendret?

Ikke anta det. Forespørselsskjemaene er forskjellige; verifiser gjeldende CometAPI-quickstart før du leverer en gateway-arbeidsflyt for referansebilder.

Hvor mye koster en femsekunders FLUX 3-video på CometAPI?

Med de nåværende CometAPI-satsene koster fem sekunder $0.68 på 720p eller $1.16 på 1080p. Se den konsoliderte pristabellen ovenfor for den levende referanselenken.

Er FLUX 3 bedre enn Wan 3.0 eller Seedance 2.5?

Det avhenger av arbeidsflyten. FLUX 3 er overbevisende for bevegelseskoherente audiovisuelle opptak og BFL-native nøkkelbilde- eller fortsettelseskontroll; Wan 3.0 vektlegger inndata-bredde; Seedance 2.5 vektlegger lengre, referansetung historiefortelling.

Konklusjon

FLUX 3 har nå en fungerende asynkron Video API-sti på CometAPI, mens BFLs native dokumentasjon eksponerer dypere kontroller for nøkkelbilder, fortsettelse, lyd og Draft Mode.

En trygg integrasjonssti er enkel: start med en kort 720p tekst-til-video-forespørsel, vedvar oppgave-ID-en, poll konservativt, last ned og valider MP4-en, og legg deretter til promptmaler, lagring, retry-logikk og et repeterbart evalueringssett. Hold native og gateway-skjemaer atskilt, og verifiser den levende modellsiden før du hardkoder felt eller priser.