modellen

Black Forest Labs: FLUX.3 Image

Markdown · JSON

Black Forest Labs: FLUX.3 Image

FLUX 3 Image maakt en bewerkt afbeeldingen vanuit een geschreven briefing en maximaal tien referenties. Het voegt promptgebaseerde begrenzingsvakken voor compositie en lokale wijzigingen toe, grounding via web en afbeeldingen en vijf resolutieklassen.

Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

FLUX 3 Image is het model van Black Forest Labs voor afbeeldingsgeneratie en -bewerking met expliciete compositiecontrole. Een tekstbeschrijving kan een nieuwe scène maken; aangeleverde afbeeldingen kunnen een onderwerp, een te herzien scène of verschillende te combineren elementen vastleggen. Met begrenzingsvakken kan een briefing aangeven waar elk element hoort en welke delen van een bestaande afbeelding moeten veranderen. Het resultaat is een afbeelding waarin de gevraagde scène, tekst en lay-out kunnen worden gecontroleerd.

Maak een scène of geef een bewerkingsinstructie

Beschrijf voor een nieuwe afbeelding onderwerp, handeling of houding, omgeving, licht en kadrering. Zet exacte tekst in de afbeelding tussen aanhalingstekens en geef aan waar deze verschijnt. Een oorspronkelijke productbriefing kan een rode kampeermok op een licht stenen oppervlak tonen, met een grote kop erboven en zacht ochtendlicht dat het oor zichtbaar maakt. Bepaal de relatie tussen kop, product en achtergrond in plaats van losse stijlwoorden aan te bieden.

Benoem bij bewerking het specifieke object en de wijziging: geef de mok een andere kleur, vervang een etiket, verplaats een figuur of verander de stijl van de scène. Eén bewerking vereist geen handmatig getekend vak. De gedocumenteerde procedure breidt de instructie vóór generatie uit en kan het benoemde element lokaliseren en automatisch een vak toevoegen. De geretourneerde uitgebreide prompt legt die interpretatie vast, wat nuttig is wanneer een instructie het verkeerde object selecteert of een ongewenst detail introduceert.

Combineer en bereid referentieafbeeldingen voor

Het specifieke producentprofiel accepteert één tot tien referenties, aangeleverd als afbeeldings-URL's of gecodeerde afbeeldingsdata. Elke afbeelding moet minimaal 256×256 pixels en maximaal 16 megapixels zijn. Benoem een referentie op basis van positie of zichtbare inhoud en leg de rol uit: de persoon uit Image 1, het jasje uit Image 2 en de kamer uit Image 3. Een afbeeldingsreferentie is een bron van visuele informatie en geen opdracht om elk ongerelateerd detail erin te kopiëren.

De beeldverhouding staat standaard op auto. In de aanvraagspecificatie heeft een in de prompt gevraagde verhouding voorrang; anders bepaalt de eerste referentie de kadrering, met vierkante uitvoer als terugval wanneer noch een referentie noch een gevraagde vorm die levert. Plaats voor een compositie de bedoelde scènereferentie eerst of kies de verhouding expliciet. Bewaar bronafbeeldingen en hun volgorde bij het resultaat zodat een latere revisie hetzelfde visuele uitgangspunt gebruikt.

Plaats elementen met begrenzingsvakken

Een lay-outprompt combineert een bijschrift met een JSON-array van elementrijen. Het bijschrift benoemt een element via een markering zoals <cup_1>; de rij bevat id, bbox en desc. Coördinaten zijn gehele getallen van 0 tot 1000 in de volgorde [top, left, bottom, right], gemeten vanaf de linkerbovenhoek. Zo beschrijft [0, 0, 500, 500] het kwart linksboven, ongeacht de pixelafmetingen van de afbeelding. Gebruik de beeldverhouding waarvoor de lay-out is ontworpen, want dat coördinatenraster rekt mee met het frame.

Een bewerkingsrij gebruikt in plaats daarvan from, src_bbox en tgt_bbox naast identificator en beschrijving. ref_image_0 betekent de eerste aangeleverde afbeelding. Gelijke bron- en doelvakken verankeren een element; verschillende vakken verplaatsen of schalen het. Een nieuwe rij zonder bron genereert de beschrijving op de doellocatie en maakt zo toevoegingen, vervangingen of kleurwijzigingen mogelijk. Een bronrij zonder doel verwijdert het element. Benoem toevoegingen en verwijderingen zowel in de geschreven instructie als in de rijen en behoud ankerrijen voor details die op hun plaats moeten blijven.

Geef letters een eigen vak en citeer de exacte tekst in desc. Vakken sturen plaatsing en schaal; het zijn geen uitsnijdmaskers, dus een element kan buiten de rechthoek uitsteken. De maker meldt dat nieuwe objecten in vakken van ongeveer 40×25 pixels in voorbeelden vaak niet verschenen. Laat voldoende zichtbare ruimte en controleer de bewerkte grenzen. Pixels buiten het doel blijven meestal stabiel, maar schaduwen, reflecties en nabijgelegen belichting kunnen toch veranderen.

Grounding, uitvoerklassen en bruikbare registraties

Het gedocumenteerde profiel schakelt grounding standaard in, zodat web- en afbeeldingszoekopdrachten de generatie kunnen voeden. Dit kan worden uitgeschakeld voor een briefing die alleen de aangeleverde beschrijving en referenties mag gebruiken. Benoem bij een werkelijk onderwerp locatie, gebeurtenis of object duidelijk en houd feitelijke inhoud gescheiden van artistieke behandeling. Door zoeken gevoede beelden moeten nog steeds met gezaghebbend materiaal worden vergeleken wanneer een label, object of afgebeelde gebeurtenis nauwkeurig moet zijn.

