Hoe gebruikt u de Flux.2-API? Alles wat u moet weten

FLUX.2 is de tweedegeneratiefamilie van beeldgeneratie- en afbeeldingsbewerkingsmodellen van Black Forest Labs (uitgebracht op 25 november 2025). Het biedt fotorealisme op productieniveau, multireferentie-bewerking tot 4MP, gestructureerde/JSON-prompting en een keuze uit beheerde endpoints (Pro, Flex) en open-weight opties (Dev).

Goed nieuws: CometAPI heeft de Flux.2 API geïntegreerd. Deze gids legt uit wat FLUX.2 is, hoe je de API aanroept, en geavanceerde workflows (tekst→beeld, flexibele controle, multireferentie-bewerking), 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 high-fidelity tekst-naar-beeldgeneratie en multireferentie-afbeeldingsbewerking op productieresoluties (tot ~4 megapixels). FLUX.2 is gebouwd voor echte creatieve workflows (merksafe assets, consistente personages en stijlen over referenties heen, betere typografie en kleine details) in plaats van demo’s, en beoogt de kloof te dichten tussen gegenereerde en echte beelden.

Belangrijkste resultaten die FLUX.2 wil leveren

Fotorealistische outputs geschikt voor reclame, productbeelden en UI-mockups.
Native multireferentie-bewerking: combineer, wissel of componeer elementen uit meerdere invoerafbeeldingen in één bewerking.
Variants voor verschillende use-cases: openlijk beschikbare ontwikkelaarsmodellen, een Pro-endpoint geoptimaliseerd voor productie, en een Flex-endpoint voor low-level controle.

Op hoofdlijnen combineert FLUX.2 een latente generatieve ruggengraat (flow/transformer-architectuur) met een vision–language-model voor semantische verankering, en een nieuw getrainde VAE om een gedeelde latente ruimte over varianten te bieden. Dit ontwerp laat het model zowel genereren als reconstrueren (bewerken) met hogere fidelity, terwijl de representatie leerbaar blijft voor training en fine-tuning. De open VAE is bijzonder noemenswaardig omdat hij de latente ruimte standaardiseert voor gehoste en zelfgehoste workflows.

Waarom dat ertoe doet: het koppelen van taal en latente flow matching levert sterker prompt-following op (waardoor meerledige, compositorische instructies voorspelbaar gedragen), betere typografie, en één architectuur die zowel generatie als bewerking met meerdere referenties ondersteunt. Voor makers betekent dat betrouwbaardere outputs voor complexe instructies en gemengde input (tekst + afbeeldingen).

Hoe krijg ik toegang tot de FLUX.2 API?

Bereid de omgeving voor

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

Je moet ook je gewenste aanvraagmethode en het juiste Flux.2-model kiezen.

Welke endpoints en authenticatie zijn vereist?

De Replicate Predictions API biedt toegang om hoogwaardige afbeeldingen te genereren met diverse FLUX-modellen van Black Forest Labs via het standaard Replicate-formaat. Deze API ondersteunt een breed scala aan FLUX-modelvarianten, elk geoptimaliseerd voor verschillende use-cases van snelle prototyping tot beeldgeneratie op professioneel niveau. Gebruikers kunnen naadloos schakelen tussen verschillende modellen door eenvoudig de modelnaam in het URL-pad (https://api.cometapi.com/replicate/v1/models/{models}/predictions) te wijzigen, wat het flexibel maakt voor uiteenlopende creatieve en commerciële toepassingen.

CometAPI stelt beheerde endpoints beschikbaar onder https://api.cometapi.com/flux/v1/{model} en biedt endpoints zoals flux-2-pro, flux-2-flex en flux-2-flex voor het maken en bewerken van afbeeldingen. Verzoeken vereisen een API-sleutel in de x-key-header.

Modelfamilie en compute-afwegingen

FLUX.2 (open weights) — Gebruik wanneer je lokale controle nodig hebt, onderzoeksexperimenten doet, of inference op je eigen infrastructuur wilt draaien. Dev is open-weight (32B) en uitstekend voor verkennend onderzoek en fine-tuning. Het is configurabeler, maar je bent zelf verantwoordelijk voor infrastructuur en optimalisatie.
FLUX.2 pro — Beste balans tussen snelheid, kwaliteit en kosten voor productie. Pro is afgestemd op voorspelbare latency, consistente prompt-naleving, hoge doorvoer, en ondersteunt tot 8 API-referentieafbeeldingen (9MP totaal via API). Gebruik dit voor grootschalige bewerkingen en wanneer je betrouwbaarheid en voorspelbare prijzen nodig hebt.
FLUX.2 (beheerd + controleerbaarheid) — Stelt low-level generatiecontroles bloot (bijv. steps, guidance) en ondersteunt meer referenties (tot 10) en iets hogere kwaliteit/detail wanneer je hogere latency en kosten accepteert. Gebruik Flex wanneer je ultieme creatieve controle nodig hebt — typografische nauwkeurigheid, exacte kleuren, of zeer gedetailleerde compositieaanpassingen.

Prototypen op Dev of een voordelig Pro-plan, migreer vervolgens naar Pro voor schaal of naar Flex voor zeer gecontroleerde eindrenders.

Hoe gebruik ik de FLUX.2 API?

Levenscyclus van verzoeken (taak + pollingmodel)

Antwoorden op bewerkings-/generatieverzoeken zijn taakobjecten die een polling_url en id bevatten; je maakt een verzoek aan en pollt vervolgens (of gebruikt webhooks) om de ondertekende resultaat-URL op te halen. Ondertekende URL’s zijn kortdurend (meestal ~10 minuten), dus haal outputs snel op.

De gehoste API volgt een asynchroon taakmodel:

POST een generatieverzoek → retourneert een task id en polling_url plus geschatte cost.
Poll de polling_url tot status == "Ready", haal dan het afbeeldingsresultaat op (vaak base64 of een gehoste URL).

Voorbeeld: Python (requests) — indienen en pollen

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 → pollen of webhook) is de primaire synchrone/asynchrone flow voor de beheerde endpoints.

