Black Forest Labs: FLUX.2 Pro
FLUX.2 [pro] er Black Forest Labs' billedmodel til produktion, som bruges til tekstbaseret skabelse og referencestyret redigering. Den dokumenterede profil kombinerer fotorealistiske detaljer, tekst- og farvekontrol med et fælles pixelbudget for referencer og output samt billeder 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 [pro] er Black Forest Labs' produktionsorienterede model til billedgenerering og redigering. Producenten præsenterer den som standardvalget til de fleste visuelle FLUX.2-opgaver: skab et nyt billede fra tekst, eller revidér en scene ved hjælp af visuelle referencer. Familiens funktioner omfatter fotorealistiske materialer og belysning, læsbar tekst, instruktioner om præcise farver og konsekvente motiver på tværs af relaterede redigeringer. Det returnerede resultat er et billede til brug i en produktscene, redaktionel komposition, designidé eller visuel kommunikation.
Forbered en produktionsbeskrivelse
Begynd med motivet, hvad det gør, eller hvordan det er opstillet, stilen og omgivelserne eller lyset. Producentens promptvejledning lægger større vægt på de første ord og anbefaler at placere det væsentlige motiv og handlingen før dekorative detaljer. Den foreslår 10–30 ord til hurtige koncepter og 30–80 til almindelige projekter med længere beskrivelser til komplekse scener. Disse intervaller er vejledning i at skrive prompts, ikke en grænse for tekstkonteksten.
En original katalogbeskrivelse kan vise en lampe i børstet stål på en varmgrå bordplade set skråt forfra, så kontakt og skærm er synlige. Angiv den overflade, belysning og synsvinkel, der gør produktet genkendeligt. Ved infografik eller et markedsføringsbillede skal du først fastlægge den synlige ordlyd og hierarkiet; citér den præcise titel, angiv dens placering, og beskriv bogstavernes stil og størrelse. Undersøg etiketter, mængdeangivelser og produktdetaljer i den endelige visningsstørrelse.
Familiens vejledning dokumenterer både prompts i naturligt sprog og prompts struktureret som JSON. En struktureret scenebeskrivelse kan holde motiv, baggrund, lys og komposition i separate felter, så ét krav kan ændres tydeligt. Den understøtter også beskrivelser med hex-farver: knyt koden til den specifikke genstand eller tekst, der skal farves. Beskriv det ønskede udseende positivt, da det dokumenterede FLUX.2-promptforløb ikke tilbyder negative prompts.
Redigér med referencer og et fælles pixelbudget
Den konkrete [pro]-anmodningsprofil tilbyder otte positioner til referencebilleder; producentens interaktive grænseflade understøtter separat ti. Tildel hvert billede en rolle, såsom motivets udseende, påklædning, produktdesign, rum eller stil. Ved en eksisterende scene skal du angive det element, der skal ændres, og hvilken komposition, hvilke omgivelser og hvilke visuelle detaljer der skal bevares. De offentliggjorte eksempler omfatter møbelkompositioner, baggrunds- eller vejrændringer, udskiftning af genstande og tekstrevisioner.
Referencekapaciteten afhænger også af outputstørrelsen. Producentens [pro]-vejledning angiver et samlet budget på 9 megapixels til input plus output. Eksemplerne tillader otte referencer ved output på 1 megapixel og syv ved output på 2 megapixels, så referencekapaciteten falder, når det ønskede resultat bliver større. Planlæg kildesættet og output samlet i stedet for at behandle det maksimale antal pladser som tilgængeligt ved enhver outputstørrelse. Brug de referencer, der fastlægger nødvendige oplysninger, og angiv deres tilsigtede bidrag.
I en produktkomposition kan det første billede levere produktet og det andet et rum, mens et tredje fastlægger en materialeoverflade. Forklar, hvordan de skal blive til én sammenhængende scene. Hvis resultatet ændrer en form, mærkning eller identitet, der skulle bevares, skal den efterfølgende rettelse målrettes dette problem i stedet for at erstatte hele beskrivelsen. Det praktiske resultat er det reviderede billede, hvor referencetrofasthed og den specifikke ændring sammenlignes med inputtene.
Promptudvidelse og faste profiler kontra Preview
Den konkrete [pro]-specifikation aktiverer promptudvidelse som standard. Kontrollen disable_pup stopper denne udvidelse, når en omhyggeligt skrevet instruktion skal bruges som medsendt. Bevar den valgte indstilling, når du sammenligner versioner, fordi samme korte koncept og en udvidet beskrivelse er forskellige genereringsinput. Dette er en kontrol i producentens profil, ikke en garanti for, at hver ønsket detalje fremstår korrekt.
Dokumentationen skelner mellem det almindelige [pro]-endpoint som et fast øjebliksbillede og [pro] Preview, hvor senere modelforbedringer indføres. Deres anmodnings- og svarstrukturer er ens, mens de underliggende vægte er forskellige. Gem den præcist valgte profil sammen med billedet og referencerne. Den separate Preview-betegnelse bør ikke ubemærket erstatte et almindeligt [pro]-valg, når en revision afhænger af samme dokumenterede modelvalg.
Dimensioner, formater og det valgte materiale
Familiens vejledning dokumenterer output på op til 4 megapixels med udtrykkelige dimensioner på mindst 64×64 og i multipla af 16. Den anbefaler op til 2 megapixels til de fleste anvendelser. Bredde og højde fastlægger den ønskede indramning; et kvadratisk produktbillede, et stående layout og en bred redaktionel scene fordeler pladsen forskelligt. Den konkrete anmodning angiver JPEG-, PNG- og WebP-output med JPEG som standard samt et valgfrit seed.
[max]-profilen har en separat søgefunktion til kildeforankring, mens [flex] giver adgang til samplingtrin og guidance, og [klein] har en mindre profil med fire referencer. Vælg udgave efter det nødvendige arbejde frem for at overføre disse kontroller til [pro]. Gem selve billedet, den endelige prompt, referencer, dimensioner og modelbetegnelse for det valgte materiale. Producentens signerede FLUX.2-resultatlinks udløber efter ti minutter, så hent billedet i stedet for at stole på dets midlertidige placering. Gennemgå motividentitet, farver, tekst, komposition og redigerede detaljer, før resultatet placeres i kundevendt materiale.
Ailoot Ultra · Billeder POST /v1/images/generations black-forest-labs/flux.2-pro
black-forest-labs/flux.2-proStart
FLUX.2 [pro] er Black Forest Labs' billedmodel til produktion, som bruges til tekstbaseret skabelse og referencestyret redigering. Den dokumenterede profil kombinerer fotorealistiske detaljer, tekst- og farvekontrol med et fælles pixelbudget for referencer og output samt billeder 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-pro | 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.06 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.06 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-pro', '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-pro
Aliaser for metodestier
/v1/images
Relaterede kalder-ID’er
FAQ · Black Forest Labs: FLUX.2 Pro
- Hvilke input og resultater er tilgængelige?
POST /v1/images/generations·black-forest-labs/flux.2-pro:text,image→image- Hvilke felter bruger anmodningen?
POST /v1/images/generations·black-forest-labs/flux.2-pro:model,prompt,aspect_ratio,output_format,n,input_references,provider- Hvilke grænser gælder?
POST /v1/images/generations·black-forest-labs/flux.2-pro:n.minimum:1;n.maximum:1