Black Forest Labs: FLUX.2 Max
FLUX.2 [max] is het afbeeldingsmodel van Black Forest Labs voor veeleisende definitieve beelden en consistente bewerkingen. Het gedocumenteerde profiel combineert visuele referenties, gedetailleerde scènecontrole en webgrounding 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 lid met de hoogste kwaliteit in de FLUX.2-familie van Black Forest Labs voor afbeeldingsgeneratie en -bewerking. De fabrikant positioneert het voor veeleisende definitieve beelden, het nauwkeurig volgen van complexe briefings en consistentie tussen bewerkingen. Het maakt een afbeelding op basis van een geschreven beschrijving of gebruikt aangeleverde afbeeldingen als visuele referenties. De onderscheidende familiefunctie is grounding search: een aanvraag kan actuele informatie gebruiken in plaats van alleen de scène uit de prompt.
Informatie uit de werkelijkheid en de visuele briefing
De maker documenteert webzoeken voor onderwerpen zoals het actuele weer, een recente sportgebeurtenis of een historische omgeving. Benoem de daadwerkelijke locatie, gebeurtenis en tijd die voor de afbeelding relevant zijn en beschrijf de artistieke behandeling afzonderlijk. Een concept voor een weerkaart met grounding kan de stad, de te visualiseren toestand, de exacte titel en de lay-out specificeren. Zoeken voedt de generatie; een aantrekkelijke illustratie moet nog steeds op zichtbare feiten worden gecontroleerd aan de hand van de relevante bron voordat deze feitelijke communicatie wordt.
Deze zoekfunctie hoort bij [max] in de gepubliceerde FLUX.2-vergelijking. De andere benoemde leden hebben hun 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 revisie het profiel met grounding niet ongemerkt vervangt door een andere editie.
Referenties voor veeleisende bewerkingen
Het gedocumenteerde aanvraagprofiel gebruikt maximaal acht referentieafbeeldingen; de interactieve interface van de maker staat afzonderlijk tien toe. Geef elke referentie een rol, zoals uiterlijk van een personage, productontwerp, kleding, kamer of visuele stijl. Een compositie kan de stoel uit één afbeelding combineren met de kamer uit een andere, terwijl het silhouet en materiaal van de stoel behouden blijven. Benoem voor een bestaande scène het te veranderen object en de te behouden details, inclusief lichtrichting en omringende geometrie.
De familievoorbeelden omvatten achtergrondwijzigingen, objectvervanging, meubelcomposities, tekstbewerking en consistente personages. Een oorspronkelijke briefing voor een definitief beeld kan een aangeleverd horloge op donkere gevouwen stof plaatsen, wijzerplaat en bandontwerp behouden en alleen de verlichting veranderen naar zacht zijlicht. Benoem welke bron elk kenmerk levert en beoordeel de resulterende wijzerplaat, markeringen, materialen en reflecties samen. Een behoudsinstructie bepaalt het doel; de geretourneerde afbeelding is het bewijs om daarmee te vergelijken.
Tekst, kleuren en promptinterpretatie
De FLUX.2-gids beveelt een structuur onderwerp–handeling–stijl–context aan, met belangrijke elementen eerst. De gids suggereert 10–30 woorden voor snelle concepten, 30–80 voor gewone projecten en langere beschrijvingen voor een complexe scène. Dit zijn schrijfadviezen en geen harde contextlimieten. Natuurlijke taal en scènebeschrijvingen in JSON-structuur zijn beide gedocumenteerde manieren om onderwerpen, plaatsing, licht en stijl te ordenen. Een gestructureerde prompt is een afbeeldingsbriefing en geen belofte van een gestructureerd tekstantwoord.
Citeer voor zichtbare letters de tekst, 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 makergids 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 de gewenste positie rechtstreeks.
De specifieke [max]-aanvraagspecificatie past prompt upsampling standaard toe. De instelling disable_pup schakelt die uitbreiding uit wanneer een zorgvuldig geschreven briefing moet worden gebruikt zoals aangeleverd. Dit verschilt van de bewering dat elk woord onveranderd in de uiteindelijke afbeelding verschijnt. Bewaar de daadwerkelijke briefing en gekozen instelling bij het resultaat wanneer je beoordeelt of een onverwachte visuele keuze uit de instructie of de interpretatie daarvan kwam.
Uitvoer en een bruikbaar definitief beeld
De familiegids documenteert afbeeldingen tot 4 megapixels, met expliciete afmetingen van minimaal 64×64 en veelvouden van 16. Maximaal 2 megapixels is het advies voor gewoon gebruik. Het specifieke [max]-profiel vermeldt JPEG, PNG en WebP, met standaard JPEG, en een optionele willekeurige seed. Kies het uitvoerformaat voor de beoogde plaatsing voordat je de compositie indeelt. Afbeeldingsgeneratie door het model staat los van het vergroten of verkleinen van een al voltooid 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 kleine tekst, objectidentiteit, lay-out, licht en eventuele feiten uit zoekresultaten op het beoogde weergaveformaat. Het bruikbare resultaat is het gekozen beeld met voldoende context om een exacte revisie 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 afbeeldingsmodel van Black Forest Labs voor veeleisende definitieve beelden en consistente bewerkingen. Het gedocumenteerde profiel combineert visuele referenties, gedetailleerde scènecontrole en webgrounding 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
- Invoertypen
text,image- Uitvoertypen
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} · 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.
| 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 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
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 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
| 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