Sådan bruger du FLUX 3 API: komplet udviklerguide

Kort svar

FLUX 3 er Black Forest Labs’ multimodale videomodel til tekst-til-video og billede-til-video-generering med synkroniseret lyd. På CometAPI er produktionsmodel-ID’et flux-3. Den verificerede asynkrone arbejdsgang bruger POST /v1/videos til at oprette en opgave, GET /v1/videos/{task_id} til at polle den og GET /v1/videos/{task_id}/content til at downloade den færdige MP4.

Tilgængelighedsopdatering (verificeret 24. september 2026): Black Forest Labs flyttede FLUX 3 Video ud over Early Access-fasen i juli og gjorde den første tekst-til-video- og billede-til-video-udgivelse generelt tilgængelig via BFL API’et og udvalgte partnere den 4. august 2026. CometAPI tilføjede produktionsmodel-ID’et flux-3 i sit Video API-format den 13. august 2026. Brug BFL-udgivelsesmeddelelsen og den live CometAPI-modelside som den autoritative kilde for tilgængelighed, felter og priser.

Hvad er ændret siden FLUX 3 Early Access?

Den vigtige ændring er driftsmæssig tilgængelighed. Den tidlige dækning fokuserede på den ansøgningsbaserede udrulning i juli, men BFL’s august-udgivelse introducerede et opkaldsbart video-endpoint, offentliggjorde begrænsninger og produktionspriser. CometAPI eksponerede efterfølgende flux-3 via sin samlede Video API-arbejdsgang.

CometAPI’s tidligere artikel, FLUX 3 API: Availability, Early Access, Video & Dev, er stadig nyttig for lanceringshistorik og den foreløbige evaluering i juli. Den bredere sammenligning Best AI Video APIs in 2026 dækker markedsvalg på højere niveau. Denne guide holder de emner korte og fokuserer på fungerende anmodninger, polling, prompts, omkostningskontrol og håndtering i produktion.

Hvad er FLUX 3?

FLUX 3 er BFL’s multimodale modelfamilie til video, lyd, billeder og handlingsrelateret forudsigelse. Den aktuelle videoudgivelse understøtter tekst-til-video, billede-til-video og videofortsættelse gennem ét udbyder-native endpoint.

For videoudviklere er hovedfunktionerne op til 20 sekunder ved 24 fps, HD- eller Full HD-output, synkroniseret lyd, flersproget tale med lip-sync, flere shots i én generering og op til ti fastlåste nøglerammer til kontrol af billede-til-video.

FLUX 3 API-specifikationer

Hvor god er FLUX 3 Video?

BFL rapporterer en tekst-til-video Elo-score på 1135 i deres all-vs-all evaluering af menneskelig præference. I den samme offentliggjorte sammenligning stod FLUX 3 lige med Seedance 2.0 i præference for billede-til-video og rangerede foran de øvrige testede modeller.

Disse resultater er nyttig positionsdokumentation, men de er leverandørdrevne evalueringer af menneskelig præference, ikke en uafhængig produktionsbenchmark. De måler ikke gateway-latens, køpålidelighed, omkostningskonsistens eller stabilitet ved gentagen generering, så produktionsteams bør stadig evaluere deres eget prompt-sæt.

FLUX 3 benchmark-ydelse

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

Hvad du skal bruge, før du bruger FLUX 3 API’et

• En CometAPI-konto og en API-nøgle lagret i en backend-miljøvariabel.
• En prompt, der definerer motiv, bevægelse, kameraretning, stemning samt evt. krævet lyd eller dialog.
• En robust jobhåndteringsproces, da videogenerering er asynkron.
• Nok kredit til iterativ test; fakturering afhænger af genereret varighed og opløsning.

Opret nøglen i CometAPI’s API-dashboard. Placer den ikke i frontend JavaScript, mobilbundter, offentlige repositories eller skærmbilleder.

FLUX 3 model-ID og endpoints

Sådan bruger du FLUX 3 API med CometAPI

Trin 1: Sæt din API-nøgle

På macOS eller Linux:

export COMETAPI_KEY="your_api_key"

På Windows PowerShell:

$env:COMETAPI_KEY="your_api_key"

Trin 2: Opret en FLUX 3-video

