Source: https://ailoot.ai/models/pl/black-forest-labs-flux-3-image/ Canonical: https://ailoot.ai/models/pl/black-forest-labs-flux-3-image/ Language: pl # Black Forest Labs: FLUX.3 Image [Markdown](https://ailoot.ai/models/pl/black-forest-labs-flux-3-image/index.md) · [JSON](https://ailoot.ai/models/pl/black-forest-labs-flux-3-image/facts.json) ## [Black Forest Labs: FLUX.3 Image](https://ailoot.ai/models/pl/black-forest-labs-flux-3-image/) FLUX 3 Image tworzy i edytuje obrazy na podstawie opisu tekstowego i maksymalnie dziesięciu referencji. Dodaje ramki ograniczające określane w prompcie do sterowania kompozycją i zmianami miejscowymi, korzystanie ze źródeł internetowych i obrazowych oraz pięć klas rozdzielczości. - [**Ailoot Ultra · Obrazy** `POST /v1/images/generations` `black-forest-labs/flux-3-image`](https://ailoot.ai/models/pl/black-forest-labs-flux-3-image/#method-0) 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 3 Image to model generowania i edytowania obrazów firmy Black Forest Labs z wyraźnym sterowaniem kompozycją. Opis tekstowy może utworzyć nową scenę; dostarczone obrazy mogą określać obiekt, scenę do poprawienia lub kilka elementów do połączenia. Prostokąty ograniczające pozwalają wskazać w opisie miejsce każdego elementu i części istniejącego obrazu do zmiany. Wynikiem jest obraz, na którym należy sprawdzić zamówioną scenę, tekst i układ. #### Utwórz scenę lub podaj instrukcję edycji Dla nowego obrazu opisz obiekt, działanie lub pozę, otoczenie, światło i kadr. Umieść dokładny tekst do pokazania na obrazie w cudzysłowie i określ jego położenie. Autorski opis produktu może przedstawiać czerwony kubek turystyczny na jasnej kamiennej powierzchni, z dużym nagłówkiem nad nim i miękkim porannym światłem uwydatniającym uchwyt. Zdefiniuj relację między nagłówkiem, produktem i tłem, zamiast podawać niepowiązane określenia stylu. Przy edycji wskaż konkretny obiekt i zmianę: zmień kolor kubka, zastąp etykietę, przesuń postać lub zmień stylistykę sceny. Pojedyncza edycja nie wymaga ręcznie narysowanego prostokąta. Udokumentowany przepływ rozwija instrukcję przed generowaniem i może automatycznie zlokalizować nazwany element oraz dodać prostokąt. Zwrócony rozwinięty prompt zapisuje tę interpretację, co przydaje się, gdy instrukcja wybierze niewłaściwy obiekt lub wprowadzi niechciany szczegół. #### Połącz i przygotuj obrazy referencyjne Konkretny profil producenta przyjmuje od jednej do dziesięciu referencji, dostarczonych jako adresy URL obrazów lub zakodowane dane obrazowe. Każda musi mieć co najmniej 256×256 pikseli i nie więcej niż 16 megapikseli. Nazwij referencję według pozycji lub widocznej treści, a następnie wyjaśnij jej rolę: osoba z Image 1, kurtka z Image 2 i pokój z Image 3. Obraz referencyjny jest źródłem informacji wizualnych, a nie instrukcją kopiowania wszystkich niepowiązanych szczegółów, które zawiera. Ustawienie proporcji domyślnie ma wartość auto. W specyfikacji żądania pierwszeństwo mają proporcje zażądane w prompcie; w przeciwnym razie pierwszy obraz referencyjny wyznacza kadr, z kwadratowym wyjściem jako wariantem rezerwowym, gdy nie określa go ani referencja, ani żądany kształt. W kompozycji ustaw zamierzoną referencję sceny jako pierwszą lub wybierz proporcje wprost. Zachowaj obrazy źródłowe i ich kolejność przy wyniku, aby późniejsza poprawka korzystała z tego samego wizualnego punktu wyjścia. #### Rozmieść elementy za pomocą prostokątów ograniczających Prompt układu łączy opis z tablicą JSON wierszy elementów. Opis nazywa element za pomocą znacznika takiego jak \; wiersz zawiera id, bbox i desc. Współrzędne są liczbami całkowitymi od 0 do 1000 w kolejności \[top, left, bottom, right\], mierzonymi od lewego górnego narożnika. Przykładowo \[0, 0, 500, 500\] opisuje lewą górną ćwiartkę niezależnie od rozmiaru obrazu w pikselach. Używaj proporcji, dla których zaprojektowano układ, ponieważ siatka współrzędnych rozciąga się wraz z kadrem. Wiersz edycji używa zamiast tego from, src\_bbox i tgt\_bbox obok identyfikatora i opisu. ref\_image\_0 oznacza pierwszy dostarczony obraz. Zgodne prostokąty źródłowy i docelowy zakotwiczają element; różne prostokąty przesuwają go lub zmieniają rozmiar. Nowy wiersz bez źródła generuje swój opis w docelowej lokalizacji, umożliwiając dodawanie, zastępowanie lub zmianę koloru. Wiersz źródłowy bez celu usuwa element. Określ dodatki i usunięcia zarówno w instrukcji pisemnej, jak i w wierszach oraz zachowaj wiersze kotwiczące szczegóły, które mają pozostać na miejscu. Nadaj napisom własny prostokąt i zacytuj dokładne brzmienie w desc. Prostokąty kierują położeniem i skalą; nie są maskami przycinającymi, więc element może wychodzić poza ich granice. Producent podaje, że nowe obiekty w prostokątach około 40×25 pikseli często nie pojawiały się w jego przykładach. Zapewnij dostateczną widoczną przestrzeń i sprawdź edytowane granice. Piksele poza celem zwykle pozostają stabilne, ale cienie, odbicia i pobliskie oświetlenie nadal mogą się zmienić. #### Ugruntowanie w źródłach, klasy wyjścia i przydatne zapisy Udokumentowany profil domyślnie włącza ugruntowanie, pozwalając wyszukiwaniu internetowemu i obrazów wpływać na generowanie. Można je wyłączyć dla zadania, które ma używać wyłącznie dostarczonego opisu i referencji. Przy rzeczywistym temacie jasno określ miejsce, wydarzenie lub obiekt i oddziel fakty od opracowania artystycznego. Obrazy wspomagane wyszukiwaniem nadal wymagają porównania z miarodajnym materiałem, gdy etykieta, obiekt lub przedstawione wydarzenie muszą być dokładne. Pięć klas rozdzielczości to 768sq, 1k, 1.5k, 2k i 4k, z domyślnym 1k. Przedstawiają poziomy o równych polach liczonych w pikselach, dlatego dokładna szerokość i wysokość zależą od wybranych proporcji. Piętnaście stałych proporcji obejmuje zakres od 21:9 przez format kwadratowy i pionowy do 9:21. Profil tego modelu steruje rozmiarem przez proporcje i rozdzielczość; nie udostępnia pól seed, width ani height używanych w profilach żądań FLUX.2. Udokumentowany selektor wersji obecnie wskazuje zmienne wydanie, a nie potwierdza zgodności z datowanymi wagami dostawcy. Przepływ producenta zwraca obraz po przetwarzaniu asynchronicznym wraz z rozwiniętym promptem. Podpisany link do pobrania obrazu jest ważny przez godzinę. Zachowaj rzeczywisty obraz, końcowy prompt i referencje, zamiast polegać na linku tymczasowym. Przy ocenie materiału porównaj zamówiony tekst, rozmieszczenie obiektów, tożsamość referencji i zmieniony obszar w docelowym rozmiarze wyświetlania. Ukończone generowanie jest punktem wyjścia do sprawdzenia tych wymagań wizualnych. **Ailoot Ultra · Obrazy** `POST /v1/images/generations` `black-forest-labs/flux-3-image` [`black-forest-labs/flux-3-image`](https://ailoot.ai/models/pl/#m=black-forest-labs%2Fflux-3-image&route=Ultra&caller=black-forest-labs%2Fflux-3-image&fmt=images) Black Forest Labs /`black-forest-labs/flux-3-image` ### Start FLUX 3 Image tworzy i edytuje obrazy na podstawie opisu tekstowego i maksymalnie dziesięciu referencji. Dodaje ramki ograniczające określane w prompcie do sterowania kompozycją i zmianami miejscowymi, korzystanie ze źródeł internetowych i obrazowych oraz pięć klas rozdzielczości. 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-3-image | Domyślnie— | | Pole`prompt` | Typ`string` | WymaganieWymagane | Wartości i limity Minimalna długość: 1 | Domyślnie— | | Pole`resolution` | Typ`string` | WymaganieOpcjonalne | Wartości i limity 768, 1K, 1.5K, 2K, 4K | Domyślnie— | | Pole`aspect_ratio` | Typ`string` | WymaganieOpcjonalne | Wartości i limity 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto | 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: 10 | 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ść | Opłata | | --- | --- | --- | --- | | KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | 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 | | KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania **$0.082** 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 →](https://ailoot.ai/docs/pl/billing/reserve/) ### Przykładowe żądania #### Ailoot Ultra · Obrazy curl ```bash 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-3-image', '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"