Black Forest Labs: FLUX.2 Max

FLUX.2 [max] to model obrazowy Black Forest Labs do wymagających materiałów docelowych i spójnych edycji. Jego udokumentowany profil łączy referencje wizualne, szczegółowe sterowanie sceną i osadzanie aktualnych tematów w informacjach z sieci, oferując wynik do 4 megapikseli.

Ailoot Ultra · Obrazy POST /v1/images/generations black-forest-labs/flux.2-max

O modelu

Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.

FLUX.2 [max] to model o najwyższej jakości w rodzinie generowania i edycji obrazów FLUX.2 od Black Forest Labs. Producent pozycjonuje go do wymagających materiałów docelowych, ścisłego przestrzegania złożonego opisu i spójności między edycjami. Tworzy obraz z opisu tekstowego lub wykorzystuje dostarczone obrazy jako referencje wizualne. Jego wyróżniającą funkcją w rodzinie jest wyszukiwanie informacji ugruntowujących: żądanie może korzystać z aktualnych danych, zamiast polegać wyłącznie na scenie opisanej w prompcie.

Informacje o rzeczywistym świecie i opis wizualny

Producent dokumentuje wyszukiwanie w sieci dla tematów takich jak bieżąca pogoda, niedawne wydarzenie sportowe lub historyczne otoczenie. Wskaż rzeczywistą lokalizację, wydarzenie i czas istotne dla obrazu, a sposób artystycznego przedstawienia opisz osobno. Koncepcja karty pogodowej opartej na źródłach może określać miasto, warunek do zwizualizowania, dokładny tytuł i układ. Wyszukiwanie dostarcza informacji do generowania; atrakcyjna ilustracja nadal wymaga sprawdzenia widocznych faktów w odpowiednim źródle, zanim stanie się komunikatem informacyjnym.

Ta funkcja wyszukiwania należy do [max] w opublikowanym porównaniu FLUX.2. Pozostałe nazwane modele mają własne role: [pro] do produkcji, [flex] do regulowanego próbkowania i typografii, a [klein] do kompaktowego generowania interaktywnego. Zachowaj nazwę wybranego modelu z wynikiem, aby późniejsza poprawka nie zastąpiła po cichu profilu korzystającego z aktualnych źródeł inną wersją.

Referencje do wymagających edycji

Udokumentowany profil żądania przyjmuje maksymalnie osiem obrazów referencyjnych; interaktywny interfejs producenta osobno dopuszcza dziesięć. Przypisz rolę każdej referencji, na przykład wygląd postaci, projekt produktu, ubranie, pomieszczenie lub styl wizualny. Kompozycja może łączyć krzesło z jednego obrazu z pokojem z drugiego, zachowując sylwetkę i materiał krzesła. W istniejącej scenie wskaż przedmiot do zmiany i szczegóły do zachowania, w tym kierunek światła i geometrię otoczenia.

Przykłady rodziny obejmują zmiany tła, podmiany przedmiotów, kompozycje mebli, edycje tekstu i spójne postacie. Własny opis materiału docelowego może umieszczać dostarczony zegarek na ciemnej, złożonej tkaninie, zachowywać projekt tarczy i paska oraz zmieniać tylko oświetlenie na miękkie światło boczne. Nazwij źródło każdej cechy i oceń razem wynikową tarczę, oznaczenia, materiał i odbicia. Instrukcja zachowania określa cel; zwrócony obraz jest dowodem do porównania z nim.

Tekst, kolory i interpretacja promptu

Przewodnik FLUX.2 zaleca strukturę temat–akcja–styl–kontekst, z ważnymi elementami na początku. Sugeruje 10–30 słów dla szybkich koncepcji, 30–80 dla zwykłych projektów i dłuższe opisy dla złożonej sceny. Są to zalecenia pisarskie, a nie twarde limity kontekstu. Język naturalny i opisy scen o strukturze JSON to udokumentowane sposoby porządkowania tematów, położenia, światła i stylu. Ustrukturyzowany prompt jest opisem obrazu, a nie obietnicą ustrukturyzowanej odpowiedzi tekstowej.

Dla widocznych napisów zacytuj słowa, określ położenie i opisz hierarchię typograficzną. Powiąż każdy kolor szesnastkowy z konkretnym przedmiotem lub elementem tekstowym; kod koloru bez nazwanego celu jest niejednoznaczny. Przewodnik producenta używa opisów pozytywnych zamiast mechanizmu promptów negatywnych. W scenie produktu z pustą przestrzenią na nagłówek opisz bezpośrednio ten obszar i jego zamierzone położenie.

Konkretna specyfikacja żądania [max] domyślnie stosuje rozwijanie promptu. Element sterowania disable_pup wyłącza to rozwijanie, gdy starannie napisany opis ma zostać użyty w dostarczonej postaci. To odrębna kwestia od twierdzenia, że każde słowo pojawi się niezmienione w końcowym obrazie. Zachowaj rzeczywisty opis i wybrane ustawienie z wynikiem, gdy oceniasz, czy nieoczekiwana decyzja wizualna pochodziła z instrukcji czy jej interpretacji.

Wynik i użyteczny materiał docelowy

