Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] är Black Forest Labs bildmodell för produktion, med textstyrt skapande och referensstyrd redigering. Den dokumenterade profilen kombinerar fotorealistiska detaljer, text- och färgkontroll med en pixelbudget för referenser och utdata samt bilder på upp till 4 megapixlar.

Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux.2-pro

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 [pro] är Black Forest Labs produktionsinriktade modell för bildgenerering och redigering. Tillverkaren presenterar den som standardvalet för de flesta visuella uppgifter i FLUX.2: skapa en ny bild från text eller bearbeta en scen med visuella referenser. Familjens funktioner omfattar fotorealistiska material och ljus, läsbar text, exakta färginstruktioner och konsekventa motiv genom relaterade redigeringar. Den returnerade leveransen är en bild för en produktscen, redaktionell komposition, designidé eller visuell kommunikation.

Förbered en produktionsinstruktion

Börja med motivet, vad det gör eller hur det är arrangerat, stilen och miljön eller ljuset. Tillverkarens promptguide lägger större vikt vid tidiga ord och rekommenderar att det viktigaste motivet och handlingen placeras före dekorativa detaljer. Den föreslår 10–30 ord för snabba koncept och 30–80 för vanliga projekt, med längre beskrivningar för komplexa scener. Intervallen är vägledning för promptskrivning, inte en gräns för textkontext.

En egen kataloginstruktion kan visa en lampa i borstat stål på en varmgrå bordsskiva, i trekvartsvy där strömbrytaren och skärmen syns. Ange yta, ljus och synvinkel som gör produkten igenkännbar. För en infografik eller marknadsföringsbild fastställer du först den synliga ordalydelsen och hierarkin; citera den exakta titeln, ange dess placering och beskriv bokstävernas stil och storlek. Granska etiketter, mängder och produktdetaljer i den slutliga visningsstorleken.

Familjeguiden dokumenterar både naturligt språk och JSON-strukturerade prompter. En strukturerad sceninstruktion kan hålla motiv, bakgrund, ljus och komposition i separata fält så att ett krav tydligt kan ändras. Den stöder även beskrivningar med hexadecimala färger: koppla koden till det specifika föremål eller den text som ska färgsättas. Beskriv önskat utseende positivt, eftersom det dokumenterade promptflödet för FLUX.2 inte erbjuder negativa prompter.

Redigera med referenser och en gemensam pixelbudget

Den specifika förfrågningsprofilen för [pro] erbjuder åtta referensbildspositioner; tillverkarens interaktiva gränssnitt stöder separat tio. Ge varje bild en roll, till exempel motivutseende, kläder, produktdesign, rum eller stil. För en befintlig scen anger du vilket element som ska ändras och vilken komposition, omgivning och vilka visuella detaljer som ska bevaras. De publicerade exemplen omfattar möbelkompositioner, bakgrunds- eller väderändringar, ersättningsföremål och textbearbetningar.

Referenskapaciteten beror också på utdatastorleken. Tillverkarens guide för [pro] anger en total budget på 9 megapixlar för indata plus utdata. Exemplen tillåter åtta referenser vid utdata på 1 megapixel och sju vid 2 megapixlar, vilket minskar referenskapaciteten när det begärda resultatet växer. Planera källuppsättning och utdata tillsammans i stället för att behandla det maximala antalet platser som tillgängligt för varje utdatastorlek. Använd referenserna som fastställer nödvändig information och ange deras avsedda bidrag.

För en produktkomposition kan första bilden ge produkten och den andra ett rum, medan en tredje fastställer en materialfinish. Förklara hur de ska bli en sammanhängande scen. Om resultatet ändrar en form, märkning eller identitet som skulle bevaras riktar du uppföljningen mot det problemet i stället för att ersätta hela instruktionen. Det praktiska resultatet är den bearbetade bilden, vars referenstrohet och specifika ändring jämförs med dess indata.

