FLUX 3 Image je model Black Forest Labs pro generování a úpravy obrázků s explicitním ovládáním kompozice. Textový popis může vytvořit novou scénu; dodané obrázky mohou určit objekt, scénu k úpravě nebo několik prvků ke spojení. Ohraničující rámečky umožňují v zadání určit, kam každý prvek patří a které části existujícího obrázku se mají změnit. Výsledkem je obrázek s požadovanou scénou, textem a rozvržením ke kontrole.
Pro nový obrázek popište objekt, děj či pózu, prostředí, světlo a rámování. Přesné znění uvnitř obrázku uveďte v uvozovkách a určete jeho umístění. Vlastní produktové zadání může ukazovat červený kempingový hrnek na světlém kamenném povrchu s velkým titulkem nad ním a měkkým ranním světlem odhalujícím ucho. Určete vztah titulku, produktu a pozadí místo nesouvisejících stylových slov.
Při úpravě označte konkrétní předmět a změnu: přebarvení hrnku, nahrazení etikety, přesunutí postavy či změnu stylu scény. Jediná úprava nevyžaduje ručně nakreslený rámeček. Dokumentovaný postup rozšiřuje pokyn před generováním a může automaticky najít pojmenovaný prvek a přidat rámeček. Vrácený rozšířený prompt zaznamenává tuto interpretaci, což je užitečné, když pokyn vybere nesprávný předmět nebo přidá nežádoucí detail.
Konkrétní profil výrobce přijímá jednu až deset referencí dodaných jako obrazové URL nebo kódovaná obrazová data. Každá musí mít alespoň 256×256 pixelů a nejvýše 16 megapixelů. Referenci pojmenujte podle pozice či viditelného obsahu a vysvětlete její roli: osoba z Image 1, bunda z Image 2 a místnost z Image 3. Obrazová reference je zdrojem vizuálních informací, nikoli pokynem ke kopírování každého nesouvisejícího detailu, který obsahuje.
Nastavení poměru stran je ve výchozím stavu auto. Ve specifikaci požadavku má poměr požadovaný v promptu přednost; jinak rámování určuje první reference a pokud je neurčuje reference ani požadovaný formát, použije se čtvercový výstup. Pro kompozici umístěte zamýšlenou referenci scény jako první nebo poměr zvolte explicitně. Zdrojové obrázky i jejich pořadí uchovejte u výsledku, aby pozdější úprava použila stejný vizuální výchozí bod.
Prompt rozvržení kombinuje popisek s polem JSON tvořeným řádky prvků. Popisek pojmenuje prvek značkou jako <cup_1>; řádek obsahuje id, bbox a desc. Souřadnice jsou celá čísla od 0 do 1000 v pořadí [top, left, bottom, right], měřená od levého horního rohu. Například [0, 0, 500, 500] popisuje levou horní čtvrtinu bez ohledu na pixelové rozměry obrázku. Použijte poměr stran, pro který bylo rozvržení navrženo, protože tato souřadnicová síť se natahuje spolu s rámem.
Řádek úpravy místo toho vedle identifikátoru a popisu používá from, src_bbox a tgt_bbox. ref_image_0 znamená první dodaný obrázek. Shodné zdrojové a cílové rámečky prvek ukotvují; odlišné jej přesouvají nebo mění jeho velikost. Nový řádek bez zdroje vygeneruje na cílovém místě obsah podle svého popisu a umožňuje přidávání, nahrazování či přebarvování. Zdrojový řádek bez cíle prvek odstraní. Přidání a odstranění uveďte v písemném pokynu i v řádcích a ponechte ukotvující řádky pro detaily, které musí zůstat na místě.
Písmu dejte vlastní rámeček a jeho přesné znění uveďte v uvozovkách v desc. Rámečky řídí umístění a měřítko; nejsou ořezovými maskami, proto prvek může přesahovat obdélník. Výrobce uvádí, že nové objekty v rámečcích kolem 40×25 pixelů se v jeho příkladech často neobjevily. Ponechte dost viditelného prostoru a prohlédněte upravené hranice. Pixely mimo cíl zpravidla zůstávají stabilní, ale stíny, odlesky a blízké osvětlení se přesto mohou změnit.
Dokumentovaný profil ve výchozím stavu zapíná grounding, takže generování může využívat webové a obrazové vyhledávání. Lze jej vypnout pro zadání, které má používat pouze dodaný popis a reference. U skutečného tématu jasně určete místo, událost nebo předmět a faktický obsah oddělte od uměleckého zpracování. Obrazy informované vyhledáváním stále vyžadují porovnání s autoritativními materiály, má-li být popisek, předmět či zobrazená událost přesná.
Pět tříd rozlišení je 768sq, 1k, 1.5k, 2k a 4k s výchozím 1k. V rámci každé třídy zůstává pixelová plocha stejná napříč poměry stran, takže přesná šířka a výška závisejí na zvoleném poměru. Patnáct pevných poměrů sahá od 21:9 přes čtvercové a portrétní formáty po 9:21. Profil tohoto modelu řídí velikost poměrem a rozlišením; nezpřístupňuje pole seed, width a height používaná v profilech požadavků FLUX.2. Jeho dokumentovaný výběr verze nyní označuje průběžně měněné vydání místo potvrzení datované shody vah dodavatele.
Postup výrobce vrací obrázek po asynchronním zpracování spolu s rozšířeným promptem. Podepsaný odkaz ke stažení obrázku platí jednu hodinu. Uchovejte samotný obrázek, konečný prompt a reference místo spoléhání na dočasný odkaz. U kontrolovaného materiálu porovnejte požadovaný text, umístění předmětů, identitu referencí a změněnou oblast v zamýšlené velikosti zobrazení. Dokončené generování je výchozím bodem pro kontrolu těchto vizuálních požadavků.
", "aboutText": "FLUX 3 Image je model Black Forest Labs pro generování a úpravy obrázků s explicitním ovládáním kompozice. Textový popis může vytvořit novou scénu; dodané obrázky mohou určit objekt, scénu k úpravě nebo několik prvků ke spojení. Ohraničující rámečky umožňují v zadání určit, kam každý prvek patří a které části existujícího obrázku se mají změnit. Výsledkem je obrázek s požadovanou scénou, textem a rozvržením ke kontrole.\n\n### Vytvořte scénu nebo zadejte pokyn k úpravě\n\nPro nový obrázek popište objekt, děj či pózu, prostředí, světlo a rámování. Přesné znění uvnitř obrázku uveďte v uvozovkách a určete jeho umístění. Vlastní produktové zadání může ukazovat červený kempingový hrnek na světlém kamenném povrchu s velkým titulkem nad ním a měkkým ranním světlem odhalujícím ucho. Určete vztah titulku, produktu a pozadí místo nesouvisejících stylových slov.\n\nPři úpravě označte konkrétní předmět a změnu: přebarvení hrnku, nahrazení etikety, přesunutí postavy či změnu stylu scény. Jediná úprava nevyžaduje ručně nakreslený rámeček. Dokumentovaný postup rozšiřuje pokyn před generováním a může automaticky najít pojmenovaný prvek a přidat rámeček. Vrácený rozšířený prompt zaznamenává tuto interpretaci, což je užitečné, když pokyn vybere nesprávný předmět nebo přidá nežádoucí detail.\n\n### Spojte a připravte referenční obrázky\n\nKonkrétní profil výrobce přijímá jednu až deset referencí dodaných jako obrazové URL nebo kódovaná obrazová data. Každá musí mít alespoň 256×256 pixelů a nejvýše 16 megapixelů. Referenci pojmenujte podle pozice či viditelného obsahu a vysvětlete její roli: osoba z Image 1, bunda z Image 2 a místnost z Image 3. Obrazová reference je zdrojem vizuálních informací, nikoli pokynem ke kopírování každého nesouvisejícího detailu, který obsahuje.\n\nNastavení poměru stran je ve výchozím stavu auto. Ve specifikaci požadavku má poměr požadovaný v promptu přednost; jinak rámování určuje první reference a pokud je neurčuje reference ani požadovaný formát, použije se čtvercový výstup. Pro kompozici umístěte zamýšlenou referenci scény jako první nebo poměr zvolte explicitně. Zdrojové obrázky i jejich pořadí uchovejte u výsledku, aby pozdější úprava použila stejný vizuální výchozí bod.\n\n### Umístěte prvky pomocí ohraničujících rámečků\n\nPrompt rozvržení kombinuje popisek s polem JSON tvořeným řádky prvků. Popisek pojmenuje prvek značkou jakoblack-forest-labs/flux-3-imageFLUX 3 Image vytváří a upravuje obrázky z písemného zadání a až deseti referencí. Přidává ohraničující rámečky zadané promptem pro kompozici a místní změny, ukotvení pomocí webového a obrazového vyhledávání a pět tříd rozlišení.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
FLUX 3 Image je model Black Forest Labs pro generování a úpravy obrázků s explicitním ovládáním kompozice. Textový popis může vytvořit novou scénu; dodané obrázky mohou určit objekt, scénu k úpravě nebo několik prvků ke spojení. Ohraničující rámečky umožňují v zadání určit, kam každý prvek patří a které části existujícího obrázku se mají změnit. Výsledkem je obrázek s požadovanou scénou, textem a rozvržením ke kontrole.
Pro nový obrázek popište objekt, děj či pózu, prostředí, světlo a rámování. Přesné znění uvnitř obrázku uveďte v uvozovkách a určete jeho umístění. Vlastní produktové zadání může ukazovat červený kempingový hrnek na světlém kamenném povrchu s velkým titulkem nad ním a měkkým ranním světlem odhalujícím ucho. Určete vztah titulku, produktu a pozadí místo nesouvisejících stylových slov.
Při úpravě označte konkrétní předmět a změnu: přebarvení hrnku, nahrazení etikety, přesunutí postavy či změnu stylu scény. Jediná úprava nevyžaduje ručně nakreslený rámeček. Dokumentovaný postup rozšiřuje pokyn před generováním a může automaticky najít pojmenovaný prvek a přidat rámeček. Vrácený rozšířený prompt zaznamenává tuto interpretaci, což je užitečné, když pokyn vybere nesprávný předmět nebo přidá nežádoucí detail.
Konkrétní profil výrobce přijímá jednu až deset referencí dodaných jako obrazové URL nebo kódovaná obrazová data. Každá musí mít alespoň 256×256 pixelů a nejvýše 16 megapixelů. Referenci pojmenujte podle pozice či viditelného obsahu a vysvětlete její roli: osoba z Image 1, bunda z Image 2 a místnost z Image 3. Obrazová reference je zdrojem vizuálních informací, nikoli pokynem ke kopírování každého nesouvisejícího detailu, který obsahuje.
Nastavení poměru stran je ve výchozím stavu auto. Ve specifikaci požadavku má poměr požadovaný v promptu přednost; jinak rámování určuje první reference a pokud je neurčuje reference ani požadovaný formát, použije se čtvercový výstup. Pro kompozici umístěte zamýšlenou referenci scény jako první nebo poměr zvolte explicitně. Zdrojové obrázky i jejich pořadí uchovejte u výsledku, aby pozdější úprava použila stejný vizuální výchozí bod.
Prompt rozvržení kombinuje popisek s polem JSON tvořeným řádky prvků. Popisek pojmenuje prvek značkou jako <cup_1>; řádek obsahuje id, bbox a desc. Souřadnice jsou celá čísla od 0 do 1000 v pořadí [top, left, bottom, right], měřená od levého horního rohu. Například [0, 0, 500, 500] popisuje levou horní čtvrtinu bez ohledu na pixelové rozměry obrázku. Použijte poměr stran, pro který bylo rozvržení navrženo, protože tato souřadnicová síť se natahuje spolu s rámem.
Řádek úpravy místo toho vedle identifikátoru a popisu používá from, src_bbox a tgt_bbox. ref_image_0 znamená první dodaný obrázek. Shodné zdrojové a cílové rámečky prvek ukotvují; odlišné jej přesouvají nebo mění jeho velikost. Nový řádek bez zdroje vygeneruje na cílovém místě obsah podle svého popisu a umožňuje přidávání, nahrazování či přebarvování. Zdrojový řádek bez cíle prvek odstraní. Přidání a odstranění uveďte v písemném pokynu i v řádcích a ponechte ukotvující řádky pro detaily, které musí zůstat na místě.
Písmu dejte vlastní rámeček a jeho přesné znění uveďte v uvozovkách v desc. Rámečky řídí umístění a měřítko; nejsou ořezovými maskami, proto prvek může přesahovat obdélník. Výrobce uvádí, že nové objekty v rámečcích kolem 40×25 pixelů se v jeho příkladech často neobjevily. Ponechte dost viditelného prostoru a prohlédněte upravené hranice. Pixely mimo cíl zpravidla zůstávají stabilní, ale stíny, odlesky a blízké osvětlení se přesto mohou změnit.
Dokumentovaný profil ve výchozím stavu zapíná grounding, takže generování může využívat webové a obrazové vyhledávání. Lze jej vypnout pro zadání, které má používat pouze dodaný popis a reference. U skutečného tématu jasně určete místo, událost nebo předmět a faktický obsah oddělte od uměleckého zpracování. Obrazy informované vyhledáváním stále vyžadují porovnání s autoritativními materiály, má-li být popisek, předmět či zobrazená událost přesná.
Pět tříd rozlišení je 768sq, 1k, 1.5k, 2k a 4k s výchozím 1k. V rámci každé třídy zůstává pixelová plocha stejná napříč poměry stran, takže přesná šířka a výška závisejí na zvoleném poměru. Patnáct pevných poměrů sahá od 21:9 přes čtvercové a portrétní formáty po 9:21. Profil tohoto modelu řídí velikost poměrem a rozlišením; nezpřístupňuje pole seed, width a height používaná v profilech požadavků FLUX.2. Jeho dokumentovaný výběr verze nyní označuje průběžně měněné vydání místo potvrzení datované shody vah dodavatele.
Postup výrobce vrací obrázek po asynchronním zpracování spolu s rozšířeným promptem. Podepsaný odkaz ke stažení obrázku platí jednu hodinu. Uchovejte samotný obrázek, konečný prompt a reference místo spoléhání na dočasný odkaz. U kontrolovaného materiálu porovnejte požadovaný text, umístění předmětů, identitu referencí a změněnou oblast v zamýšlené velikosti zobrazení. Dokončené generování je výchozím bodem pro kontrolu těchto vizuálních požadavků.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity black-forest-labs/flux-3-image | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Minimální délka: 1 | Výchozí— |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 768, 1K, 1.5K, 2K, 4K | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekVolitelné | Hodnoty a 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 | Výchozí— |
Polen | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Maximum: 1 | Výchozí— |
Poleinput_references | Typarray | PožadavekVolitelné | Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 10 | Výchozí— |
Poleprovider | Typobject | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametrmaterial_types | Kontrakttext, image |
Životní cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Poplatek |
|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.082 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
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\nStáhněte každý vrácený obrázek nebo uložte jeho obsah Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}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.\nUložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.
Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.
Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot Ultra black-forest-labs/flux-3-image
/v1/images