Przewodnik rodziny dokumentuje obrazy do 4 megapikseli, z podanymi wymiarami co najmniej 64×64 i będącymi wielokrotnościami 16. Do zwykłego użytku zaleca do 2 megapikseli. Konkretny profil [max] wymienia JPEG, PNG i WebP, domyślnie JPEG, oraz opcjonalne ziarno losowości. Wybierz format wyjściowy do zamierzonego miejsca użycia przed ułożeniem kompozycji. Generowanie obrazu przez model jest odrębne od zmiany rozmiaru już gotowego materiału.

Przy wyborze wersji docelowej zachowaj obraz, referencje, prompt, wymiary i tożsamość modelu. Przewodnik FLUX.2 producenta ostrzega, że podpisany odnośnik do wyniku jest czasowy i daje dziesięć minut na pobranie. Sprawdź drobny tekst, tożsamość przedmiotów, układ, światło i wszystkie fakty zaczerpnięte z wyszukiwania w docelowym rozmiarze wyświetlania. Użytecznym materiałem jest wybrana grafika z wystarczającym kontekstem do kontynuowania dokładnej poprawki, a nie scena, której ważnych szczegółów nigdy nie porównano z opisem.

Ailoot Ultra · Obrazy POST /v1/images/generations black-forest-labs/flux.2-max

black-forest-labs/flux.2-max

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

Start

Akceptowane dane wejściowe: Tekst · Obrazy
Wyniki: Obrazy

Dostępne w Ailoot · dane wejściowe i metody

Ailoot Ultra · Obrazy POST /v1/images/generations

Wejście: text, image
Wyjście: image

Pole	Typ	Wymaganie	Wartości i limity	Domyślnie
Pole`model`	Typ`string`	WymaganieWymagane	Wartości i limity black-forest-labs/flux.2-max	Domyślnie—
Pole`prompt`	Typ`string`	WymaganieWymagane	Wartości i limity Minimalna długość: 1	Domyślnie—
Pole`aspect_ratio`	Typ`string`	WymaganieOpcjonalne	Wartości i limity 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Domyślnie—
Pole`output_format`	Typ`string`	WymaganieOpcjonalne	Wartości i limity png, jpeg	Domyślnie—
Pole`n`	Typ`integer`	WymaganieOpcjonalne	Wartości i limity Minimum: 1 Maksimum: 1	Domyślnie—
Pole`input_references`	Typ`array`	WymaganieOpcjonalne	Wartości i limity Minimalna liczba elementów: 0 Maksymalna liczba elementów: 8	Domyślnie—
Pole`provider`	Typ`object`	WymaganieOpcjonalne	Wartości i limity	Domyślnie—

Parametry i cykl życia metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Cykl życia: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cennik

Jak obliczana jest ostateczna opłata

Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.

Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.

Tryb szybki: Nie określono Gdy wybrany jest tryb szybki
Tryb flex: Nie określono Gdy wybrany jest tryb flex
Maksymalna intensywność rozumowania: Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)

Szacunkowe stawki do porównania

Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

Konfiguracja	Tabela stawek	Przewidywana ilość	Jednostka rozliczeniowa	Opłata
KonfiguracjaBazowe stawki za tokeny	Tabela stawekStawka podstawowa	Przewidywana ilość—	Jednostka rozliczeniowa—	Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów
Konfiguracjamegapiksel obrazu wyjściowego	Tabela stawek—	Przewidywana ilość—	Jednostka rozliczeniowaza megapiksel obrazu wyjściowego	Opłata Wyjście · megapiksel obrazu wyjściowego · Szacunek tylko do porównania $0.14 za megapiksel obrazu wyjściowego
KonfiguracjaSzacowany koszt generowania	Tabela stawek—	Przewidywana ilośćszacunek dla jednego generowania	Jednostka rozliczeniowa—	Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.14 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.

Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →

Przykładowe żądania

Ailoot Ultra · Obrazy

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-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

Odbieranie i zapisywanie wyników

Ailoot Ultra · Obrazy

Pobierz każdy zwrócony obraz lub zapisz jego zawartość Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Inne odczyty treści

Odczytaj istniejące zasoby należące do Ciebie

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.

Zachowaj wszystkie ukończone wyniki

Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.

Zachowaj pełną odpowiedź i nagłówki, wszystkie rzeczywiście uzyskane wyniki, pierwotnie zwrócone identyfikatory oraz wszystkie pola zużycia. Odzyskaj pierwotną operację bez ponownego wysyłania żądania utworzenia.

Jeśli trzeba sprawdzić pierwotną odpowiedź

Zachowaj zwrócony X-Client-Request-ID do uzgodnienia danych. Odczytuj wyłącznie rzeczywiście zwrócone wartości task_id/asset_id lub własną bibliotekę multimediów; nigdy nie buduj adresu URL zadania na podstawie identyfikatora operacji i nigdy nie wysyłaj ponownie żądania utworzenia.

Pola odpowiedzi

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelu

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

Aliasy ścieżek metod

/v1/images

Powiązane ID modeli

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

Jakie dane wejściowe i wyniki są dostępne?: POST /v1/images/generations · black-forest-labs/flux.2-max: text, image → image
Jakich pól używa żądanie?: POST /v1/images/generations · black-forest-labs/flux.2-max: model, prompt, aspect_ratio, output_format, n, input_references, provider
Jakie limity obowiązują?: POST /v1/images/generations · black-forest-labs/flux.2-max: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Max