Black Forest Labs: FLUX.2 Flex

FLUX.2 [flex] specjalizuje się w typografii obrazowej i drobnych szczegółach wizualnych, oferując regulowane kroki próbkowania i guidance. Używaj tekstu i obrazów referencyjnych do opracowywania plakatów, układów produktowych lub precyzyjnych poprawek, równoważąc zgodność z instrukcjami i realizm.

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

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 [flex] to wersja Black Forest Labs do generowania i edycji obrazów, specjalizująca się w typografii, renderowaniu tekstu i zachowywaniu małych szczegółów. Używa tekstowych instrukcji sceny i obrazów referencyjnych do tworzenia obrazu. Jej wyróżniającym ustawieniem jest regulowane próbkowanie: udokumentowany profil udostępnia zarówno kroki wnioskowania, jak i guidance, pozwalając dopracować opis wizualny za pomocą ustawień i słów.

Liternictwo i drobne szczegóły

Zadanie typograficzne powinno zaczynać się od rzeczywistej treści. Zacytuj każdą linię, określ jej miejsce i odróżnij nagłówek, tekst uzupełniający oraz etykietę. Opisz styl liter, skalę i kolor w relacji do sceny. Własny opis plakatu może przedstawiać kobaltowoniebieski rower w jasnym studiu, z dużym tytułem nad ramą i mniejszą linią specyfikacji poniżej. Obraz musi jednocześnie jasno przedstawiać produkt i kolejność czytania.

W szczegółowej wizualizacji produktu wskaż części decydujące o przydatności wyniku: tarczę, etykietę elementu sterowania, szew, krawędź materiału lub oznaczenie opakowania. Dostarcz czytelną referencję i wyjaśnij, jaką cechę określa. Ogólnie podobna scena nadal może zmienić kluczowy znak lub element, dlatego porównaj wygenerowany szczegół w docelowym rozmiarze wyświetlania. Specjalizacja modelu jest powodem, by podawać dokładne wymagania, a nie gwarancją, że korekta tekstu lub kontrola wizualna stają się zbędne.

Kroki i guidance służą różnym celom

Konkretny profil producenta przyjmuje od jednego do pięćdziesięciu kroków wnioskowania, domyślnie pięćdziesiąt. Jego opis wiąże większą liczbę kroków z większą szczegółowością i realizmem. Guidance mieści się w zakresie od 1.5 do 10, domyślnie 5. Wyższa wartość guidance wzmacnia zgodność z promptem, ale może ograniczać realizm. Obraz z dokładnymi instrukcjami projektowymi i obraz dążący do naturalnego wyglądu fotograficznego mogą więc wymagać różnych wyborów w tym profilu.

Przy porównywaniu zmiany ustawienia zachowaj niezmienione sformułowanie, referencje i format wyjściowy. Patrz na cechę, która skłoniła do zmiany: kształty liter, rozmieszczenie przedmiotów lub teksturę materiału. Zmieniaj ustawienie z konkretnego powodu wizualnego, zamiast automatycznie uznawać większą liczbę za lepszą. Są to ustawienia próbkowania producenta; destylowany czterokrokowy profil [klein] i standardowe ustawienia [pro] lub [max] stanowią inne wybory modelu.

Rozwijanie promptu jest domyślnie włączone w specyfikacji [flex] i można je wyłączyć własnym elementem sterowania prompt_upsampling. Pozwala to w razie potrzeby zachować szczegółowy opis w dostarczonej postaci. Wspólny przewodnik producenta zaleca umieszczanie głównego tematu i ważnej akcji przed drugorzędnymi dekoracjami oraz opisuje prompty o strukturze JSON obok opisów w języku naturalnym. Użyj struktury, która najłatwiej pozwala określić wymagane zależności.

Poprawki oparte na referencjach

Konkretny profil żądania zawiera osiem pozycji na obrazy referencyjne. Interaktywny proces producenta osobno dopuszcza maksymalnie dziesięć obrazów; te liczby opisują różne interfejsy. Określ, czy obraz dostarcza scenę do edycji, produkt, postać, ubranie czy styl. Przy poprawce wskaż przedmiot i zmianę, a następnie nazwij otaczającą kompozycję, materiały lub światło, które mają pozostać.

Własne zadanie opakowaniowe może używać kartonu z pierwszego obrazu i wykończenia z drugiego, zastępować przednią etykietę zatwierdzoną treścią i zachowywać proporcje kartonu. Kompozycja grupowa może przypisywać odrębną referencję każdemu obiektowi lub każdej postaci i utrzymywać te przypisania spójnie. Przykłady rodziny obejmują zmiany przedmiotów i tła, łączenie obrazów, edycje tekstu i przekształcenia stylu. Poproś o jedną powiązaną poprawkę z jasnym celem, a następnie porównaj zarówno edytowany obszar, jak i części, które miały pozostać stabilne.

Rozmiar, kolor i zwrócony obraz

Przewodnik FLUX.2 dokumentuje minimum 64×64 piksele, wymiary będące wielokrotnościami 16 i wynik do 4 megapikseli, zalecając do 2 megapikseli do zwykłego użytku. Konkretna specyfikacja [flex] wymienia wynik JPEG, PNG i WebP, domyślnie JPEG. Udostępnia także opcjonalne ziarno losowości. Przy porównywaniu wersji zachowaj rzeczywisty model, ziarno i ustawienia próbkowania z referencjami źródłowymi; sama nazwana rodzina nie określa pełnej konfiguracji generowania.

W pracy wrażliwej na kolor powiąż każdy kod szesnastkowy z nazwanym przedmiotem lub elementem tekstowym. Dla kompozycji określ zamierzone proporcje przez wymiary obrazu i pozostaw dość miejsca na czytelne napisy. Wspólny przewodnik nie ma mechanizmu promptu negatywnego, dlatego pozytywnie opisuj oczekiwany wygląd: ostry obraz, czyste tło lub wyraźnie pusty obszar na tekst. Jego wielojęzyczne przykłady wspierają pisanie opisu właściwego kulturowo w odpowiednim języku, bez ustanawiania gwarantowanej liczby języków.

Proces FLUX.2 producenta zwraca obraz po przetworzeniu i używa czasowych podpisanych odnośników z dziesięciominutowym oknem pobrania. Zachowaj sam obraz razem z opisem. Sprawdź typografię, drobne szczegóły, tożsamość referencji i sposób przedstawienia przed umieszczeniem materiału w układzie. Końcowym rezultatem może być wybrany plakat, obraz produktu lub edytowana kompozycja z dokładnymi ustawieniami zachowanymi do kolejnej poprawki.

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

black-forest-labs/flux.2-flex

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

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-flex	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 wejściowego	Tabela stawek—	Przewidywana ilość—	Jednostka rozliczeniowaza megapiksel obrazu wejściowego	Opłata Wejście · megapiksel obrazu wejściowego · Szacunek tylko do porównania $0.12 za megapiksel obrazu wejściowego
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.12 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.12 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-flex', '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-flex

Aliasy ścieżek metod

/v1/images

Powiązane ID modeli

black-forest-labs/flux.2-flex

FAQ · Black Forest Labs: FLUX.2 Flex

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

Black Forest Labs: FLUX.2 Flex