Black Forest Labs: FLUX.2 Max
FLUX.2 [max] är Black Forest Labs bildmodell för krävande slutmaterial och konsekventa redigeringar. Den dokumenterade profilen kombinerar visuella referenser, detaljerad scenkontroll och webbförankring för aktuella motiv, med utdata på upp till 4 megapixlar.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
FLUX.2 [max] är Black Forest Labs medlem med högst kvalitet i bildgenererings- och redigeringsfamiljen FLUX.2. Tillverkaren positionerar den för krävande slutmaterial, stark följsamhet mot komplexa instruktioner och konsekvens mellan redigeringar. Den skapar en bild från en skriven beskrivning eller använder inskickade bilder som visuella referenser. Dess särskiljande familjefunktion är informationsförankrande sökning: en förfrågan kan använda aktuell information i stället för att enbart förlita sig på scenen som beskrivs i prompten.
Verklig information och den visuella instruktionen
Tillverkaren dokumenterar webbsökning för motiv som aktuellt väder, en nylig sporthändelse eller en historisk miljö. Ange den faktiska platsen, händelsen och tiden som är relevanta för bilden och beskriv sedan den konstnärliga behandlingen separat. Ett informationsförankrat koncept för ett väderkort kan ange staden, vilket väderförhållande som ska visualiseras, den exakta titeln och layouten. Sökningen informerar genereringen; en attraktiv illustration behöver fortfarande få sina synliga fakta kontrollerade mot relevant källa innan den används för faktabaserad kommunikation.
Denna sökfunktion hör till [max] i den publicerade FLUX.2-jämförelsen. De andra namngivna medlemmarna har egna roller: [pro] för produktion, [flex] för justerbar sampling och typografi och [klein] för kompakt interaktiv generering. Behåll valt modellnamn med resultatet så att en senare revidering inte tyst ersätter profilen som kan informationsförankras med en annan utgåva.
Referenser för krävande redigeringar
Den dokumenterade förfrågningsprofilen tar emot upp till åtta referensbilder; tillverkarens interaktiva gränssnitt tillåter separat tio. Ge varje referens en roll, till exempel karaktärsutseende, produktdesign, kläder, rum eller visuell stil. En komposition kan kombinera stolen från en bild med rummet från en annan och behålla stolens silhuett och material. För en befintlig scen anger du föremålet som ska ändras och detaljerna som ska bevaras, inklusive ljusriktning och omgivande geometri.
Familjens exempel omfattar bakgrundsändringar, utbyte av föremål, möbelkompositioner, textredigeringar och konsekventa karaktärer. En egen instruktion för slutmaterial kan placera en inskickad klocka på mörkt vikt tyg, behålla urtavlans och armbandets design och bara ändra belysningen till mjukt sidoljus. Ange vilken källa som ger varje egenskap och granska urtavla, märkningar, material och reflexer tillsammans i resultatet. En bevarandeinstruktion fastställer målet; den returnerade bilden är underlaget att jämföra med det.
Text, färger och prompttolkning
FLUX.2-guiden rekommenderar strukturen motiv–handling–stil–sammanhang, med viktiga element först. Den föreslår 10–30 ord för snabba koncept, 30–80 för vanliga projekt och längre beskrivningar för en komplex scen. Detta är skrivrekommendationer, inte hårda kontextgränser. Naturligt språk och JSON-strukturerade scenbeskrivningar är båda dokumenterade sätt att ordna motiv, placering, ljus och stil. En strukturerad prompt är en bildinstruktion, inte ett löfte om ett strukturerat textsvar.
För synliga bokstäver citerar du ordalydelsen, anger placeringen och beskriver den typografiska hierarkin. Koppla varje hexadecimal färg till ett specifikt föremål eller textelement; en färgkod utan namngivet mål är tvetydig. Tillverkarguiden använder positiva beskrivningar i stället för en mekanism för negativa prompter. För en produktscen med tomrum för en rubrik beskriver du tomrummet och dess avsedda placering direkt.
Den specifika förfrågningsspecifikationen för [max] tillämpar promptutökning som standard. Kontrollen disable_pup stänger av utökningen när en noggrant skriven instruktion ska användas som den är. Detta skiljer sig från ett påstående att varje ord återges oförändrat i slutbilden. Behåll den faktiska instruktionen och vald inställning med resultatet när du bedömer om ett oväntat visuellt beslut kom från instruktionen eller dess tolkning.
Utdata och användbart slutmaterial
Familjeguiden dokumenterar bilder på upp till 4 megapixlar, med uttryckliga dimensioner på minst 64×64 och multiplar av 16. Upp till 2 megapixlar rekommenderas för vanlig användning. Den specifika profilen [max] listar JPEG, PNG och WebP, med JPEG som standard, och ett valfritt slumpseed. Välj utdataformat efter avsedd placering innan kompositionen arrangeras. Modellens bildgenerering är separat från att ändra storlek på ett redan färdigt material.
Behåll bilden, referenserna, prompten, dimensionerna och modellidentiteten när du väljer slutversion. Tillverkarens FLUX.2-guide varnar för att den signerade resultatlänken är tillfällig och ger tio minuter för hämtning. Granska fin text, objektidentitet, layout, ljus och eventuella fakta från sökningen i avsedd visningsstorlek. Den användbara leveransen är den valda bilden med tillräckligt sammanhang för att fortsätta en exakt revidering, snarare än en scen vars viktiga detaljer aldrig jämförts med instruktionen.
Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux.2-max
black-forest-labs/flux.2-maxStart
FLUX.2 [max] är Black Forest Labs bildmodell för krävande slutmaterial och konsekventa redigeringar. Den dokumenterade profilen kombinerar visuella referenser, detaljerad scenkontroll och webbförankring för aktuella motiv, med utdata på upp till 4 megapixlar.
- Godkända indata
- Text · Bilder
- Resultat
- Bilder
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Bilder POST /v1/images/generations
- Indatatyper
text,image- Utdatatyper
image
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser black-forest-labs/flux.2-max | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standard— |
Fältoutput_format | Typstring | KravValfritt | Värden & gränser png, jpeg | Standard— |
Fältn | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 1 | Standard— |
Fältinput_references | Typarray | KravValfritt | Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 8 | Standard— |
Fältprovider | Typobject | KravValfritt | Värden & gränser | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parametermaterial_types | Avtaltext, image |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Avgift |
|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Debiteringsenhet— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| Konfigurationmegapixel i utdatabild | Prislista— | Prognostiserad mängd— | Debiteringsenhetper megapixel utdatabild | Avgift Utdata · megapixel i utdatabild · Uppskattning endast för jämförelse $0.14 per megapixel utdatabild |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.14 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Bilder
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
Ta emot och spara resultat
Ailoot Ultra · Bilder
Ladda ned varje returnerad bild eller spara dess Base64-innehåll
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Andra innehållsläsningar
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.
Behåll alla färdiga resultat
Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.
Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.
Om det ursprungliga svaret behöver kontrolleras
Behåll det returnerade värdet för X-Client-Request-ID för avstämning. Läs endast av resultat via de task_id/asset_id-värden som faktiskt returnerades eller via det mediebibliotek som tillhör dig. Bygg aldrig en uppgifts-URL från operations-ID:t och skicka aldrig skapandeförfrågan igen.
Svarsfält
| Fält | Typ |
|---|---|
Fältcreated | Typ |
Fältdata[].url | Typ |
Fältdata[].b64_json | Typ |
Fältusage | Typ |
Alias
Modellalias
Ailoot Ultra black-forest-labs/flux.2-max
Alias för metodsökvägar
/v1/images
Relaterade anropar-ID:n
FAQ · Black Forest Labs: FLUX.2 Max
- Vilka indata och resultat finns?
POST /v1/images/generations·black-forest-labs/flux.2-max:text,image→image- Vilka fält använder begäran?
POST /v1/images/generations·black-forest-labs/flux.2-max:model,prompt,aspect_ratio,output_format,n,input_references,provider- Vilka gränser gäller?
POST /v1/images/generations·black-forest-labs/flux.2-max:n.minimum:1;n.maximum:1