Hoe gebruik je de Flux.2 API? Alles wat je moet weten

FLUX.2 is de tweede generatie van Black Forest Labs-modellen voor beeldgeneratie en -bewerking (uitgebracht op 25 november 2025). Het biedt fotorealisme van productiekwaliteit, multi-referencebewerking tot 4 MP, gestructureerde/JSON-prompts en een keuze uit beheerde eindpunten (Pro, Flex) en open-weight-opties (Dev).

Het goede nieuws is dat CometAPI de Flux.2 API heeft geïntegreerd. Deze handleiding legt uit wat FLUX.2 is, hoe je de API aanroept en geavanceerde workflows (tekst → afbeelding, flexibele besturing, bewerken met meerdere referenties), met codevoorbeelden en best practices.

Wat is FLUX.2 en waarom is het belangrijk?

FLUX.2 is de opvolger van de FLUX-familie van beeldmodellen – ontworpen voor het genereren van tekst-naar-beeld met hoge getrouwheid en het bewerken van afbeeldingen met meerdere referenties in productieresoluties (tot ~4 megapixels). FLUX.2 is gebouwd voor echte creatieve workflows (merkveilige assets, consistente tekens en stijlen voor alle referenties, betere typografie en kleine details) in plaats van demo's, en is erop gericht de kloof tussen gegenereerde en echte beelden te dichten.

Belangrijkste resultaten FLUX.2 is ontworpen om te leveren

Fotorealistische uitvoer die geschikt is voor reclame, productafbeeldingen en UI-mockups.
Native multi-referentiebewerking: combineer, verwissel of stel elementen samen uit meerdere invoerafbeeldingen in één bewerking.
Varianten voor verschillende use cases: openbaar beschikbare ontwikkelaarsmodellen, een Pro-eindpunt dat is geoptimaliseerd voor productie en een Flex-eindpunt voor controle op laag niveau.

Op een hoog niveau combineert FLUX.2 een latente generatieve backbone (flow-/transformerarchitectuur) met een vision-language-model voor semantische basis en een nieuw getrainde VAE om een gedeelde latente ruimte over varianten heen te bieden. Dit ontwerp laat het model zowel generatie als reconstructie (bewerking) uitvoeren met een hogere betrouwbaarheid, terwijl de representatie leerbaar blijft voor training en finetuning. De open VAE is met name opmerkelijk omdat het de latente ruimte voor gehoste en zelfgehoste workflows standaardiseert.

Waarom dat belangrijk is: het koppelen van taal en latente flow-matching zorgt voor een betere opvolging van prompts (waardoor meerdelige, compositorische instructies zich voorspelbaar gedragen), betere typografie en één architectuur die zowel generatie als bewerking met meerdere referenties ondersteunt. Voor makers betekent dit betrouwbaardere output voor complexe instructies en gemengde input (tekst + afbeeldingen).

Hoe krijg ik toegang tot de FLUX.2 API?

Bereid de omgeving voor

Registreer je en log in bij CometAPI en haal je API-sleutel op via je profiel. Idealiter heb je als ontwikkelaar enige API-kennis (we bieden je hierbij ondersteuning, dus maak je geen zorgen).

U moet ook de gewenste aanvraagmethode en het juiste Flux.2-model selecteren.

Welke eindpunten en authenticatie zijn vereist?

