Byg med CometAPIHar du brug for én API til flere modeller?Test workflowet i Playground, og opret derefter en API-nøgle, når model og pris passer til dit brugsscenarie.
Skab produktfotografier, plakater og referencebaserede redigeringer med FLUX 3 Image, tilgængelig via CometAPI som flux-3-image, med priser fra $0.0384 pr. forespørgsel. Denne guide hjælper dig med at vælge billedindstillinger, forberede en anmodning, håndtere et asynkront job og gennemgå det færdige billede. Du skal bruge en CometAPI-konto, en API-nøgle og den FLUX 3 Image-anmodningskonfiguration, der er leveret til din konto.
Vigtige pointer
Vælg tekst-til-billede til nye kompositioner og referenceguidet redigering, når et produkt eller emne skal forblive genkendeligt.
Brug et lille udkast for at vurdere komposition, før du bruger på et større endeligt billede.
Brug CometAPI-legitimationsoplysninger og det modelspecifikke anmodningsskema; BFL-native nøgler og eksempler hører til en separat integration.
Estimér omkostninger ud fra den relevante CometAPI-sats, og mål forbrug pr. accepteret leverance.
Gennemgået for klarhed, kildeangivelse og aktuel API-terminologi.
Gennemfør én indsendelse, resultathentning, download og visuel gennemgang, før du kører en batch.
Hvad er FLUX 3 Image API?
FLUX 3 Image er Black Forest Labs’ model til at skabe og revidere stillebilleder. En tekstprompt beskriver en ny scene; referencebilleder giver visuelt materiale at bevare, kombinere eller ændre. For et e-handelsteam kan det betyde at udvikle en produktscene ud fra et brief og derefter genbruge et godkendt produktfoto, mens omgivelserne ændres.
Vælg et workflow før du skriver prompten. For en ny visual: angiv motiv, setting, belysning og indramning. For en redigering: identificér kildebilledet, navngiv ændringen og angiv, hvilke detaljer der skal forblive intakte. For en komposition med flere referencer: tildel hver reference en rolle, så produktidentitet og visuel stil ikke konkurrerer.
FLUX 3 Image-specifikationer og API-parametre
Planlæg dit billede med indstillingerne nedenfor. Modelkontroller følger BFL FLUX 3 Image API-referencen; godkendelse og anmodningsrouting følger din CometAPI-integration. Brug de feltnavne, der accepteres af din CometAPI FLUX 3 Image-route.
Capability / setting
What it controls
How to use it with CometAPI
Model identity
FLUX 3 Image; katalog-ID flux-3-image
Brug den modelspecifikke route og routingkonvention i din kontoeksempel.
Generation / prompt
Scenen, kompositionen eller redigeringsinstruktionen
Start med ét klart motiv og ét tiltænkt output.
Reference images / native images
En ordnet liste på 1–10 referencebilleder, leveret som HTTP(S)-URL’er eller base64 i den native API.
Bekræft gatewayens feltnavn, inputformat og referencelimit.
Aspect ratio / native aspect_ratio
Lærredets proportioner. Med auto har en ratio i prompten prioritet; ellers bevarer redigeringer den første references indramning.
Vælg en ratio for leveringsformatet og bekræft accepterede værdier.
Resolution / native resolution
Native niveauer: 768sq, 1k (standard), 1.5k, 2k og 4k. Præcise dimensioner afhænger af billedformatet.
For redigeringer bevarer match_input den første references størrelse, reduceret til 4 MP hvis større; en eksplicit aspect_ratio vælger det nærmeste niveau. Eksplicit bredde og højde har prioritet.
Exact dimensions / width + height
Angiv begge heltal, hver 256–6256 pixels. De tilsidesætter resolution og aspect_ratio. Det samlede areal er begrænset til 16.822.272 pixels, eller 4.194.304 pixels når referencebilleder bruges.
Brug eksplicitte dimensioner til en fast leveringsstørrelse, f.eks. 1024 × 1280. Bekræft, at din CometAPI-route accepterer disse native kontroller.
Layout control
Bounding-box-vejledning til elementplacering
Brug den dokumenterede layoutsyntaks, når præcis placering er vigtig.
Targeted edits
Ændringer af udvalgte motiver eller områder
Sammenlign kilde og resultat i områder, som bør forblive uændrede.
Vælg dimensioner på én af tre måder: et opløsningsniveau plus billedformat, width plus height for et præcist lærred, eller match_input til en redigering. Bevar den originale reference, så du kan sammenligne indramning og detaljer efter generering. Den native endpoint afviser ikke-understøttede felter; brug skemaet for den route, du kalder.
Detaljeret billedkomposition og pixelbevarende redigering
Sammenlign de samme brandprompter
Resolution
Variantafhængig højopløst generering
Eksplicit 2K/4K native showcase
Inspicér fine detaljer ved fuld zoom
Editing
Multi-reference-funktioner i udvalgte varianter
Lokale redigeringsdemonstrationer
Mål drift i uændrede områder
Cost
Varierer efter variant og platform
CometAPI-priser for den valgte konfiguration
Sammenlign pr. accepteret billede
CometAPI access
Tilgængelig via CometAPI som FLUX 2 PRO og FLUX 2 MAX
Tilgængelig via CometAPI som flux-3-image
Validér den modelspecifikke anmodning, før produktionsrouting ændres
Evaluation
Brug den præcise variant, der er i drift i dag
Kør samme prompt og referencesæt
Sammenlign accepterede outputs og totale workflow-omkostninger
Bevar din nuværende FLUX.2-integration som sammenligningsbaseline, mens du evaluerer FLUX 3 Image. Kør de samme briefs og referenceassets gennem begge workflows, og sammenlign derefter accepterede outputs, gennemløbstid og samlet omkostning.
Hvordan genererer du et billede med FLUX 3 Image API i CometAPI?
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
Poll, indtil status er "Ready". Billedets URL vises i result.sample (download hurtigt; signerede URL’er er midlertidige).
For at vente synkront i samme anmodning, tilføj "async": false til body (bevar forbindelsen åben; brug en generøs klient-timeout).
5. Python-eksempel (submit + poll)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image understøtter både ren tekst-til-billede og redigering/multireference i samme endpoint — inkludér blot images og beskriv, hvordan de skal bruges i prompten (intet separat “mode”-felt).
Alternativ: OpenAI-kompatibel route
Du kan også prøve den samlede images-endpoint med model-ID:
For den seneste parameterliste eller playground-eksempler, se CometAPI’s Flux-dokumentation og Black Forest Labs’ officielle FLUX 3 Image-reference.
Dette spejler det officielle BFL-flow, mens der bruges CometAPI’s godkendelse og samlede infrastruktur.
Hvordan prompt’er du FLUX 3 Image? Eksempler
Eksempel: Prompt til produktfotografering
Brug denne prompt til en første test af produktfotografering.
En eksklusiv amber parfumeflaske centreret på mat kalksten, trekvart produktperspektiv, præcis flaskesilhuet, softbox nøglelys til venstre for kameraet, detaljeret kontaktskygge, subtile naturlige reflektioner, beige sømløs studiebaggrund, ingen ekstra flasker, intet vandmærke, ingen ændret brandtekst. Output: rent 4:5 e-handels hero-billede.
Erstat promptværdien i request.json med dette brief, og bevar body’en, som din CometAPI-route forventer. Et 4:5-lærred passer til et portrætprodukt. Hvis din route accepterer de native dimensionskontroller, er 1024 × 1280 en præcis 4:5-mulighed; angiv begge værdier sammen.
Start med et lille udkast og kontroller flaskens silhuet, etiket, reflektioner og ekstra objekter. Hvis den nøjagtige produktidentitet er vigtig, brug en produktreference i stedet for at forvente, at en ren tekstprompt rekonstruerer den. Registrér prompten og outputindstillingerne, før du laver ændringer.
Eksempel: Typografi og plakatlayout
Plakatprompt med eksplicit angivet titeltekst.
En editorial kunstplakat på varmt offwhite papir. Titeltekst præcist: THE SEED PARADE. Tre stiliserede gående frøkarakterer under titlen. To-farvet risograf-inspireret tryk, generøse margener, balanceret hierarki, skarp læsbar typografi, portrætformat.
Brug dette brief som prompt i din CometAPI-anmodning og vælg et portræt-lærred. Start med et udkast for at kontrollere overskriftens placering og karakterernes opstilling, og øg derefter outputstørrelsen til det endelige artwork.
Behandl bogstavnøjagtighed som en målbar acceptbetingelse. Gennemgå hvert bogstav og hvert tegn i endelig opløsning; imponerende galleribilleder garanterer ikke nul fejl i din specifikke brandtekst.
Hvordan redigerer du billeder med referencer?
Ved en redigering skal du beskrive både den ændring, du ønsker, og de detaljer, der skal bevares. Den native FLUX 3 Image API tager referencer i images; map dem til det tilsvarende inputfelt i dit CometAPI-eksempel. Sæt produktreferencen først og bevar den rækkefølge konsekvent i prompten.
Behold edit.py ved siden af submit.py, poll.py og download.py. Sæt PRODUCT_IMAGE_URL til et offentligt tilgængeligt HTTPS-produktfoto, og kør derefter python edit.py. Eksemplet nedenfor kræver en route, der accepterer den native images-array. Brug en redigeringsbody uden modstridende kildebilledfelter, og ændr mapping, hvis dit CometAPI-eksempel bruger et andet inputfelt. For at genoptage en gemt redigeringsopgave, kør python poll_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
# This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Vælg et skarpt produktfoto med læsbar etiket og tydelig silhuet. Indsend det i det billedinputformat, som din CometAPI-route accepterer. Hvis den route understøtter den native resolution-indstilling, brug match_input for at bevare referencens indramning og størrelse underlagt modellens redigeringsgrænser.
BFL-galleriet demonstrerer en lokaliseret redigering ved at tilføje to dykkere. Disse officielle før-og-efter-assets illustrerer, hvad der skal inspiceres; de er ikke outputs fra en CometAPI-anmodning, der er kørt for denne artikel.
BFL’s officielle redigeringseksempel, efter: to dykkere er tilføjet til scenen. Inspicér den uændrede baggrund såvel som de nye motiver.
Multibilled-referenceredigering: Kombinér stil og produktidentitet
Behold produktet først og belysning/stil-referencen som nummer to. Sæt PRODUCT_IMAGE_URL og STYLE_IMAGE_URL, gem koden nedenfor som multi_edit.py ved siden af de tre klientfiler, og kør python multi_edit.py. Dette eksempel kræver en route, der accepterer mindst to referencer i images. Start med en redigeringsbody uden modstridende kildebilledfelter. Genoptag en gemt opgave med python poll_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
# Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Vedhæft begge referencer med det modelspecifikke CometAPI-format. Gennemgå først, om produktet har bevaret sin identitet; vurder derefter, om den anden reference har bidraget med den tiltænkte lys og farve. Hvis den også introducerer uønskede objekter eller tekst, så forsimple den reference eller gør prompten mere eksplicit.
Hvordan bruger du bounding boxes til layoutkontrol?
Brug bokse, når flasken og overskriften skal optage forudsigelige regioner. Skriv en scenebeskrivelse med et ID for hvert element, og tilføj derefter en JSON-array til prompten. BFL’s format bruger bbox i rækkefølgen [top, left, bottom, right] på et 0–1000-gitter; bokse hører til inde i prompten, ikke i et separat API-felt.
Eksemplet nedenfor reserverer plads til en overskrift over flasken. Bevar et portræt-output i request.json og gem denne fil som layout.py ved siden af submit.py. Kør python layout.py, og derefter python poll_download.py layout-task.json. Brug en route, der understøtter denne layoutsyntaks; inspicér resultatet for at se, om flasken og overskriften optager de tiltænkte regioner.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
Bevar billedformatet konsistent med layoutet. Bokse vejleder placering frem for at klippe et objekt til en hård grænse. Inspicér overskriftens stavning og afstand i det gemte billede; tilføj endelig brandtypografi i et designværktøj, når præcis typografi er afgørende.
Hvad koster FLUX 3 Image API?
CometAPI tilbyder FLUX 3 Image fra $0.0384 pr. forespørgsel (9. november 2026). Brug denne startsats til et indledende budget, og anvend derefter satsen vist for din valgte konfiguration. Eksemplerne nedenfor antager, at hver faktureret forespørgsel bruger startsatsen.
Billed requests
Assumed rate / request
Illustrative cost
1
$0.0384
$0.0384
10
$0.0384
$0.3840
100
$0.0384
$3.84
1000
$0.0384
$38.40
Tjek satsen for din valgte konfiguration og konto, før du forpligter en batch. Den offentlige startpris fastlægger ikke prisen for hver opløsning eller redigeringsmulighed. Spor afviste kreative forsøg såvel som godkendte outputs: hvis du bruger $3.84 på 100 fakturerede forespørgsler og godkender 80 leverancer, er API-omkostningen pr. accepteret leverance $0.048, før menneskelig gennemgang og lagring. Dette er en illustrativ beregning, ikke en målt acceptrate.
Opløsningsvalg pr. workflow
Workflow
First test
Approval check
Prompt-udforskning
Mindste nyttige understøttede niveau
Komposition og motivplacering
E-handelsproduktbilleder
Et udkast med det tiltænkte crop
Produktgeometri, etiketter og kantdetaljer
Kampagne- eller editorial-kunst
Udkast først; større output efter layoutgodkendelse
Typografi og detaljer i leveringsstørrelse
Referencebaserede redigeringer
Et understøttet settingsvalg, der passer til kilden
Uændrede områder, produktidentitet og belysning
Hvornår bør du bruge FLUX 3 Video i stedet?
Brug FLUX 3 Image til stillesassets såsom et produkt-hero-billede, plakat eller kampagneramme. Hvis leverancen kræver bevægelse, kig på FLUX 3 Video på CometAPI, opført under det separate model-ID flux-3. Dets videoworkflow bruger videospecifikke indstillinger og fakturering. Hold billede- og videoanmodninger adskilt; varighed, lyd og videorammekontroller hører ikke til i en stillbilledanmodning.
For en kampagne med begge formater: godkend først kompositionen for stillbilledet, og forbered derefter motion-brief’et separat. Tjek videomodellens referenceinputkrav, før du genbruger et godkendt billede som kildemateriale.
Konklusion
Start med ét produktbrief og ét lille billedejob. Indsend det via din CometAPI FLUX 3 Image-route, gem task-ID’et, hent det færdige billede, og gennemgå resultatet, før du skalerer op. Brug width og height, når du behøver et præcist lærred, eller match_input til en referenceredigering, hvor det understøttes. Sammenlign det samlede forbrug med antallet af billeder, du godkender, så dit budget afspejler brugbare resultater.
Authentication
CometAPI API-nøgle til gateway-forespørgsler
Følg godkendelsesheaders i CometAPI-eksemplet; opbevar nøglen på serveren.
Result handling
Asynkron generering: indsend et job, spor dets task-ID, og hent det færdige billede.
Brug Python-skabelonen nedenfor, når din kontoroute følger den dokumenterede CometAPI FLUX-task-kontrakt.
Pricing
CometAPI-priser starter ved $0.0384 pr. forespørgsel (9. november 2026).
Brug prissektionen nedenfor til et illustrativt budget; verificér den valgte konfiguration.
Extra fields
Native og gateway-skemaer varierer på tværs af modelgenerationer
Native FLUX 3 Image accepterer width og height. Genbrug ikke seed eller input_image fra en ældre model; brug images til native referenceinput og følg gateway-skemaet for CometAPI.
