{ "aboutHtml": "

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 <cup_1>; 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.

", "aboutText": "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.\n\n### Utwórz scenę lub podaj instrukcję edycji\n\nDla 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.\n\nPrzy 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ół.\n\n### Połącz i przygotuj obrazy referencyjne\n\nKonkretny 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.\n\nUstawienie 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.\n\n### Rozmieść elementy za pomocą prostokątów ograniczających\n\nPrompt 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.\n\nWiersz 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.\n\nNadaj 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ć.\n\n### Ugruntowanie w źródłach, klasy wyjścia i przydatne zapisy\n\nUdokumentowany 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.\n\nPięć 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.\n\nPrzepł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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "bd8073a157b447a7cfd46cc46f55a47c85a50ce485d72a26e8fc5b80f5314920", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "
•

Black Forest Labs: FLUX.3 Image

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
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 <cup_1>; 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.

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

Ailoot Ultra · Obrazy POST /v1/images/generations
Wejście
text, image
Wyjście
image
PoleTypWymaganieWartości i limityDomyślnie
PolemodelTypstringWymaganieWymaganeWartości i limity
black-forest-labs/flux-3-image
Domyślnie—
PolepromptTypstringWymaganieWymaganeWartości i limity
Minimalna długość: 1
Domyślnie—
PoleresolutionTypstringWymaganieOpcjonalneWartości i limity
768, 1K, 1.5K, 2K, 4K
Domyślnie—
Poleaspect_ratioTypstringWymaganieOpcjonalneWartoś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—
PolenTypintegerWymaganieOpcjonalneWartości i limity
Minimum: 1
Maksimum: 1
Domyślnie—
Poleinput_referencesTyparrayWymaganieOpcjonalneWartości i limity
Minimalna liczba elementów: 0
Maksymalna liczba elementów: 10
Domyślnie—
PoleproviderTypobjectWymaganieOpcjonalneWartości i limityDomyślnie—
Parametry i cykl życia metody
ParametrKontrakt
Parametrcontent_typeKontraktapplication/json
ParametrrequiredKontraktmodel, prompt
Parametrmaterial_typesKontrakttext, 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.

KonfiguracjaTabela stawekPrzewidywana ilośćOpłata
KonfiguracjaBazowe stawki za tokenyTabela stawekStawka podstawowaPrzewidywana 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 generowaniaTabela stawek—Przewidywana ilośćszacunek dla jednego generowaniaOpł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 →

Przykładowe żądania

Ailoot Ultra · Obrazy

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

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
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\n
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
PoleTyp
PolecreatedTyp
Poledata[].urlTyp
Poledata[].b64_jsonTyp
PoleusageTyp

Aliasy

Aliasy modelu

Ailoot Ultra black-forest-labs/flux-3-image

Aliasy ścieżek metod

/v1/images

Powiązane ID modeli

black-forest-labs/flux-3-image

", "method_identity": { "effective_request_model_id": "black-forest-labs/flux-3-image", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "black-forest-labs/flux-3-image", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|black-forest-labs%2Fflux-3-image", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "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." }, "outputs": { "all_results": "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.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "black-forest-labs/flux-3-image" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "enum_known": true, "name": "resolution", "required": false, "type": "string" }, { "enum": [ "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" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 1, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 10, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "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" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 10, "minItems": 0, "type": "array" }, "model": { "enum": [ "black-forest-labs/flux-3-image" ], "type": "string" }, "n": { "maximum": 1, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "resolution": { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "black-forest-labs/flux-3-image", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Szacowany koszt generowania", "units": [ { "amount": "0.082", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.082", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n 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\"; 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.\n\nWiersz 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.\n\nNadaj 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ć.\n\n### Ugruntowanie w źródłach, klasy wyjścia i przydatne zapisy\n\nUdokumentowany 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.\n\nPięć 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.\n\nPrzepł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.", "alias_of": null, "aliases": [], "author": "Black Forest Labs", "capabilities": { "context_length": 46864, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "image" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.082", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.082", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Pełny cennik konfiguracji w szczegółach." } ], "ctx": null, "formats": [ "images" ], "id": "black-forest-labs/flux-3-image", "input": [ "text", "image" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "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." }, "outputs": { "all_results": "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.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "black-forest-labs/flux-3-image" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "enum_known": true, "name": "resolution", "required": false, "type": "string" }, { "enum": [ "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" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 1, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 10, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "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" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 10, "minItems": 0, "type": "array" }, "model": { "enum": [ "black-forest-labs/flux-3-image" ], "type": "string" }, "n": { "maximum": 1, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "resolution": { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "black-forest-labs/flux-3-image", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Szacowany koszt generowania", "units": [ { "amount": "0.082", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.082", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n 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\"