De Replicate Predictions API biedt toegang tot het genereren van hoogwaardige afbeeldingen met behulp van diverse FLUX-modellen van Black Forest Labs via het standaard Replicate-formaat. Deze API ondersteunt een uitgebreid scala aan FLUX-modelvarianten, elk geoptimaliseerd voor verschillende toepassingen, van rapid prototyping tot professionele beeldgeneratie. Gebruikers kunnen naadloos schakelen tussen verschillende modellen door simpelweg de modelnaam in het URL-pad (https://api.cometapi.com/replicate/v1/models/{models}/predictions) te wijzigen, waardoor de API flexibel is voor diverse creatieve en commerciële toepassingen.

KomeetAPI beheerde eindpunten beschikbaar onder https://api.cometapi.com/flux/v1/{model} en benoemt eindpunten zoals flux-2-pro, flux-2-flex en flux-2-flex voor het maken en bewerken van afbeeldingen. Aanvragen vereisen een API-sleutel in de x-key koptekst.

Modelfamilie- en rekenkundige afwegingen

FLUX.2 (open gewichten) — Gebruik deze tool wanneer u lokale controle nodig hebt, experimenten wilt uitvoeren of inferentie wilt uitvoeren op uw eigen infrastructuur. Dev is open-weight (32B) en uitstekend geschikt voor verkennend onderzoek en finetuning. Het is beter configureerbaar, maar u bent verantwoordelijk voor de infrastructuur en optimalisatie.
FLUX.2 pro — De beste balans tussen snelheid, kwaliteit en kosten voor productie. Pro is afgestemd op voorspelbare latentie, consistente, snelle naleving, snelle doorvoer en ondersteunt tot 8 API-referentiebeelden (9 MP in totaal via API). Gebruik dit voor bewerkingen met een hoog volume en wanneer u betrouwbaarheid en voorspelbare prijzen nodig hebt.
FLUX.2 (beheerd + beheersbaarheid) — legt laag-niveau generatiecontroles bloot (bijv. steps, guidance) en ondersteunt meer referenties (tot 10) en een iets hogere kwaliteit/detail wanneer u een hogere latentie en kosten accepteert. Gebruik Flex wanneer u de uiteindelijke creatieve controle nodig hebt: typografische getrouwheid, exacte kleuren of zeer gedetailleerde compositie-aanpassingen.

Prototype op Dev of een goedkope Pro plan, migreer dan naar Pro voor schaal of Flex voor zeer gecontroleerde eindrenderingen.

Hoe gebruik ik de FLUX.2 API?

Levenscyclus van een verzoek (taak- + pollingmodel)

Reacties op bewerkings-/generatieverzoeken zijn taakobjecten waaronder een polling_url en id; je maakt een verzoek aan en peilt vervolgens (of gebruikt webhooks) de ondertekende resultaat-URL. Ondertekende URL's hebben een korte levensduur (meestal ~10 minuten), dus haal de uitvoer snel op.

De gehoste API volgt een asynchroon taakmodel:

POST een generatieverzoek → retourneert een task id en polling_url plus geschat cost.
Enquête de polling_url tot status == "Ready"en haal vervolgens het afbeeldingsresultaat op (vaak base64 of een gehoste URL).

Voorbeeld: Python (verzoeken) — indienen en peilen

import time, requests, os

API_KEY = os.environ
API_URL = "https://api.cometapi.com/flux/v1/flux-2-pro"

payload = {
    "prompt": "A high-end product photo of a ceramic mug on a wooden desk, soft window light.",
    "width": 1024, "height": 1024, "seed": 42
}

r = requests.post(API_URL, headers={"x-key": API_KEY, "accept":"application/json"}, json=payload)
r.raise_for_status()
task = r.json()
polling_url = task

while True:
    time.sleep(0.5)
    status_r = requests.get(polling_url, headers={"x-key": API_KEY})
    status_r.raise_for_status()
    status = status_r.json()
    if status == "Ready":
        print("Result URL:", status)
        break
    elif status in ("Error", "Failed"):
        print("Generation failed:", status)
        break

Dit patroon (indienen → poll of webhook) is de primaire synchrone/asynchrone stroom voor de beheerde eindpunten.

Beeldbewerking — minimaal voorbeeld (curl met invoer-URL)

curl -X POST "https://api.cometapi.com/flux/v1/flux-2-pro" \
  -H "accept: application/json" \
  -H "x-key: $CometAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Replace the background with a sunlit seaside boardwalk, keep the person intact and match lighting",
    "input_image": "https://example.com/my-photo.jpg",
    "width": 2048,
    "height": 1536
  }'

Gebruik voor het bewerken van meerdere referenties input_image, input_image_2, input_image_3, … (Pro ondersteunt maximaal 8 referenties via API; Flex maximaal 10; Dev raadt maximaal ~6 aan, afhankelijk van het geheugen).

Welke basisparameters moet ik meesturen?

Belangrijke velden in het aanvraagformulier (beeldbewerking/generatie) zijn:

guidance en steps — maken een nauwkeurige controle mogelijk.
prompt (tekenreeks) — tot 32K tokens; gedetailleerde natuurlijke taal of gestructureerde JSON.
input_image (tekenreeks) — vereist voor bewerkingen (URL of base64).
input_image_2 ... input_image_9 — afbeeldingen met meerdere referenties.
width / height — veelvouden van 16; output max 4MP.
seed — geheel getal voor reproduceerbaarheid.
safety_tolerance — moderatieniveau.

