TL;DR

Maak productfoto’s, posters en referentiegestuurde edits met FLUX 3 Image, beschikbaar via CometAPI als flux-3-image, geprijsd vanaf $0.0384 per request. Deze gids leidt je door het kiezen van beeldinstellingen, het voorbereiden van een request, het afhandelen van een asynchrone job en het beoordelen van de voltooide afbeelding. Je hebt een CometAPI-account, een API-sleutel en de voor jouw account geleverde FLUX 3 Image-requestconfiguratie nodig.

Belangrijkste punten

• Kies text-to-image voor nieuwe composities en referentiegestuurde editing wanneer een product of onderwerp herkenbaar moet blijven.
• Gebruik een kleine proefrender om de compositie te beoordelen voordat je uitgeeft aan een grotere eindafbeelding.
• Gebruik CometAPI-credentials en het modelspecifieke requestschema; BFL-native sleutels en voorbeelden horen bij een aparte integratie.
• Schat kosten in aan de hand van het toepasselijke CometAPI-tarief en meet vervolgens de uitgaven per geaccepteerd resultaat.
• Rond één cyclus van indienen, resultaat ophalen, downloaden en visuele review af voordat je een batch draait.

Wat is de FLUX 3 Image API?

FLUX 3 Image is het model van Black Forest Labs voor het maken en bewerken van stilstaande beelden. Een tekstprompt beschrijft een nieuwe scène; referentieafbeeldingen bieden visueel materiaal om te behouden, te combineren of te wijzigen. Voor een e-commerceteam kan dat betekenen: een productscene ontwikkelen op basis van een briefing en vervolgens een goedgekeurde productfoto hergebruiken terwijl de omgeving verandert.

Kies een workflow voordat je de prompt schrijft. Specificeer voor een nieuw beeld het onderwerp, de setting, belichting en kadrering. Voor een edit: identificeer de bronafbeelding, benoem de wijziging en geef aan welke details intact moeten blijven. Voor een compositie met meerdere referenties: geef elke referentie een rol, zodat productidentiteit en visuele stijl niet met elkaar concurreren.

FLUX 3 Image-specificaties en API-parameters

Plan je afbeelding met de onderstaande instellingen. Modelbesturingen volgen de BFL FLUX 3 Image API reference; authenticatie en request-routing volgen je CometAPI-integratie. Gebruik de veldnamen die je CometAPI FLUX 3 Image-route accepteert.

Kies afmetingen op drie manieren: een resolutieniveau plus beeldverhouding, width plus height voor een exact canvas, of match_input voor een edit. Houd de originele referentie beschikbaar zodat je na generatie kadrering en detail kunt vergelijken. De native endpoint wijst niet-ondersteunde velden af; gebruik het schema van de route die je aanroept.

FLUX.2 vs FLUX 3 Image

Behoud je huidige FLUX.2-integratie als vergelijkingsbasis tijdens de evaluatie van FLUX 3 Image. Laat dezelfde briefings en referentie-assets door beide workflows lopen en vergelijk vervolgens geaccepteerde outputs, doorlooptijd en totale kosten.

Hoe genereer je een afbeelding met FLUX 3 Image API in CometAPI?

1. Vereisten

• Meld je aan bij CometAPI en maak een API-sleutel.
• Stel de omgevingsvariabele in:

export COMETAPI_KEY="your_cometapi_key"

2. Endpoint

POST https://api.cometapi.com/flux/v1/flux-3-image

Authenticatie gebruikt een Bearer-token (CometAPI-stijl). Requests zijn standaard asynchroon.

3. Basisvoorbeeld text-to-image (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"
  }'

Succesvolle asynchrone response (voorbeeldvorm):

