Sådan bruger du Flux.2 API? Alt du behøver at vide

CometAPI
AnnaNov 27, 2025
Sådan bruger du Flux.2 API? Alt du behøver at vide

FLUX.2 er Black Forest Labs' andengenerationsfamilie af billedgenererings- og billedredigeringsmodeller (udgivet 25. november 2025). Den tilbyder fotorealisme i produktionskvalitet, multireferenceredigering op til 4MP, struktureret/JSON-promptering og et valg af administrerede slutpunkter (Pro, Flex) og åbne indstillinger (Dev).

Den gode nyhed er, at CometAPI har integreret Flux.2 API'en. Denne guide forklarer, hvad FLUX.2 er, hvordan man kalder API'en, og avancerede arbejdsgange (tekst→billede, fleksibel kontrol, redigering af flere referencer) med kodeeksempler og bedste praksis.

Hvad er FLUX.2, og hvorfor er det vigtigt?

FLUX.2 er opfølgeren til FLUX-familien af ​​billedmodeller – udviklet til tekst-til-billede-generering i høj kvalitet og billedredigering med flere referencer i produktionsopløsninger (op til ~4 megapixels). FLUX.2 er bygget til virkelige kreative arbejdsgange (brandsikre aktiver, ensartede tegn og stilarter på tværs af referencer, bedre typografi og små detaljer) snarere end demoer, og den sigter mod at lukke kløften mellem genererede og virkelige billeder.

Nøgleresultater FLUX.2 er designet til at levere

  • Fotorealistiske output egnede til reklamer, produktbilleder og UI-mockups.
  • Indbygget redigering med flere referencer: kombiner, bytt eller sammensæt elementer fra flere inputbilleder i en enkelt redigering.
  • Varianter til forskellige anvendelsesscenarier: åbent tilgængelige udviklermodeller, et Pro-slutpunkt optimeret til produktion og et Flex-slutpunkt til lavniveaukontrol.

På et overordnet niveau kombinerer FLUX.2 en latent generativ rygrad (flow/transformer-arkitektur) med en vision-sprog-model til semantisk forankring og en nyuddannet VAE for at give et delt latent rum på tværs af varianter. Dette design lader modellen udføre både generering og rekonstruktion (redigering) med højere nøjagtighed, samtidig med at repræsentationen forbliver lærbar til træning og finjustering. Den åbne VAE er især bemærkelsesværdig, fordi den standardiserer det latente rum til hostede og selvhostede arbejdsgange.

Hvorfor det er vigtigt: Kobling af sprog og latent flowmatching giver stærkere prompt following (så flerdelte, kompositionelle instruktioner opfører sig forudsigeligt), bedre typografi og en enkelt arkitektur, der understøtter både generering og redigering med flere referencer. For skabere betyder det mere pålidelige output til komplekse instruktioner og blandede input (tekst + billeder).

Hvordan får jeg adgang til FLUX.2 API'en?

Forbered miljøet

Registrer dig og log ind på CometAPI, og hent din API-nøgle fra dit profilpanel. Ideelt set bør du have en vis API-viden som udvikler (vi hjælper gerne med dette, så bare rolig).

Du skal også vælge din ønskede anmodningsmetode og den passende Flux.2-model.

Hvilke slutpunkter og godkendelse kræves?

Replicate Predictions API'en giver adgang til at generere billeder i høj kvalitet ved hjælp af forskellige FLUX-modeller fra Black Forest Labs via standardformatet Replicate. Denne API understøtter en omfattende række FLUX-modelvarianter, der hver især er optimeret til forskellige anvendelsesscenarier, lige fra hurtig prototyping til professionel billedgenerering. Brugere kan problemfrit skifte mellem forskellige modeller ved blot at ændre modelnavnet i URL-stien (https://api.cometapi.com/replicate/v1/models/{models}/predictions), hvilket gør den fleksibel til forskellige kreative og kommercielle applikationer.

CometAPI eksponerer administrerede slutpunkter under https://api.cometapi.com/flux/v1/{model} og navngiver slutpunkter som flux-2-pro, flux-2-flex og flux-2-flex til oprettelse og redigering af billeder. Anmodninger kræver en API-nøgle i x-key overskrift.

Modelfamilie og beregningsafvejninger

  • FLUX.2 (åbne vægte) — Bruges når du har brug for lokal kontrol, forskningseksperimenter eller til at køre inferens på din egen infrastruktur. Udvikling er åben (32B) og fremragende til udforskende forskning og finjustering. Det er mere konfigurerbart, men du er ansvarlig for infrastruktur og optimering.
  • FLUX.2 pro — Den bedste balance mellem hastighed, kvalitet og omkostninger i produktionen. Pro er optimeret til forudsigelig latenstid, ensartet og hurtig overholdelse af indstillinger, hurtig gennemløbshastighed og understøtter op til 8 API-referencebilleder (9MP i alt via API). Brug dette til redigering i store mængder, og når du har brug for pålidelighed og forudsigelig pris.
  • FLUX.2 (styret + styrbarhed) — Afslører lavniveau-genereringskontroller (f.eks. steps, guidance) og understøtter flere referencer (op til 10) og lidt højere kvalitet/detaljering, når du accepterer højere latenstid og omkostninger. Brug Flex, når du har brug for den endelige kreative kontrol - typografisk nøjagtighed, præcise farver eller meget detaljerede kompositionsjusteringer.