Afbeeldingsbewerking — minimaal voorbeeld (curl met input-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": "![image](https://example.com/my-photo.jpg)",
    "width": 2048,
    "height": 1536
  }'

Voor multireferentie-bewerking gebruik je input_image, input_image_2, input_image_3, … (Pro ondersteunt tot 8 referenties via API; Flex tot 10; voor Dev wordt ~6 aangeraden, afhankelijk van geheugen).

Welke basisparameters moet ik meegeven?

Belangrijke body-velden (afbeeldingsbewerking / -generatie) zijn onder andere:

guidance en steps — bieden fijnmazige controle.
prompt (string) — tot 32K tokens; gedetailleerde natuurlijke taal of gestructureerde JSON.
input_image (string) — vereist voor bewerkingen (URL of base64).
input_image_2 … input_image_9 — multireferentie-afbeeldingen.
width / height — veelvouden van 16; output max 4MP.
seed — integer voor reproduceerbaarheid.
safety_tolerance — moderatieniveau.

Hoe kan ik FLUX.2 Pro benutten voor professionele tekst-naar-beeldgeneratie?

FLUX.2 Pro is afgestemd op betrouwbare, hoogwaardige outputs. Gebruik het wanneer je consistente resultaten op merkniveau, snelle doorlooptijd en enterprise-SLA’s nodig hebt.

Workflowrecept — productiebeeld

Preprocess prompts: houd een korte “intentie”-regel plus een gestructureerde attributensectie (belichting, lens, sfeer, kleur-hex-codes voor merkkleuren). FLUX.2 ondersteunt hex-kleursturing om merkkleurpaletten te behouden.
Begin met conservatieve defaults: steps 30–50 en guidance-schaal 6–9.0; verhoog steps voor details, verhoog guidance om resultaten strikter aan de prompt te laten voldoen.
Gebruik seeds + deterministische sampling voor reproduceerbaarheid in A/B-tests.
Gebruik het Pro-endpoint voor sampling met meerdere pogingen: vraag N varianten parallel aan en kies de beste — goedkoper en sneller dan handmatige hyperparameter-tuning.
Post-process: denoise, kleine tone mapping, of vectorstijl-retouches in een deterministische pipeline. Overweeg een kleine GAN of super-resolutiepass als je hoger dan de native output nodig hebt.

Waarom deze stappen helpen: Pro balanceert snelheid en fidelity en handhaaft doorgaans veiligheids-/inhoudsfilters na generatie, dus het is de logische standaard voor assets die richting klant gaan.

Beste tips voor het genereren van afbeeldingen

Gestructureerde prompting wint voor productie. Organiseer prompts op prioriteit: onderwerp → actie → stijl → context. Gebruik JSON-prompting (scene, subjects, camera, lighting, color_palette) wanneer je deterministische compositie over veel afbeeldingen nodig hebt. Voorbeeld gebruik JSON-schema (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"}
}

Reproduceerbaarheid: Geef seed door om later te reproduceren. Houd een catalogus bij die prompt + seed → afbeelding mapt voor traceerbaarheid.
Batch & orkestratie: Voor grote productieruns, dien veel verzoeken parallel in naar Pro, maar rate-limit om throttling te voorkomen; geef de voorkeur aan het Pro-endpoint voor voorspelbare latency. Gebruik jobqueues en workerpools om ondertekende resultaten snel te downloaden zodra ze gereed zijn.
Moderatie & veiligheid: Gebruik safety_tolerance om de strengheid van moderatie te regelen. Pro-endpoints bevatten gebruiksbeleid en content moderation-hooks; integreer server-side checks vóór publicatie.
Postprocessing: Pro-outputs zijn van hoge kwaliteit maar hebben soms kleine retouches nodig. Bouw een geautomatiseerde postprocess-stap (crop, color grading, compositing) in je pipeline en houd menselijke review voor merksensitieve assets.

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

Flex is de “chirurgische tool”-variant: stem steps, guidance, negative prompts, tilegroottes en referentietellingen af om de output precies te vormen.

Wanneer kies je voor Flex

Je hebt precieze typografische weergave nodig (UI-mockups, labels).
Je moet meerdere referenties compositeren met controle over pose en belichting.
Je experimenteert met geavanceerde prompttechnieken (gestructureerde prompts, ketens van constraints).

Voorbeeld — Flex-parameters en hun effecten

steps — meer steps = fijnere details (tegen kosten van latency).
guidance_scale — hoger = dichter bij de tekstprompt, lager = meer creativiteit.
negative_prompt — verwijder elementen expliciet (bijv. “no watermark, no extra fingers”).
tile_size / tiled_inference — voor generatie met zeer hoge resolutie, tiling van de inferentieruimte om geheugen in te ruilen voor snelheid.
reference_weights — sommige endpoints laten je referenties wegen om te beïnvloeden welke afbeelding pose vs. stijl aanstuurt.

Praktische tip: Voor complexe composities, voer eerst een korte preview met lage guidance uit om compositie te verifiëren, schaal vervolgens op met meer steps en hogere guidance. Deze tweepassentechniek verlaagt de kosten terwijl de uiteindelijke output precies wordt.

Voorbeeld: Flex-aanvraag met steps & guidance

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 finale creatieve aftekeningen en Pro voor grootschalige, snellere pipelines. Flex is merkbaar beter controleerbaar voor typografie- en microdetailtaken.

Best practices voor productiegebruik

Hieronder staan beproefde patronen en pragmatisch advies voor het integreren van FLUX.2 op schaal.

1) Beheer kosten door megapixels te volgen en te cachen