{
  "id": "<task_id>",
  "status": "Pending",
  "result": {},
  "polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}

4. Poll voor het resultaat

curl "https://api.cometapi.com/flux/v1/get_result?id=<task_id>" \
  -H "Authorization: Bearer $COMETAPI_KEY"

Poll totdat status "Ready" is. De afbeeldings-URL verschijnt in result.sample (download deze snel; ondertekende URL’s zijn tijdelijk).

Voor een synchrone wachttijd in hetzelfde request voeg je "async": false toe aan de body (houd de verbinding open; gebruik een royale client-timeout).

5. Python-voorbeeld (indienen + pollen)

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 ondersteunt pure text-to-image én editing/multireferentie in dezelfde endpoint—voeg gewoon images toe en beschrijf in de prompt hoe je ze gebruikt (geen apart “mode”-veld).

Alternatief: OpenAI-compatibele route

Je kunt ook de uniforme images-endpoint proberen met het model-ID:

POST https://api.cometapi.com/v1/images/generations
{
  "model": "flux-3-image",
  "prompt": "your prompt here",
  "size": "1024x1024"
}

(Native /flux/v1/... heeft de voorkeur voor volledige FLUX 3-parameters.)

Tips

• Controleer de huidige beschikbaarheid en exacte prijzen op de CometAPI Flux 3 Image-modelpagina.
• Download de URL in result.sample altijd snel.
• Raadpleeg voor de nieuwste parameterlijst of playground-voorbeelden de Flux-docs van CometAPI en de officiële FLUX 3 Image-referentie van Black Forest Labs.

Dit weerspiegelt de officiële BFL-flow, maar gebruikt CometAPI-authenticatie en -infrastructuur.

Hoe prompt je FLUX 3 Image? Voorbeelden

Voorbeeld: Productfotografie-prompt

Gebruik deze prompt voor een eerste productfotografietest.

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.

Vervang de promptwaarde in request.json door deze briefing en behoud de request-body die je CometAPI-route verwacht. Een 4:5-canvas is geschikt voor een staand productbeeld. Als je route de native dimensiecontrols accepteert, is 1024 × 1280 een exact 4:5-alternatief; lever beide waarden samen aan.

Begin met een kleine proef en controleer de flacon-silhouet, het etiket, reflecties en extra objecten. Als de exacte productidentiteit belangrijk is, gebruik dan een productreferentie in plaats van te verwachten dat een prompt op tekstbasis deze reconstructie levert. Noteer de prompt en outputinstellingen voordat je wijzigingen aanbrengt.

Voorbeeld: Typografie en posterlay-out

Posterprompt met expliciet gespecificeerde titeltekst.

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.

Gebruik deze briefing als de prompt in je CometAPI-request en kies een staand canvas. Begin met een proef om de positie van de kop en de rangschikking van de figuren te controleren, verhoog daarna de uitvoergrootte voor het eindwerk.

Behandel letternauwkeurigheid als een meetbare acceptatievoorwaarde. Controleer elke letter en elk leesteken in de output op eindresolutie; indrukwekkende galerijbeelden garanderen geen foutloze tekst voor jouw specifieke merktekst.

Hoe bewerk je afbeeldingen met referenties

Beschrijf voor een edit zowel de gewenste wijziging als de details die je wilt behouden. De native FLUX 3 Image API neemt referenties aan in images; koppel ze aan het corresponderende invoerveld in je CometAPI-voorbeeld. Zet de productreferentie eerst en houd die volgorde consistent in de prompt.

Single-image editing: verander de achtergrond, behoud het product

Bewaar edit.py naast submit.py, poll.py en download.py. Stel PRODUCT_IMAGE_URL in op een publiek toegankelijke HTTPS-productfoto en voer vervolgens python edit.py uit. Onderstaand voorbeeld vereist een route die de native images-array accepteert. Gebruik een bewerkingsrequest zonder conflicterende bronafbeeldingsvelden en wijzig de mapping als je CometAPI-voorbeeld een ander invoerveld gebruikt. Om een opgeslagen bewerkingstaak te hervatten, voer je python poll_download.py editing-task.json uit.

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"))

Kies een scherpe productfoto met een leesbaar etiket en een duidelijke silhouet. Dien deze in het invoerformaat voor afbeeldingen in dat je CometAPI-route accepteert. Als die route de native resolutie-instelling ondersteunt, gebruik dan match_input om de kadrering en grootte van de referentie te behouden, met inachtneming van de bewerkingslimieten van het model.

De BFL-galerij demonstreert een gelokaliseerde edit door twee duikers toe te voegen. Deze officiële voor-en-na-assets illustreren wat je moet inspecteren; het zijn geen outputs van een CometAPI-request dat voor dit artikel is uitgevoerd.

Officieel BFL-bewerkingsvoorbeeld, na: twee duikers zijn aan de scène toegevoegd. Inspecteer de ongewijzigde achtergrond evenals de nieuwe onderwerpen.

Editing met meerdere referenties: combineer stijl en productidentiteit

Zet het product eerst en de belichting/stijlreferentie als tweede. Stel PRODUCT_IMAGE_URL en STYLE_IMAGE_URL in, sla onderstaande code op als multi_edit.py naast de drie clientbestanden en voer python multi_edit.py uit. Dit voorbeeld vereist een route die minstens twee referenties in images accepteert. Begin met een bewerkingsrequest zonder conflicterende bronafbeeldingsvelden. Hervat een opgeslagen job met 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"))

Koppel beide referenties via het modelspecifieke CometAPI-formaat. Beoordeel eerst of het product zijn identiteit heeft behouden; beoordeel daarna of de tweede referentie de beoogde licht en kleur heeft bijgedragen. Als deze ook ongewenste objecten of tekst introduceert, vereenvoudig die referentie of maak de prompt explicieter.

Hoe gebruik je bounding boxes voor lay-outcontrole

Gebruik boxes wanneer de flacon en kop voorspelbare regio’s moeten innemen. Schrijf een scenebeschrijving met een ID voor elk element en voeg vervolgens een JSON-array toe aan de prompt. Het BFL-formaat gebruikt bbox in [top, left, bottom, right]-volgorde op een 0–1000-raster; boxes horen in de prompt, niet in een apart API-veld.

Onderstaand voorbeeld reserveert ruimte voor een kop boven de flacon. Gebruik een staande outputinstelling in request.json en sla dit bestand op als layout.py naast submit.py. Voer python layout.py uit en vervolgens python poll_download.py layout-task.json. Gebruik een route die deze lay-outsyntaxis ondersteunt; inspecteer het resultaat om te controleren of de flacon en kop de beoogde regio’s innemen.

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"))

Houd de beeldverhouding consistent met de lay-out. Boxes sturen de plaatsing aan in plaats van een object hard te begrenzen. Inspecteer de spelling en spatiëring van de kop in de opgeslagen afbeelding; voeg definitieve merklettering toe in een ontwerptool wanneer exacte typografie essentieel is.

Wat kost de FLUX 3 Image API?

CometAPI biedt FLUX 3 Image vanaf $0.0384 per request (9 november 2026). Gebruik dit starttarief voor een eerste budget en pas vervolgens het tarief toe dat voor jouw geselecteerde configuratie wordt getoond. De onderstaande voorbeelden gaan ervan uit dat elke gefactureerde request het starttarief gebruikt.

Controleer het tarief voor je geselecteerde configuratie en account voordat je een batch start. De openbare startprijs bepaalt niet de prijs van elke resolutie- of bewerkingsoptie. Houd zowel afgewezen creatieve pogingen als goedgekeurde outputs bij: als je $3.84 uitgeeft aan 100 gefactureerde requests en 80 deliverables goedkeurt, zijn de API-kosten per geaccepteerde deliverable $0.048, exclusief menselijke review en opslag. Dit is een illustratieve berekening, geen gemeten acceptatiegraad.

Resolutiekeuzes per workflow

Wanneer gebruik je in plaats daarvan FLUX 3 Video?

Gebruik FLUX 3 Image voor stilstaande assets zoals een product-hero, poster of campagneframe. Als het deliverable beweging vereist, kijk dan naar FLUX 3 Video op CometAPI, vermeld onder het aparte model-ID flux-3. De videowerkstroom gebruikt video-specifieke instellingen en billing. Houd image- en videorequests gescheiden; duur, audio en videoframe-besturingen horen niet in een still-image-request.

Voor een campagne met beide formaten keur je eerst de compositie van de stilstaande afbeelding goed en bereid je vervolgens de motion-briefing apart voor. Controleer de referentie-invoervereisten van het videomodel voordat je een goedgekeurde afbeelding hergebruikt als bronmateriaal.

Conclusie

Begin met één productbriefing en één kleine beeldjob. Dien deze in via je CometAPI FLUX 3 Image-route, sla het taak-ID op, haal de voltooide afbeelding op en beoordeel het resultaat voordat je opschaalt. Gebruik width en height wanneer je een exact canvas nodig hebt, of match_input voor een referentie-edit waar ondersteund. Vergelijk de totale uitgaven met het aantal afbeeldingen dat je goedkeurt, zodat je budget de bruikbare resultaten weerspiegelt.