Prototype på dev eller en lavpris om planlæg, og flyt derefter til om for skala eller Flex for meget kontrollerede endelige renderinger.

Hvordan bruger jeg FLUX.2 API'en?

Anmodningslivcyklus (opgave + pollingmodel)

Svar på redigerings-/genereringsanmodninger er opgaveobjekter der inkluderer a polling_url og id; du opretter en anmodning og afspørger derefter (eller bruger webhooks) for at hente den signerede resultat-URL. Signerede URL'er er kortlivede (typisk ~10 minutter), så hent output hurtigt.

Den hostede API følger en asynkron opgavemodel:

  1. POST en genereringsanmodning → returnerer en task id og polling_url plus estimeret cost.
  2. Afstemning polling_url indtil status == "Ready", og hent derefter billedresultatet (ofte base64 eller en hosted URL).

Eksempel: Python (anmodninger) — indsend og afstem

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

Dette mønster (send → afstemning eller webhook) er det primære synkrone/asynkrone flow for de administrerede slutpunkter.

Billedredigering — minimalt eksempel (krøl med 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": "https://example.com/my-photo.jpg",
    "width": 2048,
    "height": 1536
  }'

Til redigering af flere referencer skal du bruge input_image, input_image_2, input_image_3, … (Pro understøtter op til 8 referencer via API; Flex op til 10; Udvikler anbefaler maks. ~6 afhængigt af hukommelse).

Hvilke grundlæggende parametre skal jeg sende?

Vigtige felter i anmodningens brødtekst (billedredigering/generering) inkluderer:

  • guidance og steps — tillader finmasket kontrol.
  • prompt (streng) — op til 32 tokens; detaljeret naturligt sprog eller struktureret JSON.
  • input_image (streng) — påkrævet for redigeringer (URL eller base64).
  • input_image_2 ... input_image_9 — billeder med flere referencer.
  • width / height — multipla af 16; output maks. 4MP.
  • seed — heltal for reproducerbarhed.
  • safety_tolerance — moderationsniveau.

Hvordan kan jeg udnytte FLUX.2 Pro til professionel tekst-til-billede-generering?

FLUX.2 Pro er optimeret til pålidelige resultater af høj kvalitet. Brug den, når du har brug for ensartede resultater på brandniveau, hurtig ekspeditionstid og SLA'er til virksomheder.

Opskrift på arbejdsgang — produktionsbilleder

  1. Forbehandlingsprompter: Hold en kort "intention"-linje plus en struktureret attributsektion (belysning, linse, stemning, hex-farvekoder for brandfarver). FLUX.2 understøtter hex-farvestyring for at bevare brandpaletter.
  2. Start med konservative standardindstillinger: trin 30-50 og vejledningsskala 6-9.0; øg trin for detaljer, øg vejledningen for at sikre, at resultaterne overholder prompten mere nøje.
  3. Brug frø + deterministisk prøveudtagning for reproducerbarhed i A/B-testning.
  4. Brug Pro-slutpunktet til multi-forsøgsprøvetagning: anmod om N variationer parallelt og vælg den bedste — billigere og hurtigere end manuel hyperparameterjustering.
  5. Efterbehandling: støjreduktion, mindre tonekortlægning eller vektorlignende touchups i en deterministisk pipeline. Overvej en lille GAN- eller superopløsningsgennemgang, hvis du har brug for højere output end det oprindelige.

Hvorfor disse trin hjælper: Pro balancerer hastighed og kvalitet og håndhæver normalt sikkerheds-/indholdsfiltre efter generation, så det er den fornuftige standard for kundevendte aktiver.

De bedste tips til at generere billeder