Den aktuelle FLUX 3 quickstart bruger en multipart-anmodning med model, prompt, seconds og size. Dette eksempel anmoder om et 5-sekunders 720p-klip:

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 anmodning starter et job. Design ikke applikationen ud fra at modtage en færdig MP4 i det samme HTTP-svar.

Trin 3: Gem task-ID’et

Gem identifikatoren straks efter, at oprettelsesanmodningen lykkes:

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

Opbevar task-ID’et sammen med bruger- eller jobposten, før polling begynder. En procesgenstart bør ikke miste en generering, som allerede er faktureret.

Trin 4: Poll videostatus

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

Start med et moderat interval som ti sekunder. Behandl completed, succeeded eller success som endelige succes-tilstande; behandl failed, failure, cancelled eller canceled som endelige fejltilstande.

Trin 5: Download MP4’en

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

Efter færdiggørelse bør du kopiere filen til dit eget objektlager eller mediepipeline i stedet for at beholde en midlertidig udbyder-URL som det permanente aktiv.

Komplet Python-arbejdsgang til FLUX 3-videogenerering

Følgende eksempel opretter et job, gemmer dets ID, poller til afslutning, tjekker fejltilstande, validerer MP4-signaturen og skriver output 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)")

Sådan bruger du image-to-video og nøglerammer

CometAPI’s FLUX 3-side angiver billede-til-video som en understøttet funktion. Dens nuværende offentlige eksempel demonstrerer tekst-til-video, så verificér den live gateway-dokumentation, før du antager, at et referencebillede-felt kopieret fra en anden model vil fungere uændret.

BFL’s native API er eksplicit: billede-til-video bruger mode i2v og keyframes-feltet. Ét billede fastlåser startframe, to billeder kan fastlåse begyndelse og slutning, og op til ti tidsbestemte billeder kan storyboarde et kontinuerligt klip.

BFL-native eksempel på nøglerammer

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 udbyder-native og gateway-parametre i separate adaptere. BFL bruger felter som mode, keyframes, start_video, resolution og draft; CometAPI’s verificerede eksempel bruger model, prompt, seconds og size.

Forklaring af FLUX 3 API-parametre

Sådan skriver du bedre FLUX 3-prompter

BFL’s guide til videoprompting anbefaler klar retning for motiv og handling, kamera, scene og stemning, bevægelseskvalitet og kontinuitet. For lydledte scener skal du angive dialog, stemme, lydeffekter og ambience.

En praktisk promptstruktur

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

Cinematisk 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 “make a cinematic ramen shop video” lader bevægelse, indramning, lyd og kontinuitet være uspecificeret. Eksplcit retning giver en mere testbar produktionsbrief.

FLUX 3 API-priser

BFL-priser er workflow-specifikke: fulde tekst-til-video- og billede-til-video-renders koster $0.17/s i HD eller $0.29/s i FHD, med HD Draft Mode til $0.06/s. Videofortsættelse koster $0.43/s i HD eller $0.54/s i FHD, med HD-drafts til $0.12/s. CometAPI angiver i øjeblikket flux-3 til $0.136/s for 720p og $0.232/s for 1080p. Verificér live priser før en stor batch.

Læsevejledning til de sidste to kolonner: værdier vises som HD/720p først og FHD/1080p derefter.

Sådan reducerer du iterationsomkostninger

• Prototyp i 720p, før du flytter en valgt prompt til 1080p.
• Brug 5-sekunders klip til at validere komposition, bevægelse og prompt-fortolkning.
• Ændr én stor promptvariabel ad gangen.
• Når du bruger BFL’s native API, test Draft Mode før en fuldkvalitetsrender.
• Gem succesfulde prompts og referencebeslutninger i applikationsmetadata.

FLUX 3 vs Wan 3.0 vs Seedance 2.5

Sammenlign FLUX 3, Wan 3.0 og Seedance 2.5 efter workflow i stedet for at lede efter én universel vinder. De autoritative specifikationslinks findes i tabeloverskriften nedenfor.

Prisnote: Startpriser er ikke en 1:1 sammenligning af kvalitet eller opløsning. Brug hver live modelsides opløsningsspecifikke tabel til budgettering.

Hvilken Video-API skal du vælge?