Hoe kan ik FLUX.2 Pro gebruiken voor professionele tekst-naar-afbeelding generatie?

FLUX.2 Pro is geoptimaliseerd voor betrouwbare, hoogwaardige resultaten. Gebruik het wanneer u consistente merkresultaten, snelle doorlooptijden en enterprise-SLA's nodig hebt.

Workflowrecept — productiebeelden

Voorverwerkingsprompts: Houd een korte 'intentie'-regel aan plus een gestructureerde attributensectie (belichting, lens, stemming, hex-kleurcodes voor merkkleuren). FLUX.2 ondersteunt hex-kleursturing om merkpaletten te behouden.
Begin met conservatieve standaardinstellingen: stappen 30-50 en begeleidingsschaal 6-9.0; verhoog de stappen voor details, verhoog de begeleiding om de resultaten strikter aan de prompt te laten voldoen.
Gebruik zaden + deterministische bemonstering voor reproduceerbaarheid bij A/B-testen.
Gebruik het Pro-eindpunt voor multi-try sampling: Vraag N variaties parallel aan en kies de beste — goedkoper en sneller dan handmatige hyperparameterafstemming.
Nabewerking: Denoise, kleine tonemapping of vector-achtige retouches in een deterministische pipeline. Overweeg een kleine GAN- of superresolutie-pass als u een hogere output dan de native output nodig hebt.

Waarom deze stappen helpen: Pro biedt een evenwicht tussen snelheid en betrouwbaarheid en past doorgaans veiligheids-/inhoudsfilters na de generatie toe. Het is daarom de verstandige standaard voor activa die rechtstreeks met de klant worden gedeeld.

Beste tips voor het genereren van afbeeldingen

1. Gestructureerde prompting wint bij de productie. Organiseer prompts op prioriteit: onderwerp → actie → stijl → context. Gebruik JSON-prompts (scène, onderwerpen, camera, belichting, kleurenpalet) wanneer u deterministische compositie over meerdere afbeeldingen nodig hebt. Voorbeeld van JSON-schemagebruik (pseudo):

{
  "scene": "product shot",
  "subjects": [
    {"type":"mug","pose":"center","style":"ceramic, matte"},
    {"type":"background","style":"wooden desk, window light"}
  ],
  "camera": {"focal_length":"85mm","aperture":"f2.8","angle":"slightly above"}
}

2. Reproduceerbaarheid: Passeren seed om later te reproduceren. Houd een catalogustoewijzingsprompt + seed → afbeelding bij voor traceerbaarheid.

3. Batch & orkestratie: Dien voor grote productieruns veel aanvragen parallel in via Pro, maar beperk de snelheid om vertraging te voorkomen; geef de voorkeur aan het Pro-eindpunt vanwege de voorspelbare latentie. Gebruik taakwachtrijen en workerpools om ondertekende resultaten snel te downloaden zodra ze klaar zijn.

4. Moderatie en veiligheid: Gebruik safety_tolerance om de strengheid van de moderatie te controleren. Pro-eindpunten omvatten gebruiksbeleid en hooks voor contentmoderatie; integreer server-side controles vóór publicatie.

5. Nabewerking: Professionele output is van hoge kwaliteit, maar heeft af en toe kleine retouches nodig. Bouw een geautomatiseerde nabewerkingsstap (bijsnijden, kleurcorrectie, compositie) in je pijplijn en laat merkgevoelige assets door mensen beoordelen.

Hoe kan ik de uitvoer aanpassen met het FLUX.2 Flex-eindpunt?

Flex is de variant met het ‘chirurgische gereedschap’: stem stappen, richtlijnen, negatieve prompts, tegelgroottes en referentietellingen af om de uitvoer nauwkeurig vorm te geven.

Wanneer kiest u voor Flex

U hebt nauwkeurige typografische rendering nodig (UI-mockups, labels).
Je moet meerdere referentiebeelden samenstellen en daarbij de pose en belichting onder controle houden.
U experimenteert met geavanceerde prompttechnieken (gestructureerde prompts, ketens van beperkingen).

Voorbeeld — Flex-bedieningstoetsen en hun effecten