Promptutökning och fasta profiler jämfört med förhandsversioner

Den specifika [pro]-specifikationen aktiverar promptutökning som standard. Kontrollen disable_pup stoppar utökningen när en noggrant skriven instruktion ska användas som den är. Behåll vald inställning när du jämför versioner, eftersom samma korta koncept och en utökad beskrivning är olika genereringsindata. Detta är en kontroll i tillverkarprofilen, inte en garanti för att varje begärd detalj återges rätt.

Dokumentationen skiljer den vanliga ändpunkten [pro] som en fast ögonblicksbild från [pro] Preview, där senare modellförbättringar införs. Deras förfrågnings- och svarsstruktur är samma, medan de underliggande vikterna skiljer sig. Behåll exakt vald profil med bilden och referenserna. Den separata Preview-etiketten ska inte tyst ersätta ett vanligt [pro]-val när en revidering beror på samma dokumenterade modellval.

Dimensioner, format och den valda bilden

Familjeguiden dokumenterar utdata på upp till 4 megapixlar, med uttryckliga dimensioner på minst 64×64 och multiplar av 16. Den rekommenderar upp till 2 megapixlar för de flesta användningsfall. Bredd och höjd fastställer avsett bildutsnitt; en kvadratisk produktbild, stående layout och bred redaktionell scen fördelar utrymmet olika. Den specifika förfrågan listar JPEG, PNG och WebP som utdata, med JPEG som standard, och ett valfritt seed.

Profilen [max] har en separat funktion för informationsförankrande sökning, medan [flex] exponerar samplingssteg och guidance och [klein] har en mindre profil med fyra referenser. Välj utgåva efter arbetet som krävs i stället för att föra in dessa kontroller i [pro]. För den valda bilden behåller du själva bilden, den slutliga prompten, referenserna, dimensionerna och modellbeteckningen. Tillverkarens signerade resultatlänkar för FLUX.2 löper ut efter tio minuter, så hämta bilden i stället för att förlita dig på dess tillfälliga plats. Granska motividentitet, färger, text, komposition och redigerade detaljer innan resultatet placeras i kundinriktat material.

Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux.2-pro

black-forest-labs/flux.2-pro

Black Forest Labs /black-forest-labs/flux.2-pro

Start

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ält`model`	Typ`string`	KravObligatoriskt	Värden & gränser black-forest-labs/flux.2-pro	Standard—
Fält`prompt`	Typ`string`	KravObligatoriskt	Värden & gränser Minsta längd: 1	Standard—
Fält`aspect_ratio`	Typ`string`	KravValfritt	Värden & gränser 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Standard—
Fält`output_format`	Typ`string`	KravValfritt	Värden & gränser png, jpeg	Standard—
Fält`n`	Typ`integer`	KravValfritt	Värden & gränser Minimum: 1 Maximum: 1	Standard—
Fält`input_references`	Typ`array`	KravValfritt	Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 8	Standard—
Fält`provider`	Typ`object`	KravValfritt	Värden & gränser	Standard—

Metodparametrar och livscykel

Parameter	Avtal
Parameter`content_type`	Avtalapplication/json
Parameter`required`	Avtalmodel, prompt
Parameter`material_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.06 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.06 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

curl

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

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}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Andra innehållsläsningar

Läs befintliga resurser som tillhör dig

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ält`created`	Typ
Fält`data[].url`	Typ
Fält`data[].b64_json`	Typ
Fält`usage`	Typ

Alias

Modellalias

Ailoot Ultra black-forest-labs/flux.2-pro

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

Vilka indata och resultat finns?: POST /v1/images/generations · black-forest-labs/flux.2-pro: text, image → image
Vilka fält använder begäran?: POST /v1/images/generations · black-forest-labs/flux.2-pro: model, prompt, aspect_ratio, output_format, n, input_references, provider
Vilka gränser gäller?: POST /v1/images/generations · black-forest-labs/flux.2-pro: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Pro