Black Forest Labs: FLUX.2 Max
FLUX.2 [max] er Black Forest Labs' billedmodel til krævende færdige visuelle materialer og konsistente redigeringer. Den dokumenterede profil kombinerer visuelle referencer, detaljeret scenekontrol og webbaseret kildeforankring til aktuelle motiver med output på op til 4 megapixels.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
FLUX.2 [max] er Black Forest Labs' medlem med højeste kvalitet i FLUX.2-familien til billedgenerering og redigering. Producenten positionerer den til krævende færdige visuelle materialer, tæt efterlevelse af en kompleks beskrivelse og konsistens på tværs af redigeringer. Den skaber et billede fra en skrevet beskrivelse eller bruger medsendte billeder som visuelle referencer. Dens særlige funktion i familien er søgning til kildeforankring: en anmodning kan trække på aktuelle oplysninger frem for kun at bygge på scenen beskrevet i prompten.
Oplysninger fra virkeligheden og den visuelle beskrivelse
Producenten dokumenterer websøgning til emner som aktuelt vejr, en nylig sportsbegivenhed eller et historisk miljø. Angiv det faktiske sted, den begivenhed og det tidspunkt, der er relevante for billedet, og beskriv derefter den kunstneriske behandling separat. Et kildeforankret koncept til et vejrkort kan angive byen, hvilken vejrtilstand der skal visualiseres, den præcise titel og layoutet. Søgning bidrager til genereringen; en flot illustration kræver stadig, at dens synlige fakta kontrolleres mod den relevante kilde, før den bruges som faktuel kommunikation.
Denne søgefunktion tilhører [max] i den offentliggjorte FLUX.2-sammenligning. De andre navngivne medlemmer har deres egne roller: [pro] til produktion, [flex] til justerbar sampling og typografi og [klein] til kompakt interaktiv generering. Gem det valgte modelnavn sammen med resultatet, så en senere revision ikke ubemærket erstatter profilen med kildeforankring med en anden udgave.
Referencer til krævende redigeringer
Den dokumenterede anmodningsprofil tager op til otte referencebilleder; producentens interaktive grænseflade tillader separat ti. Tildel hver reference en rolle, såsom en figurs udseende, produktdesign, påklædning, rum eller visuel stil. En komposition kan kombinere stolen fra ét billede med rummet fra et andet og samtidig bevare stolens silhuet og materiale. I en eksisterende scene skal du angive genstanden, der skal ændres, og de detaljer, der skal bevares, herunder lysretning og den omgivende geometri.
Familiens eksempler omfatter baggrundsændringer, udskiftning af genstande, møbelkompositioner, tekstredigeringer og konsistente figurer. En original beskrivelse af et færdigt visuelt materiale kan placere et medsendt ur på mørkt, foldet stof, bevare urskivens og remmens design og kun ændre belysningen til et blødt sidelys. Angiv, hvilken kilde der leverer hvert træk, og gennemgå den resulterende urskive, mærkning, materiale og refleksioner samlet. En instruktion om bevarelse fastlægger målet; det returnerede billede er grundlaget for at kontrollere det.
Tekst, farver og promptfortolkning
FLUX.2-vejledningen anbefaler strukturen motiv–handling–stil–kontekst med vigtige elementer først. Den foreslår 10–30 ord til hurtige koncepter, 30–80 til almindelige projekter og længere beskrivelser til en kompleks scene. Dette er skriveanbefalinger, ikke faste kontekstgrænser. Både naturligt sprog og JSON-strukturerede scenebeskrivelser er dokumenterede måder at organisere motiver, placering, lys og stil på. En struktureret prompt er en billedbeskrivelse frem for et løfte om et struktureret tekstsvar.
Ved synlig tekst skal du citere ordlyden, angive dens placering og beskrive det typografiske hierarki. Knyt hver hexadecimal farve til en bestemt genstand eller et tekstelement; en farvekode uden et navngivet mål er tvetydig. Producentens vejledning bruger positive beskrivelser i stedet for en mekanisme til negative prompts. Ved en produktscene med tom plads til en overskrift skal du beskrive dette tomme område og dets ønskede placering direkte.
Den konkrete [max]-anmodningsspecifikation bruger promptudvidelse som standard. Kontrollen disable_pup slår denne udvidelse fra, når en omhyggeligt skrevet beskrivelse skal bruges som medsendt. Dette er adskilt fra en påstand om, at hvert ord fremstår uændret i det endelige billede. Gem den faktiske beskrivelse og den valgte indstilling sammen med resultatet, når du vurderer, om en uventet visuel beslutning kom fra instruktionen eller dens fortolkning.
Output og et nyttigt færdigt visuelt materiale
Familiens vejledning dokumenterer billeder på op til 4 megapixels med udtrykkelige dimensioner på mindst 64×64 og i multipla af 16. Op til 2 megapixels er anbefalingen til almindelig brug. Den konkrete [max]-profil angiver JPEG, PNG og WebP med JPEG som standard samt et valgfrit tilfældigt seed. Vælg outputformat efter den ønskede placering, før du arrangerer kompositionen. Modellens billedgenerering er adskilt fra størrelsesændring af et allerede færdigt materiale.
Gem billedet, referencerne, prompten, dimensionerne og modelidentiteten, når du vælger den endelige version. Producentens FLUX.2-vejledning advarer om, at det signerede resultatlink er midlertidigt med et vindue på ti minutter til at hente billedet. Undersøg lille tekst, genstandsidentitet, layout, lys og eventuelle fakta fra søgning i den ønskede visningsstørrelse. Det nyttige resultat er det valgte billede med tilstrækkelig kontekst til at fortsætte en præcis revision frem for en scene, hvis vigtige detaljer aldrig er blevet sammenlignet med beskrivelsen.
Ailoot Ultra · Billeder POST /v1/images/generations black-forest-labs/flux.2-max
black-forest-labs/flux.2-maxStart
FLUX.2 [max] er Black Forest Labs' billedmodel til krævende færdige visuelle materialer og konsistente redigeringer. Den dokumenterede profil kombinerer visuelle referencer, detaljeret scenekontrol og webbaseret kildeforankring til aktuelle motiver med output på op til 4 megapixels.
- Accepterede input
- Tekst · Billeder
- Resultater
- Billeder
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Billeder POST /v1/images/generations
- Inputtyper
text,image- Outputtyper
image
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser black-forest-labs/flux.2-max | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standard— |
Feltoutput_format | Typestring | KravValgfrit | Værdier og grænser png, jpeg | Standard— |
Feltn | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 1 | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 0 Maksimalt antal elementer: 8 | Standard— |
Feltprovider | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parametermaterial_types | Kontrakttext, image |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregningsenhed | Beløb |
|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| Konfigurationmegapixel i outputbilledet | Takstplan— | Forventet mængde— | Afregningsenhedpr. megapixel i outputbilledet | Beløb Output · megapixel i outputbilledet · Estimat kun til sammenligning $0.14 pr. megapixel i outputbilledet |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.14 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Billeder
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
Hent og gem resultater
Ailoot Ultra · Billeder
Hent hvert returneret billede, eller gem dets Base64-indhold
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Læsning af andet indhold
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.
Behold alle færdige resultater
Gem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Gem det returnerede X-Client-Request-ID til afstemning. Brug kun faktisk returnerede task_id/asset_id-værdier eller dit eget mediebibliotek til læseanmodninger; opbyg aldrig en opgave-URL ud fra operations-ID’et, og send aldrig oprettelsesanmodningen igen.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modelaliaser
Ailoot Ultra black-forest-labs/flux.2-max
Aliaser for metodestier
/v1/images
Relaterede kalder-ID’er
FAQ · Black Forest Labs: FLUX.2 Max
- Hvilke input og resultater er tilgængelige?
POST /v1/images/generations·black-forest-labs/flux.2-max:text,image→image- Hvilke felter bruger anmodningen?
POST /v1/images/generations·black-forest-labs/flux.2-max:model,prompt,aspect_ratio,output_format,n,input_references,provider- Hvilke grænser gælder?
POST /v1/images/generations·black-forest-labs/flux.2-max:n.minimum:1;n.maximum:1