steps — meer stappen = meer details (ten koste van latentie).
guidance_scale — hoger = dichter bij de tekstvraag, lager = meer creativiteit.
negative_prompt — verwijder expliciet elementen (bijvoorbeeld ‘geen watermerk, geen extra vingers’).
tile_size / tiled_inference — voor generatie van zeer hoge resolutie, tegel inferentieruimte om geheugen in te ruilen voor snelheid.
reference_weights — sommige eindpunten laten je referenties wegen om te bepalen welke afbeelding de pose versus de stijl beïnvloedt.

Praktische tip: Voor complexe composities kunt u een korte preview met lage begeleiding uitvoeren om de compositie te verifiëren en deze vervolgens opschalen met meer stappen en hogere begeleiding. Deze tweestapstechniek verlaagt de kosten en levert nauwkeurige eindresultaten op.

Voorbeeld: Flexaanvraag met stappen en begeleiding

curl -X POST "https://api.bfl.ai/v1/flux-2-flex" \
  -H "Content-Type: application/json" \
  -H "x-key: $BFL_API_KEY" \
  -d '{
    "prompt": "Cinematic movie poster, bold typography at top, main character centered, dramatic rim lighting",
    "width": 1536, "height": 2048,
    "steps": 50,
    "guidance": 7.5,
    "seed": 99999
  }'

Tip: Gebruik Flex tijdens de laatste creatieve goedkeuringen en Pro voor grootschalige, snellere pipelines. Flex is merkbaar beter te controleren voor typografie en microdetailtaken.

Aanbevolen werkwijzen voor productiegebruik

Hieronder vindt u beproefde patronen en pragmatisch advies voor het integreren van FLUX.2 op grote schaal.

1) Beheers de kosten door het bijhouden van megapixels en caching

De facturering van FLUX.2 is gebaseerd op megapixels van invoer + uitvoerGeef voor het genereren van grote volumes de voorkeur aan kleinere preview-renders (snelle stappen met lage resolutie) en verhoog alleen naar uiteindelijke renders met een hogere MP. Cache gerenderde assets (of sla verschillen op) zodat u identieke taken niet opnieuw hoeft te renderen. Altijd oppervlakte cost in reacties en registreer deze per aanvraag.

2) Gebruik lagen slim: preview versus definitieve rendersplitsing

Voer snelle Pro-renders met een lage stap uit voor prototyping of vele varianten.
Gebruik Flex of Pro-runs met hoge MP-kwaliteit voor definitief goedgekeurde outputs waar getrouwheid belangrijk is. Deze hybride aanpak zorgt voor een evenwicht tussen doorvoer en uiteindelijke beeldkwaliteit.

3) Snelle engineering → gestructureerde prompts en JSON

Profiteer van FLUX.2's gestructureerde JSON-prompts Wanneer u deterministische compositie nodig hebt (scèneobjecten, camera, poses, hex-kleurstalen). Dit vermindert iteratieve promptcycli en leidt tot reproduceerbare batches. Voorbeelden van Cloudflare tonen JSON-prompts die zijn ingesloten in multipart-formulieren.

4) Zaad + versiebeheer voor reproduceerbaarheid

Als u reproduceerbare resultaten nodig hebt, moet u een seed en registreer de modelversie/tijdstempel in metadata. Houd voor deterministische asset-pipelines een manifest bij: prompt, seed, modelvariant, resolutie, referentie-image hashes. Dit verbetert de traceerbaarheid en rollback-opties.

Conclusie

FLUX.2 is er volledig op gericht de kloof tussen "indrukwekkende demo" en "creatieve productietool" te dichten. Met multi-reference editing, output met hoge resolutie en een set gehoste eindpunten (plus open inferentiecode en gekwantificeerde consumentenbuilds) biedt het teams veel praktische opties: voer lokaal uit voor onderzoek en maatwerk, of gebruik de gehoste Pro/Flex-eindpunten voor stabiele productiepijplijnen.

Ontwikkelaars hebben toegang tot Flux.2 Dev API, Flux.2 Flex API en Flux.2 Pro API via CometAPI. Om te beginnen, verken de modelmogelijkheden van CometAPI in de Speeltuin en raadpleeg de API-gids voor gedetailleerde instructies. Zorg ervoor dat u bent ingelogd op CometAPI en de API-sleutel hebt verkregen voordat u toegang krijgt. com e tAPI bieden een prijs die veel lager is dan de officiële prijs om u te helpen integreren.

Klaar om te gaan?→ Meld u vandaag nog aan voor CometAPI !

Als u meer tips, handleidingen en nieuws over AI wilt weten, volg ons dan op VK, X en Discord!