Black Forest Labs: FLUX.2 Max
FLUX.2 [max] is het beeldmodel van Black Forest Labs voor veeleisende eindbeelden en consistente bewerkingen. Het gedocumenteerde profiel combineert visuele referenties, gedetailleerde scèneregie en webonderbouwing voor actuele onderwerpen, met uitvoer tot 4 megapixels.
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.2 [max] is het model met de hoogste kwaliteit in de FLUX.2-familie van Black Forest Labs voor beeldgeneratie en -bewerking. De fabrikant positioneert het voor veeleisende eindbeelden, nauwkeurig volgen van een complexe briefing en consistentie tussen bewerkingen. Het maakt een afbeelding vanuit een geschreven beschrijving of gebruikt aangeleverde afbeeldingen als visuele referenties. De onderscheidende mogelijkheid binnen de familie is zoeken ter onderbouwing: een aanvraag kan actuele informatie gebruiken in plaats van alleen de scène uit de prompt.
Informatie uit de echte wereld en de visuele briefing
De maker documenteert webzoekopdrachten voor onderwerpen zoals het huidige weer, een recente sportgebeurtenis of een historische omgeving. Geef de echte locatie, gebeurtenis en relevante tijd aan en beschrijf de artistieke uitwerking afzonderlijk. Een onderbouwd concept voor een weerkaart kan de stad, de te verbeelden weersomstandigheid, de exacte titel en de lay-out specificeren. Zoekresultaten leveren informatie voor de generatie; controleer bij een aantrekkelijke illustratie nog steeds de zichtbare feiten aan de hand van de relevante bron voordat je ze als feitelijke communicatie gebruikt.
Deze zoekfunctie hoort bij [max] in de gepubliceerde FLUX.2-vergelijking. De andere benoemde modellen hebben eigen rollen: [pro] voor productie, [flex] voor instelbare sampling en typografie en [klein] voor compacte interactieve generatie. Bewaar de gekozen modelnaam bij het resultaat, zodat een latere herziening het profiel met brononderbouwing niet stilzwijgend door een andere editie vervangt.
Referenties voor veeleisende bewerkingen
Het gedocumenteerde aanvraagprofiel accepteert maximaal acht referentiebeelden; de interactieve interface van de maker staat afzonderlijk tien toe. Geef elke referentie een rol, zoals personage-uiterlijk, productontwerp, kleding, kamer of visuele stijl. Een compositie kan de stoel uit de ene afbeelding combineren met de kamer uit een andere, met behoud van silhouet en materiaal van de stoel. Geef bij een bestaande scène aan welk object moet veranderen en welke details behouden moeten blijven, inclusief lichtrichting en omringende geometrie.
De familievoorbeelden omvatten achtergrondwijzigingen, vervanging van objecten, meubelcomposities, tekstbewerkingen en consistente personages. Een oorspronkelijke briefing voor een eindbeeld kan een aangeleverd horloge op donkere geplooide stof plaatsen, wijzerplaat en bandontwerp behouden en alleen de verlichting wijzigen naar zacht zijlicht. Benoem welke bron elk kenmerk levert en beoordeel wijzerplaat, markeringen, materiaal en reflecties van het resultaat samen. Een behoudsinstructie legt het doel vast; het teruggestuurde beeld vormt het bewijs om ermee te vergelijken.
Tekst, kleuren en promptinterpretatie
De FLUX.2-gids beveelt een structuur van onderwerp–actie–stijl–context aan, met belangrijke elementen eerst. Hij suggereert 10–30 woorden voor snelle concepten, 30–80 voor gewone projecten en langere beschrijvingen voor complexe scènes. Dit zijn schrijfaanbevelingen, geen harde contextlimieten. Natuurlijke taal en JSON-gestructureerde scènebeschrijvingen zijn beide gedocumenteerde manieren om onderwerpen, plaatsing, licht en stijl te ordenen. Een gestructureerde prompt is een beeldbriefing, geen belofte van een gestructureerd tekstantwoord.
Citeer voor zichtbare letters de formulering, specificeer de positie en beschrijf de typografische hiërarchie. Koppel elke hexadecimale kleur aan een bepaald object of tekstelement; een kleurcode zonder benoemd doel is dubbelzinnig. De makersgids gebruikt positieve beschrijvingen in plaats van een mechanisme voor negatieve prompts. Beschrijf bij een productscène met lege ruimte voor een kop die lege zone en haar bedoelde positie rechtstreeks.
De specifieke [max]-aanvraagspecificatie past standaard promptuitbreiding toe. De instelling disable_pup schakelt die uitbreiding uit wanneer een zorgvuldig geschreven briefing moet worden gebruikt zoals aangeleverd. Dat is iets anders dan beweren dat elk woord ongewijzigd in het uiteindelijke beeld verschijnt. Bewaar de daadwerkelijke briefing en gekozen instelling bij het resultaat om te beoordelen of een onverwachte visuele keuze uit de instructie of uit de interpretatie voortkwam.
Uitvoer en een bruikbaar eindbeeld
De familiegids documenteert afbeeldingen tot 4 megapixels, met expliciete afmetingen van minstens 64×64 en veelvouden van 16. Maximaal 2 megapixels is de aanbeveling voor gewoon gebruik. Het specifieke [max]-profiel vermeldt JPEG, PNG en WebP, met JPEG als standaard, en een optionele willekeurige seed. Kies het uitvoerformaat voor de beoogde plaatsing voordat je de compositie opbouwt. Beeldgeneratie door het model staat los van het schalen van een al afgewerkt beeld.
Bewaar afbeelding, referenties, prompt, afmetingen en modelidentiteit wanneer je de definitieve versie kiest. De FLUX.2-gids van de producent waarschuwt dat de ondertekende resultaatlink tijdelijk is, met tien minuten om het beeld op te halen. Controleer fijne tekst, objectidentiteit, lay-out, licht en uit zoekresultaten afkomstige feiten op de bedoelde weergavegrootte. Het bruikbare resultaat is het gekozen beeld met voldoende context om een exacte herziening voort te zetten, in plaats van een scène waarvan belangrijke details nooit met de briefing zijn vergeleken.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations black-forest-labs/flux.2-max
black-forest-labs/flux.2-maxAan de slag
FLUX.2 [max] is het beeldmodel van Black Forest Labs voor veeleisende eindbeelden en consistente bewerkingen. Het gedocumenteerde profiel combineert visuele referenties, gedetailleerde scèneregie en webonderbouwing voor actuele onderwerpen, met uitvoer tot 4 megapixels.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoer
text,image- Uitvoer
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten black-forest-labs/flux.2-max | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standaard— |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten png, jpeg | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 8 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of 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 getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen 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 geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor 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.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | 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 |
| Configuratiemegapixel van een uitvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper megapixel van de uitvoerafbeelding | Kosten Uitvoer · megapixel van een uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.14 per megapixel van de uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.14 schatting vóór generatie Deze raming is geen extra kost 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
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.2-max', '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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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 de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de teruggegeven X-Client-Request-ID voor de reconciliatie. Lees uitsluitend daadwerkelijk teruggegeven 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
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra black-forest-labs/flux.2-max
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Black Forest Labs: FLUX.2 Max
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·black-forest-labs/flux.2-max:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·black-forest-labs/flux.2-max:model,prompt,aspect_ratio,output_format,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·black-forest-labs/flux.2-max:n.minimum:1;n.maximum:1