1. Strukturerede prompt-gevinster for produktionen. Organiser prompts efter prioritet: emne → handling → stil → kontekst. Brug JSON-prompts (scene, emner, kamera, belysning, farvepalet), når du har brug for deterministisk komposition på tværs af mange billeder. Eksempel på brug af JSON-skema (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. Reproducerbarhed: Pass seed at reproducere senere. Behold en katalogkortlægningsprompt + seed → billede for sporbarhed.

3. Batch- og orkestrering: Ved store produktionskørsler skal du indsende mange anmodninger parallelt med Pro, men begrænse hastigheden for at undgå begrænsning; foretræk Pro-slutpunktet for forudsigelig latenstid. Brug jobkøer og arbejderpuljer til hurtigt at downloade signerede resultater, når de er klar.

4. Moderering og sikkerhed: Brug safety_tolerance at kontrollere strengheden af ​​moderering. Pro-slutpunkter omfatter brugspolitikker og hooks til indholdsmoderering; integrer server-side kontroller før publicering.

5. Efterbehandling: Professionelle output er af høj kvalitet, men kræver lejlighedsvis små retoucheringer. Byg et automatiseret efterbehandlingstrin (beskæring, farvegradering, sammensætning) i din pipeline, og behold menneskelig gennemgang af brandfølsomme aktiver.

Hvordan kan jeg tilpasse output med FLUX.2 Flex-slutpunktet?

Flex er varianten af ​​"kirurgisk værktøj": finjuster trin, vejledning, negative prompter, flisestørrelser og referenceantal for at forme outputtet præcist.

Hvornår skal man vælge Flex

  • Du har brug for præcis typografisk gengivelse (UI-mockups, etiketter).
  • Du skal sammensætte flere referencer med kontrol over posering og belysning.
  • Du eksperimenterer med avancerede promptteknikker (strukturerede prompter, kæder af begrænsninger).

Eksempel — Flex-kontroltaster og deres effekter

  • steps — flere trin = finere detaljer (på bekostning af latenstid).
  • guidance_scale — højere = tættere på tekstprompten, lavere = mere kreativitet.
  • negative_prompt — fjern eksplicit elementer (f.eks. "intet vandmærke, ingen ekstra fingre").
  • tile_size / tiled_inference — for generering med meget høj opløsning, tile inferensplads for at bytte hukommelse for hastighed.
  • reference_weights — nogle slutpunkter giver dig mulighed for at vægte referencer til bias, hvilket billede driver pose vs. stil.

Praktisk tip: For komplekse kompositioner, kør en kort forhåndsvisning med lav vejledning for at verificere kompositionen, og opskaler derefter med flere trin og højere vejledning. Denne to-trinsteknik reducerer omkostningerne, samtidig med at den giver præcise endelige resultater.

Eksempel: Fleksibel anmodning med trin og vejledning

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: Brug Flex under de endelige kreative godkendelser og Pro til store, hurtigere pipelines. Flex er mærkbart mere kontrollerbart til typografi og mikrodetaljeopgaver.

Bedste praksis for produktionsbrug

Nedenfor er gennemprøvede mønstre og pragmatiske råd til integration af FLUX.2 i stor skala.

1) Kontroller omkostningerne ved at spore megapixels og caching

FLUX.2-fakturering er baseret på megapixels input + outputFor generering af store mængder, foretræk mindre preview-renderinger (hurtige trin i lav opløsning) og eskaler kun til endelige renderinger med højere MP. Cache renderede aktiver (eller gem diffs), så du ikke gengiver identiske job igen. Vis altid cost i svar og log det pr. anmodning.

2) Brug niveauer smart: forhåndsvisning vs. endelig gengivelsesdeling

  • Kør hurtige Pro-renderinger med lavt step til prototyping eller mange varianter.
  • Brug Flex- eller High-MP Pro-kørsler til endeligt godkendte output, hvor kvaliteten af ​​billeder er vigtig. Denne hybride tilgang balancerer gennemløbshastighed og endelig billedkvalitet.

3) Prompt engineering → strukturerede prompts & JSON

Udnyt FLUX.2's struktureret JSON-prompt når du har brug for deterministisk komposition (sceneobjekter, kamera, poseringer, hex-farveprøver). Dette reducerer iterative promptcyklusser og fører til mere reproducerbare batches. Cloudflare-eksempler viser JSON-prompter integreret i flerdelte formularer.

4) Seed + versionsstyring for reproducerbarhed

Når du har brug for reproducerbare resultater, skal du sende en seed og registrer modelversion/tidsstempel i metadata. For deterministiske asset pipelines skal du beholde et manifest: prompt, seed, modelvariant, resolution, reference image hashes. Dette forbedrer sporbarhed og rollback-muligheder.

Konklusion

FLUX.2 har direkte til formål at lukke kløften mellem "imponerende demo" og "kreativt produktionsværktøj". Med multireferenceredigering, output i høj opløsning og et sæt hostede slutpunkter (plus åben inferenskode og kvantiserede forbrugerbuilds) giver det teams en masse praktiske muligheder: Kør lokalt til research og tilpasning, eller brug de hostede Pro/Flex-slutpunkter til stabile produktionspipelines.

Udviklere kan få adgang Flux.2 Dev API, Flux.2 Flex API og Flux.2 Pro API gennem CometAPI. For at begynde, udforsk CometAPI's modelfunktioner i Legeplads og konsulter  API guide for detaljerede instruktioner. Før du får adgang, skal du sørge for at være logget ind på CometAPI og have fået API-nøglen. CometAPI tilbyde en pris, der er langt lavere end den officielle pris, for at hjælpe dig med at integrere.

Klar til at gå? → Tilmeld dig CometAPI i dag !

Hvis du vil vide flere tips, guider og nyheder om AI, følg os på VK, X og Discord!

Læs mere

500+ modeller i én API

Op til 20% rabat