• Vælg FLUX 3 til realistisk bevægelse, synkroniseret lyd, logik for flere shots, native nøglerammer eller fortsættelse.
• Vælg Wan 3.0 når workflowet begynder med mange inputtyper, og et 30-sekunders genereringsvindue er vigtigt.
• Vælg Seedance 2.5 til længere, reference-tung storytelling med stærk identitets-, produkt- og stilkontrol.

FLUX 3 API bedste praksis for produktion

Bevar asynkrone jobs som varig tilstand

Gem task-ID’et straks efter indsendelse. En servergenstart eller worker-retry bør ikke tvinge brugeren til at betale for endnu en generering, fordi applikationen mistede den oprindelige opgave.

Undgå tæt polling

Start omkring et ti sekunders interval, medmindre live dokumentationen anbefaler andet. Polling hvert sekund øger anmodningstrykket uden væsentligt at forbedre oplevelsen.

Validér download

Tjek indholdslængde og MP4-signatur, før du markerer et aktiv som fuldført. Et succesfuldt HTTP-svar beviser ikke altid, at body er en gyldig video.

Adskil native- og gateway-skemaer

Vedligehold separate adaptere til BFL-native og CometAPI-anmodninger. Dette forhindrer, at native felter som mode, keyframes og start_video lækker ind i et gateway-kald, der forventer model, prompt, seconds og size.

Gem fuld fejlkontekst

Log HTTP-status, response-body, task-ID, model-ID, promptversion, størrelse, varighed og internt job-ID. Redigér API-nøglen væk.

Brug et lille evalueringssæt før produktion

Byg 10–30 repræsentative prompts, der dækker kamerabevægelse, mennesker, produkter, typografi, dialog, scener med høj bevægelse og krævede sideforhold. Kør det samme sæt, når en model eller integrationsversion ændres, og gentag vigtige prompts, fordi videogenerering er stokastisk.

Ofte stillede spørgsmål

Hvad er FLUX 3 model-ID på CometAPI?

Det aktuelle model-ID er flux-3.

Hvilket CometAPI-endpoint bruger FLUX 3?

Den verificerede Video API-arbejdsgang bruger POST /v1/videos efterfulgt af GET /v1/videos/{task_id} og GET /v1/videos/{task_id}/content.

Er FLUX 3 synkron?

Nej. Behandl den som en asynkron opgave: indsend, gem task-ID’et, poll og download.

Hvor lang tid kan FLUX 3 generere?

BFL dokumenterer 5–20 sekunder for T2V/I2V og 5–15 sekunder for fortsættelse.

Genererer FLUX 3 lyd?

Ja. BFL dokumenterer synkroniseret lyd aktiveret som standard i deres native API.

Understøtter FLUX 3 billede-til-video?

Ja. CometAPI angiver understøttelse af billede-til-video, mens BFL’s native API implementerer det via i2v-mode og nøglerammer.

Kan jeg bruge BFL-nøglerammer via CometAPI uændret?

Antag det ikke. Anmodningsskemaerne er forskellige; verificér den aktuelle CometAPI-quickstart, før du sender en gateway-referencebillede-arbejdsgang i produktion.

Hvad koster en fem-sekunders FLUX 3-video på CometAPI?

Til de aktuelt angivne CometAPI-satser koster fem sekunder $0.68 ved 720p eller $1.16 ved 1080p. Se den konsoliderede pristabel ovenfor for det live referencelink.

Er FLUX 3 bedre end Wan 3.0 eller Seedance 2.5?

Det afhænger af workflowet. FLUX 3 er overbevisende til bevægelseskohærente audiovisuelle shots og BFL-native kontrol med nøglerammer eller fortsættelse; Wan 3.0 vægter inputbredde; Seedance 2.5 vægter længere, reference-tung storytelling.

Konklusion

FLUX 3 har nu en fungerende asynkron Video API-vej på CometAPI, mens BFL’s native dokumentation eksponerer dybere kontrol til nøglerammer, fortsættelse, lyd og Draft Mode.

En sikker integrationsvej er ligetil: start med en kort 720p tekst-til-video-anmodning, gem task-ID’et, poll konservativt, download og validér MP4’en, og tilføj derefter promptskabeloner, lagring, retry-logik og et gentageligt evalueringssæt. Hold native- og gateway-skemaer adskilt, og verificér den live modelside, før du hardcoder felter eller priser.