Bygg med CometAPITrenger du ett API for flere modeller?Test arbeidsflyten i Playground, og opprett deretter en API-nøkkel når modellen og kostnaden passer bruksområdet ditt.
Hvordan bruke FLUX 3 Image API med CometAPI - CometAPI
Bygg produktfotografier, plakater og referansebaserte redigeringer med FLUX 3 Image, tilgjengelig via CometAPI som flux-3-image, med priser fra $0,0384 per forespørsel. Denne veiledningen tar deg gjennom valg av bildeinnstillinger, forberedelse av en forespørsel, håndtering av en asynkron jobb og gjennomgang av det ferdige bildet. Du trenger en CometAPI-konto, en API-nøkkel og FLUX 3 Image-forespørselskonfigurasjonen som er levert for kontoen din.
Key Takeaways
Velg tekst-til-bilde for nye komposisjoner og referansestyrt redigering når et produkt eller motiv må forbli gjenkjennelig.
Bruk et lite utkast for å vurdere komposisjon før du bruker mer på et større sluttbilde.
Bruk CometAPI-legitimasjon og dens modellspecifikke forespørselsskjema; BFL-native nøkler og eksempler hører til en separat integrasjon.
Estimer kostnader fra gjeldende CometAPI-sats, og mål deretter forbruk per godkjent leveranse.
Gjennomgått for klarhet, kildeangivelse og gjeldende API-terminologi.
Fullfør én innsendelse, resultathenting, nedlasting og visuell gjennomgang før du kjører en batch.
What Is FLUX 3 Image API?
FLUX 3 Image er Black Forest Labs’ modell for å lage og revidere stillbilder. En tekstprompt beskriver en ny scene; referansebilder gir visuelt materiale som skal bevares, kombineres eller endres. For et e-handelsteam kan det bety å utvikle en produktscene fra et brief, og deretter gjenbruke et godkjent produktfoto mens omgivelsene endres.
Velg en arbeidsflyt før du skriver prompten. For et nytt visuelt uttrykk, spesifiser motiv, setting, lyssetting og innramming. For en redigering, identifiser kildebildet, navngi endringen, og angi hvilke detaljer som må forbli intakte. For en komposisjon med flere referanser, tildel hver referanse en rolle slik at produktidentitet og visuell stil ikke konkurrerer.
FLUX 3 Image Specifications and API Parameters
Planlegg bildet med innstillingene nedenfor. Modellkontroller følger BFL FLUX 3 Image API-referanse; autentisering og ruting av forespørsler følger CometAPI-integrasjonen din. Bruk feltnavnene som aksepteres av CometAPI FLUX 3 Image-ruten din.
Funksjon / innstilling
Hva den styrer
Slik bruker du det med CometAPI
Model identity
FLUX 3 Image; katalog-ID flux-3-image
Bruk modellspecifikk rute og rutingskonvensjon i kontoeksemplet ditt.
Generation / prompt
Scenen, komposisjonen eller redigeringsinstruksjonen
Start med ett tydelig motiv og ett tiltenkt utfall.
Reference images / native images
En ordnet liste på 1–10 referansebilder, levert som HTTP(S)-URLer eller base64 i den native API-en.
Bekreft gatewayens feltnavn, inndataformat og referansegrense.
Aspect ratio / native aspect_ratio
Lerretets proporsjoner. Med auto prioriteres et forhold som er bedt om i prompten; ellers beholder redigeringer innrammingen til den første referansen.
Velg et forhold for leveringsformatet og bekreft aksepterte verdier.
Resolution / native resolution
Native nivåer: 768sq, 1k (standard), 1.5k, 2k og 4k. Eksakte dimensjoner avhenger av sideforholdet.
For redigeringer bevarer match_input størrelsen til den første referansen, redusert til 4 MP hvis større; et eksplisitt aspect_ratio velger nærmeste nivå. Eksplisitt width og height har prioritet.
Exact dimensions / width + height
Oppgi begge heltall, hvert på 256–6256 piksler. De overstyrer resolution og aspect_ratio. Totalt areal er begrenset til 16,822,272 piksler, eller 4,194,304 piksler når referansebilder brukes.
Bruk eksplisitte dimensjoner for en fast leveringsstørrelse, som 1024 × 1280. Bekreft at CometAPI-ruten din aksepterer disse native kontrollene.
Layout control
Veiledning med avgrensningsbokser for plassering av elementer
Bruk den dokumenterte layoutsyntaksen når nøyaktig plassering er viktig.
Targeted edits
Endringer i utvalgte motiver eller regioner
Velg dimensjoner på én av tre måter: et oppløsningsnivå pluss sideforhold, width pluss height for et eksakt lerret, eller match_input for en redigering. Behold originalreferansen tilgjengelig slik at du kan sammenligne innramming og detaljer etter generering. Den native endepunktet avviser ikke-støttede felt; bruk skjemaet for ruten du kaller.
Detaljert bildekonstruksjon og pikselbevarende edits
Sammenlign de samme merke-promptene
Resolution
Variantavhengig høyoppløselig generering
Eksplisitt 2K/4K native-showcase
Inspiser fine detaljer ved full zoom
Editing
Multireferanse-kapasiteter i utvalgte varianter
Lokalisert redigeringsdemonstrasjoner
Mål drift i uendrede områder
Cost
Varierer etter variant og plattform
CometAPI-prising for valgt konfigurasjon
Sammenlign per godkjent bilde
CometAPI access
Tilgjengelig via CometAPI som FLUX 2 PRO og FLUX 2 MAX
Tilgjengelig via CometAPI som flux-3-image
Valider modellspecifikk forespørsel før du endrer produksjonsruting
Evaluation
Bruk eksakt varianten som er i produksjon i dag
Kjør samme prompt og referansesett
Sammenlign godkjente utdata og total arbeidsflytkostnad
Behold din nåværende FLUX.2-integrasjon som en sammenligningsbaseline mens du evaluerer FLUX 3 Image. Kjør de samme briefene og referansefilene gjennom begge arbeidsflyter, og sammenlign deretter godkjente utdata, gjennomløpstid og total kostnad.
How Do You Generate an Image with FLUX 3 Image API in CometAPI?
1. Prerequisites
Registrer deg på CometAPI og opprett en API-nøkkel.
Sett miljøvariabelen:
export COMETAPI_KEY="your_cometapi_key"
2. Endpoint
POST https://api.cometapi.com/flux/v1/flux-3-image
Autentisering bruker Bearer-token (CometAPI-stil). Forespørsler er asynkrone som standard.
3. Basic text-to-image example (cURL)
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 til status er "Ready". Bilde-URL-en vises i result.sample (last den ned raskt; signerte URL-er er midlertidige).
For synkron venting i samme forespørsel, legg til "async": false i body (hold tilkoblingen åpen; bruk raus klient-timeout).
5. Python example (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 støtter både ren tekst-til-bilde og redigering/multireferanse i samme endepunkt—bare inkluder images og beskriv hvordan de skal brukes i prompten (ingen separat “mode”-felt).
Alternative: OpenAI-compatible route
Du kan også prøve det samlede images-endepunktet med modell-ID-en:
POST https://api.cometapi.com/v1/images/generations
(Native `/flux/v1/...` foretrekkes for fullstendige FLUX 3-parametere.)
### Tips
* Sjekk gjeldende tilgjengelighet og nøyaktig prising på CometAPI-siden for Flux 3 Image-modellen.
* Last alltid ned `result.sample`-URL-en raskt.
* For den siste parameterlisten eller sandkasseeksempler, se CometAPI’s Flux-dokumentasjon og Black Forest Labs’ offisielle FLUX 3 Image-referanse.
Dette speiler den offisielle BFL-flyten mens du bruker CometAPI’s autentisering og enhetlige infrastruktur.
## How to Prompt FLUX 3 Image? Examples
### Example: Product Photography Prompt
Bruk denne prompten for en første test av produktfoto.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
Erstatt prompt-verdien i request.json med dette briefet, og behold forespørselskroppen forventet av CometAPI-ruten din. Et 4:5-lerret passer en portrettorientert produktplassering. Hvis ruten din aksepterer native dimensjonskontroller, er 1024 × 1280 et eksakt 4:5-alternativ; oppgi begge verdier sammen.
Start med et lite utkast og sjekk flaskesilhuett, etikett, refleksjoner og ekstra objekter. Hvis den eksakte produktidentiteten er viktig, bruk en produktreferanse i stedet for å forvente at en ren tekstprompt rekonstruerer den. Registrer prompt og utdata-innstillinger før du gjør endringer.
### Example: Typography and Poster Layout
Plakatprompt med eksplisitt angitt titteltekst.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Bruk dette briefet som prompt i CometAPI-forespørselen din og velg et portrettlerret. Start med et utkast for å sjekke tittelplassering og karakteroppsett, øk deretter utdata-størrelsen for det endelige kunstverket.
Behandle bokstavnøyaktighet som et målbar akseptkriterium. Gå gjennom hver bokstav og tegnsetting i utdata i sluttoppløsning; imponerende galleribilder garanterer ikke null feil i din spesifikke merketekst.
## How to Edit Images with References
For en redigering, beskriv både endringen du ønsker og detaljene som skal bevares. Den native FLUX 3 Image API-en tar referanser i images; map dem til tilsvarende inndatafelt i CometAPI-eksemplet ditt. Sett produktreferansen først og behold den rekkefølgen konsistent i prompten.
### Single-Image Editing: Change the Background, Preserve the Product
Hold edit.py ved siden av submit.py, poll.py og download.py. Sett PRODUCT_IMAGE_URL til en offentlig tilgjengelig HTTPS-produktfoto-URL, og kjør deretter python edit.py. Eksempelet nedenfor krever en rute som aksepterer den native images-tabellen. Bruk en redigeringsforespørsel uten konfliktende kildebildefelt, og endre mapping hvis CometAPI-eksemplet ditt bruker et annet inndatafelt. For å gjenoppta en lagret redigeringsoppgave, kjø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"))
Velg et skarpt produktfoto med lesbar etikett og tydelig silhuett. Send det inn i bildeinndataformatet som aksepteres av CometAPI-ruten din. Hvis den ruten støtter den native oppløsningsinnstillingen, bruk match_input for å beholde referansens innramming og størrelse innenfor modellens redigeringsgrenser.
BFL-galleriet demonstrerer en lokalisert redigering ved å legge til to dykkere. Disse offisielle før-og-etter-ressursene illustrerer hva du skal inspisere; de er ikke utdata fra en CometAPI-forespørsel kjørt for denne artikkelen.
BFL offisielt redigeringseksempel, før: den originale undervannsscenen med én dykker.
BFL offisielt redigeringseksempel, etter: to dykkere er lagt til i scenen. Inspiser både uendrede bakgrunnsområder og de nye motivene.
### Multi-Image Reference Editing: Combine Style and Product Identity
Hold produktet først og lys/stil-referansen som nummer to. Sett PRODUCT_IMAGE_URL og STYLE_IMAGE_URL, lagre koden nedenfor som multi_edit.py ved siden av de tre klientfilene, og kjør python multi_edit.py. Dette eksemplet krever en rute som aksepterer minst to referanser i images. Start med en redigeringsforespørsel uten konfliktende kildebildefelt. Gjenoppta en lagret jobb 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"))
Legg ved begge referansene ved å bruke modellspecifikt CometAPI-format. Vurder først om produktet beholdt sin identitet; vurder deretter om den andre referansen bidro med ønsket lys og farge. Hvis den også introduserer uønskede objekter eller bokstaver, forenkle den referansen eller gjør prompten mer eksplisitt.
## How to Use Bounding Boxes for Layout Control
Bruk bokser når flasken og overskriften må oppta forutsigbare regioner. Skriv en scenebeskrivelse med en ID for hvert element, og legg deretter til en JSON-tabell i prompten. BFLs format bruker bbox i [top, left, bottom, right]-rekkefølge på et 0–1000-rutenett; bokser hører hjemme i prompten, ikke i et eget API-felt.
Eksempelet nedenfor reserverer plass til en overskrift over flasken. Behold en portrettutdata-innstilling i request.json og lagre denne filen som layout.py ved siden av submit.py. Kjør python layout.py, deretter python poll_download.py layout-task.json. Bruk en rute som støtter denne layoutsyntaksen; inspiser resultatet for å sjekke om flasken og overskriften opptar de tiltenkte områdene.
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"))
Hold sideforholdet konsistent med layouten. Bokser veileder plassering snarere enn å klippe et objekt til en hard grense. Inspiser staving og avstand i overskriften i det lagrede bildet; legg til endelig merke-typografi i et designverktøy når eksakt typografi er essensielt.
## How Much Does FLUX 3 Image API Cost?
CometAPI tilbyr FLUX 3 Image fra $0,0384 per forespørsel (9. november 2026). Bruk denne startsatsen for et innledende budsjett, og bruk deretter satsen som vises for den valgte konfigurasjonen. Eksemplene nedenfor antar at hver fakturerte forespørsel bruker startsatsen.
| Fakturerte forespørsler | Antatt sats / forespørsel | Illustrativ kostnad |
| ----------------------- | ------------------------- | ------------------- |
| 1 | $0,0384 | $0,0384 |
| 10 | $0,0384 | $0,3840 |
| 100 | $0,0384 | $3,84 |
| 1000 | $0,0384 | $38,40 |
Sjekk satsen for valgt konfigurasjon og konto før du forplikter en batch. Den offentlige startsatsen fastsetter ikke prisen for hver oppløsning eller redigeringsopsjon. Spor avviste kreative forsøk så vel som godkjente utdata: hvis du bruker $3,84 på 100 fakturerte forespørsler og godkjenner 80 leveranser, er API-kostnaden per godkjent leveranse $0,048, før menneskelig gjennomgang og lagring. Dette er en illustrativ beregning, ikke en målt akseptgrad.
### Resolution Choices by Workflow
| Arbeidsflyt | Første test | Godkjenningssjekk |
| ----------------------------- | --------------------------------------------- | --------------------------------------------------- |
| Prompt exploration | Minste nyttige støttede nivå | Komposisjon og motivplassering |
| E-commerce product images | Et utkast med tiltenkt utsnitt | Produktgeometri, etiketter og kantdetaljer |
| Campaign or editorial artwork | Utkast først; større utdata etter layoutgodkjenning | Typografi og detaljer i leveringsstørrelse |
| Reference-based edits | En støttet innstilling tilpasset kilden | Uendrede områder, produktidentitet og lyssetting |
## When Should You Use FLUX 3 Video Instead?
Bruk FLUX 3 Image for stillaktiva som et produkt-hero-bilde, plakat eller kampanjeramme. Hvis leveransen trenger bevegelse, se på FLUX 3 Video på CometAPI, listet under separat modell-ID flux-3. Dens videoflyt bruker video-spesifikke innstillinger og fakturering. Hold bilde- og videoforepørsler adskilt; varighet, lyd og videorammekontroller hører ikke hjemme i en stillbildeforespørsel.
For en kampanje med begge formater, godkjenn stillbildekomposisjonen først, og forbered deretter bevegelsesbriefet separat. Sjekk videomodellens referanseinndatakrav før du gjenbruker et godkjent bilde som kildemateriale.
## Conclusion
Start med ett produktbrief og én liten bildejobb. Send den inn via CometAPI FLUX 3 Image-ruten din, lagre oppgave-ID-en, hent det fullførte bildet, og gjennomgå resultatet før du skalerer opp. Bruk width og height når du trenger et eksakt lerret, eller match_input for en referanseredigering der det støttes. Sammenlign totalforbruk med antall bilder du godkjenner slik at budsjettet ditt reflekterer brukbare resultater.
## SEO Metadata
Meta title: FLUX 3 Image API-veiledning: Generering, redigering og CometAPI
Meta description: Bruk FLUX 3 Image på CometAPI for generering og redigering. Lær bildeparametere, håndtering av asynkrone jobber, prompteksempler og priser fra $0,0384 per forespørsel.
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, FLUX 3 image editing, FLUX 3 priser, reference image generation, FLUX.2 migrering
URL slug: flux-3-image-api-guide
Sammenlign kilde og resultat i områder som skal forbli uendret.
Authentication
CometAPI API-nøkkel for gateway-forespørsler
Følg autentiseringsheaderne i CometAPI-eksemplet; hold nøkkelen på serveren.
Result handling
Asynkron generering: send inn en jobb, spor oppgavens ID, og hent det ferdige bildet.
Bruk Python-malen nedenfor når kontoruten din følger den dokumenterte CometAPI FLUX task-kontrakten.
Pricing
CometAPI-prising starter på $0,0384 per forespørsel (9. november 2026).
Bruk prisseksjonen nedenfor for et illustrativt budsjett; verifiser valgt konfigurasjon.
Extra fields
Native- og gateway-skjemaer varierer mellom modellgenerasjoner
Native FLUX 3 Image aksepterer width og height. Ikke gjenbruk seed eller input_image fra en eldre modell; bruk images for native referanseinput og følg gateway-skjemaet for CometAPI.