FLUX.2-facturatie is gebaseerd op megapixels van input + output. Voor grootschalige generatie, geef de voorkeur aan kleinere preview-renders (lage resolutie, snelle steps) en schaal alleen op naar hogere MP voor definitieve renders. Cache gerenderde assets (of sla diffs op) zodat je identieke jobs niet opnieuw rendert. Toon altijd cost in responses en log dit per verzoek.

2) Gebruik tiers slim: scheiding tussen preview en definitieve render

Draai snelle, low-step Pro-renders voor prototyping of veel varianten.
Gebruik Flex of high-MP Pro-runs voor definitief goedgekeurde outputs waar fidelity telt. Deze hybride aanpak balanceert doorvoer en uiteindelijke beeldkwaliteit.

3) Prompt engineering → gestructureerde prompts & JSON

Maak gebruik van FLUX.2’s gestructureerde JSON-prompting wanneer je deterministische compositie nodig hebt (scèneobjecten, camera, poses, hex-kleurstalen). Dit verkleint iteratieve promptcycli en leidt tot reproduceerbare batches. Cloudflare-voorbeelden tonen JSON-prompts ingebed in multipart-formulieren.

4) Seed + versioning voor reproduceerbaarheid

Wanneer je reproduceerbare resultaten nodig hebt, geef een seed door en registreer modelversie/timestamp in metadata. Houd voor deterministische assetpipelines een manifest bij: prompt, seed, modelvariant, resolutie, referentieafbeelding-hashes. Dit verbetert traceerbaarheid en rollbackopties.

Conclusie

FLUX.2 is gericht op het dichten van de kloof tussen “indrukwekkende demo” en “productieve creatieve tool.” Met multireferentie-bewerking, high-res outputs, en een set gehoste endpoints (plus open inference-code en gequantiseerde consumentbuilds) biedt het teams veel praktische opties: lokaal draaien voor onderzoek en maatwerk, of de gehoste Pro/Flex-endpoints gebruiken voor stabiele productiepipelines.

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 Playground en raadpleeg de API-gids voor gedetailleerde instructies. Zorg ervoor dat je bent ingelogd bij CometAPI en de API-sleutel hebt verkregen voordat je toegang vraagt. CometAPI biedt een prijs die veel lager is dan de officiële prijs om je integratie te ondersteunen.

Klaar om te starten? → Meld je vandaag aan bij CometAPI!

Als je meer tips, gidsen en nieuws over AI wilt, volg ons op VK, X en Discord!