De vijf resolutieklassen zijn 768sq, 1k, 1.5k, 2k en 4k, met standaard 1k. Ze vertegenwoordigen klassen met gelijke pixeloppervlakte, dus de exacte breedte en hoogte hangen af van de gekozen verhouding. Vijftien vaste verhoudingen lopen van 21:9 via vierkante en portretformaten tot 9:21. Dit modelprofiel regelt formaat via verhouding en resolutie; het stelt de velden seed, width of height uit de FLUX.2-aanvraagprofielen niet beschikbaar. De gedocumenteerde versieselector benoemt momenteel een bewegende release en legt geen overeenkomst met gedateerde leveranciersgewichten vast.

De producentprocedure retourneert na asynchrone verwerking een afbeelding met de uitgebreide prompt. De ondertekende downloadlink voor de afbeelding is één uur geldig. Bewaar de daadwerkelijke afbeelding, definitieve prompt en referenties in plaats van op een tijdelijke link te vertrouwen. Vergelijk voor een beoordeeld beeld de gevraagde tekst, objectplaatsing, referentie-identiteit en het gewijzigde gebied op het beoogde weergaveformaat. Een voltooide generatie is het uitgangspunt voor het controleren van die visuele eisen.

Ailoot Ultra · Afbeeldingen POST /v1/images/generations black-forest-labs/flux-3-image

black-forest-labs/flux-3-image

Black Forest Labs /black-forest-labs/flux-3-image

Aan de slag

FLUX 3 Image maakt en bewerkt afbeeldingen vanuit een geschreven briefing en maximaal tien referenties. Het voegt promptgebaseerde begrenzingsvakken voor compositie en lokale wijzigingen toe, grounding via web en afbeeldingen en vijf resolutieklassen.

Toegestane invoer
Tekst · Afbeeldingen
Resultaten
Afbeeldingen

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Afbeeldingen POST /v1/images/generations
Invoertypen
text, image
Uitvoertypen
image
VeldTypeVereisteWaarden en limietenStandaard
VeldmodelTypestringVereisteVereistWaarden en limieten
black-forest-labs/flux-3-image
Standaard—
VeldpromptTypestringVereisteVereistWaarden en limieten
Minimumlengte: 1
Standaard—
VeldresolutionTypestringVereisteOptioneelWaarden en limieten
768, 1K, 1.5K, 2K, 4K
Standaard—
Veldaspect_ratioTypestringVereisteOptioneelWaarden en limieten
21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto
Standaard—
VeldnTypeintegerVereisteOptioneelWaarden en limieten
Minimum: 1
Maximum: 1
Standaard—
Veldinput_referencesTypearrayVereisteOptioneelWaarden en limieten
Minimumaantal items: 0
Maximumaantal items: 10
Standaard—
VeldproviderTypeobjectVereisteOptioneelWaarden en limietenStandaard—
Methodeparameters en levenscyclus
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, prompt
Parametermaterial_typesContracttext, image

Levenscyclus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarieven

Zo worden de uiteindelijke kosten berekend

De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.

Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.

Snelle modus
Niet opgegeven Wanneer de snelle modus is geselecteerd
Flexmodus
Niet opgegeven Wanneer de modus flex is geselecteerd
Maximale redeneerinspanning
Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt

Geschatte tarieven ter vergelijking

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

ConfiguratieTariefstaffelVerwachte hoeveelheidKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefVerwachte hoeveelheid—Kosten
Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens
Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens
Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens
ConfiguratieGeschatte generatiekostenTariefstaffel—Verwachte hoeveelheidschatting voor één generatieKosten
Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.082 schatting vóór generatie

Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie.

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →

Voorbeeldverzoeken

Ailoot Ultra · Afbeeldingen

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Resultaten ophalen en opslaan

Ailoot Ultra · Afbeeldingen

Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Lezen van andere inhoud
Bestaande eigen bestanden ophalen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle voltooide resultaten bewaren

Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.

Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.

Als het oorspronkelijke antwoord moet worden gecontroleerd

Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.

Antwoordvelden
VeldType
VeldcreatedType
Velddata[].urlType
Velddata[].b64_jsonType
VeldusageType

Aliasnamen

Modelaliasnamen

Ailoot Ultra black-forest-labs/flux-3-image

Aliasnamen voor methodepaden

/v1/images

Gerelateerde aanroeper-ID’s

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image
Welke invoer en resultaten zijn beschikbaar?

POST /v1/images/generations · black-forest-labs/flux-3-image: text, image → image

Welke velden gebruikt het verzoek?

POST /v1/images/generations · black-forest-labs/flux-3-image: model, prompt, resolution, aspect_ratio, n, input_references, provider

Welke limieten gelden?

POST /v1/images/generations · black-forest-labs/flux-3-image: n.minimum: 1; n.maximum: 1

Meer details

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement
Kies een abonnement met korting voor je terugkerende verzoeken.
Promotiecode tot 50%
Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.
Kosten in de geschiedenis
Model, tokens en bedrag worden per verzoek bewaard.

Kies een abonnement · Bekijk modelprijzen

Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie
Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.
Resellerlicentie
Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.
Documenten op de site
Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

Vraag een resellerlicentie aan · Aanbodvoorwaarden en licentieovereenkomst