FLUX 3 Image je model Black Forest Labs na generovanie a úpravu obrázkov s explicitným ovládaním kompozície. Textový opis môže vytvoriť novú scénu; dodané obrázky môžu určiť subjekt, scénu na revíziu alebo viaceré prvky na spojenie. Ohraničujúce rámčeky umožňujú zadaním určiť miesto každého prvku aj časti existujúceho obrázka, ktoré sa majú zmeniť. Výsledkom je obrázok s požadovanou scénou, textom a rozložením na kontrolu.
Pri novom obrázku opíšte subjekt, akciu alebo pózu, prostredie, svetlo a rámovanie. Presné znenie textu v obrázku dajte do úvodzoviek a určte, kde sa zobrazí. Pôvodné produktové zadanie môže zobrazovať červený kempingový hrnček na svetlom kamennom povrchu s veľkým nadpisom nad ním a jemným ranným svetlom odhaľujúcim uško. Určte vzťah nadpisu, produktu a pozadia namiesto nesúvisiacich štýlových slov.
Pri úpravách identifikujte konkrétny predmet a zmenu: prefarbite hrnček, nahraďte štítok, presuňte postavu alebo zmeňte štýl scény. Jedna úprava nevyžaduje ručne nakreslený rámček. Dokumentovaný postup rozšíri pokyn pred generovaním a môže pomenovaný prvok nájsť aj automaticky pridať rámček. Vrátené rozšírené zadanie zaznamenáva túto interpretáciu, čo je užitočné, keď pokyn vyberie nesprávny objekt alebo zavedie nežiaduci detail.
Presný profil výrobcu prijíma jednu až desať referencií dodaných ako URL obrázkov alebo zakódované obrazové dáta. Každá musí mať aspoň 256×256 pixelov a najviac 16 megapixelov. Referenciu pomenujte podľa pozície alebo viditeľného obsahu a potom vysvetlite jej úlohu: osoba z Image 1, bunda z Image 2 a miestnosť z Image 3. Obrazová referencia je zdrojom vizuálnych informácií, nie pokynom kopírovať každý nesúvisiaci detail, ktorý obsahuje.
Nastavenie pomeru strán má predvolenú hodnotu auto. V špecifikácii požiadavky má prednosť pomer požadovaný v zadaní; inak rámovanie určí prvá referencia, so štvorcovým výstupom ako záložnou voľbou, keď ho neposkytuje referencia ani požadovaný formát. Pri kompozitnej zostave umiestnite zamýšľanú referenciu scény ako prvú alebo pomer vyberte explicitne. Zdrojové obrázky a ich poradie uchovajte s výsledkom, aby neskoršia revízia používala rovnaký vizuálny východiskový bod.
Zadanie rozloženia spája opis s poľom JSON obsahujúcim riadky prvkov. Opis pomenuje prvok pomocou značky ako <cup_1>; riadok obsahuje id, bbox a desc. Súradnice sú celé čísla od 0 do 1000 v poradí [top, left, bottom, right], merané od ľavého horného rohu. Napríklad [0, 0, 500, 500] opisuje ľavú hornú štvrtinu nezávisle od pixelových rozmerov obrázka. Použite pomer strán, pre ktorý bolo rozloženie navrhnuté, pretože súradnicová mriežka sa naťahuje s rámom.
Riadok úpravy naopak používa from, src_bbox a tgt_bbox spolu s identifikátorom a opisom. ref_image_0 znamená prvý dodaný obrázok. Zhodné zdrojové a cieľové rámčeky ukotvujú prvok; odlišné ho presúvajú alebo menia jeho veľkosť. Nový riadok bez zdroja generuje obsah podľa svojho opisu na cieľovom mieste a umožňuje pridanie, náhradu alebo prefarbenie. Zdrojový riadok bez cieľa prvok odstráni. Pridania a odstránenia uveďte v písanom pokyne aj riadkoch a zachovajte ukotvujúce riadky pre detaily, ktoré musia zostať na mieste.
Písmu dajte vlastný rámček a jeho presné znenie citujte v desc. Rámčeky usmerňujú umiestnenie a mierku; nie sú orezovými maskami, takže prvok môže presiahnuť obdĺžnik. Výrobca uvádza, že nové objekty v rámčekoch s veľkosťou okolo 40×25 pixelov sa v jeho príkladoch často nezobrazili. Nechajte dostatočný viditeľný priestor a kontrolujte hranice úprav. Pixely mimo cieľa zvyčajne zostávajú stabilné, ale tiene, odrazy a okolité osvetlenie sa môžu meniť.
Dokumentovaný profil predvolene zapína ukotvenie v zdrojoch a umožňuje webovému aj obrazovému vyhľadávaniu informovať generovanie. Možno ho vypnúť pri zadaní, ktoré má používať iba dodaný opis a referencie. Pri skutočnom subjekte jasne určte miesto, udalosť alebo predmet a faktický obsah oddeľte od umeleckého spracovania. Obrazy informované vyhľadávaním stále treba porovnať s autoritatívnym materiálom, keď sa vyžaduje presnosť štítka, predmetu alebo zobrazenej udalosti.
Päť tried rozlíšenia je 768sq, 1k, 1.5k, 2k a 4k, s predvolenou 1k. Predstavujú úrovne s rovnakou pixelovou plochou, takže presná šírka a výška závisia od zvoleného pomeru. Pätnásť pevných pomerov siaha od 21:9 cez štvorcové a portrétové formáty po 9:21. Profil tohto modelu ovláda veľkosť cez pomer a rozlíšenie; nesprístupňuje polia seed, width alebo height používané v profiloch požiadaviek FLUX.2. Jeho dokumentovaný výber verzie aktuálne pomenúva priebežne aktualizované vydanie namiesto určenia zhody s dodávateľskými váhami k danému dátumu.
Postup výrobcu vracia obrázok po asynchrónnom spracovaní spolu s rozšíreným zadaním. Podpísaný odkaz na stiahnutie obrázka je platný jednu hodinu. Uchovajte samotný obrázok, konečné zadanie a referencie namiesto spoliehania sa na dočasný odkaz. Pri posúdenom vizuáli porovnajte požadovaný text, umiestnenie objektov, referenčnú identitu a zmenenú oblasť pri zamýšľanej veľkosti zobrazenia. Dokončené generovanie je východiskom na kontrolu týchto vizuálnych požiadaviek.
", "aboutText": "FLUX 3 Image je model Black Forest Labs na generovanie a úpravu obrázkov s explicitným ovládaním kompozície. Textový opis môže vytvoriť novú scénu; dodané obrázky môžu určiť subjekt, scénu na revíziu alebo viaceré prvky na spojenie. Ohraničujúce rámčeky umožňujú zadaním určiť miesto každého prvku aj časti existujúceho obrázka, ktoré sa majú zmeniť. Výsledkom je obrázok s požadovanou scénou, textom a rozložením na kontrolu.\n\n### Vytvorte scénu alebo zadajte pokyn na úpravu\n\nPri novom obrázku opíšte subjekt, akciu alebo pózu, prostredie, svetlo a rámovanie. Presné znenie textu v obrázku dajte do úvodzoviek a určte, kde sa zobrazí. Pôvodné produktové zadanie môže zobrazovať červený kempingový hrnček na svetlom kamennom povrchu s veľkým nadpisom nad ním a jemným ranným svetlom odhaľujúcim uško. Určte vzťah nadpisu, produktu a pozadia namiesto nesúvisiacich štýlových slov.\n\nPri úpravách identifikujte konkrétny predmet a zmenu: prefarbite hrnček, nahraďte štítok, presuňte postavu alebo zmeňte štýl scény. Jedna úprava nevyžaduje ručne nakreslený rámček. Dokumentovaný postup rozšíri pokyn pred generovaním a môže pomenovaný prvok nájsť aj automaticky pridať rámček. Vrátené rozšírené zadanie zaznamenáva túto interpretáciu, čo je užitočné, keď pokyn vyberie nesprávny objekt alebo zavedie nežiaduci detail.\n\n### Kombinujte a pripravte referenčné obrázky\n\nPresný profil výrobcu prijíma jednu až desať referencií dodaných ako URL obrázkov alebo zakódované obrazové dáta. Každá musí mať aspoň 256×256 pixelov a najviac 16 megapixelov. Referenciu pomenujte podľa pozície alebo viditeľného obsahu a potom vysvetlite jej úlohu: osoba z Image 1, bunda z Image 2 a miestnosť z Image 3. Obrazová referencia je zdrojom vizuálnych informácií, nie pokynom kopírovať každý nesúvisiaci detail, ktorý obsahuje.\n\nNastavenie pomeru strán má predvolenú hodnotu auto. V špecifikácii požiadavky má prednosť pomer požadovaný v zadaní; inak rámovanie určí prvá referencia, so štvorcovým výstupom ako záložnou voľbou, keď ho neposkytuje referencia ani požadovaný formát. Pri kompozitnej zostave umiestnite zamýšľanú referenciu scény ako prvú alebo pomer vyberte explicitne. Zdrojové obrázky a ich poradie uchovajte s výsledkom, aby neskoršia revízia používala rovnaký vizuálny východiskový bod.\n\n### Umiestňujte prvky pomocou ohraničujúcich rámčekov\n\nZadanie rozloženia spája opis s poľom JSON obsahujúcim riadky prvkov. Opis pomenuje prvok pomocou značky akoblack-forest-labs/flux-3-imageFLUX 3 Image vytvára a upravuje obrázky z písaného zadania a až desiatich referencií. Pridáva ohraničujúce rámčeky zadávané textom pre kompozíciu a lokálne zmeny, ukotvenie vo webových a obrazových zdrojoch a päť tried rozlíšenia.
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
FLUX 3 Image je model Black Forest Labs na generovanie a úpravu obrázkov s explicitným ovládaním kompozície. Textový opis môže vytvoriť novú scénu; dodané obrázky môžu určiť subjekt, scénu na revíziu alebo viaceré prvky na spojenie. Ohraničujúce rámčeky umožňujú zadaním určiť miesto každého prvku aj časti existujúceho obrázka, ktoré sa majú zmeniť. Výsledkom je obrázok s požadovanou scénou, textom a rozložením na kontrolu.
Pri novom obrázku opíšte subjekt, akciu alebo pózu, prostredie, svetlo a rámovanie. Presné znenie textu v obrázku dajte do úvodzoviek a určte, kde sa zobrazí. Pôvodné produktové zadanie môže zobrazovať červený kempingový hrnček na svetlom kamennom povrchu s veľkým nadpisom nad ním a jemným ranným svetlom odhaľujúcim uško. Určte vzťah nadpisu, produktu a pozadia namiesto nesúvisiacich štýlových slov.
Pri úpravách identifikujte konkrétny predmet a zmenu: prefarbite hrnček, nahraďte štítok, presuňte postavu alebo zmeňte štýl scény. Jedna úprava nevyžaduje ručne nakreslený rámček. Dokumentovaný postup rozšíri pokyn pred generovaním a môže pomenovaný prvok nájsť aj automaticky pridať rámček. Vrátené rozšírené zadanie zaznamenáva túto interpretáciu, čo je užitočné, keď pokyn vyberie nesprávny objekt alebo zavedie nežiaduci detail.
Presný profil výrobcu prijíma jednu až desať referencií dodaných ako URL obrázkov alebo zakódované obrazové dáta. Každá musí mať aspoň 256×256 pixelov a najviac 16 megapixelov. Referenciu pomenujte podľa pozície alebo viditeľného obsahu a potom vysvetlite jej úlohu: osoba z Image 1, bunda z Image 2 a miestnosť z Image 3. Obrazová referencia je zdrojom vizuálnych informácií, nie pokynom kopírovať každý nesúvisiaci detail, ktorý obsahuje.
Nastavenie pomeru strán má predvolenú hodnotu auto. V špecifikácii požiadavky má prednosť pomer požadovaný v zadaní; inak rámovanie určí prvá referencia, so štvorcovým výstupom ako záložnou voľbou, keď ho neposkytuje referencia ani požadovaný formát. Pri kompozitnej zostave umiestnite zamýšľanú referenciu scény ako prvú alebo pomer vyberte explicitne. Zdrojové obrázky a ich poradie uchovajte s výsledkom, aby neskoršia revízia používala rovnaký vizuálny východiskový bod.
Zadanie rozloženia spája opis s poľom JSON obsahujúcim riadky prvkov. Opis pomenuje prvok pomocou značky ako <cup_1>; riadok obsahuje id, bbox a desc. Súradnice sú celé čísla od 0 do 1000 v poradí [top, left, bottom, right], merané od ľavého horného rohu. Napríklad [0, 0, 500, 500] opisuje ľavú hornú štvrtinu nezávisle od pixelových rozmerov obrázka. Použite pomer strán, pre ktorý bolo rozloženie navrhnuté, pretože súradnicová mriežka sa naťahuje s rámom.
Riadok úpravy naopak používa from, src_bbox a tgt_bbox spolu s identifikátorom a opisom. ref_image_0 znamená prvý dodaný obrázok. Zhodné zdrojové a cieľové rámčeky ukotvujú prvok; odlišné ho presúvajú alebo menia jeho veľkosť. Nový riadok bez zdroja generuje obsah podľa svojho opisu na cieľovom mieste a umožňuje pridanie, náhradu alebo prefarbenie. Zdrojový riadok bez cieľa prvok odstráni. Pridania a odstránenia uveďte v písanom pokyne aj riadkoch a zachovajte ukotvujúce riadky pre detaily, ktoré musia zostať na mieste.
Písmu dajte vlastný rámček a jeho presné znenie citujte v desc. Rámčeky usmerňujú umiestnenie a mierku; nie sú orezovými maskami, takže prvok môže presiahnuť obdĺžnik. Výrobca uvádza, že nové objekty v rámčekoch s veľkosťou okolo 40×25 pixelov sa v jeho príkladoch často nezobrazili. Nechajte dostatočný viditeľný priestor a kontrolujte hranice úprav. Pixely mimo cieľa zvyčajne zostávajú stabilné, ale tiene, odrazy a okolité osvetlenie sa môžu meniť.
Dokumentovaný profil predvolene zapína ukotvenie v zdrojoch a umožňuje webovému aj obrazovému vyhľadávaniu informovať generovanie. Možno ho vypnúť pri zadaní, ktoré má používať iba dodaný opis a referencie. Pri skutočnom subjekte jasne určte miesto, udalosť alebo predmet a faktický obsah oddeľte od umeleckého spracovania. Obrazy informované vyhľadávaním stále treba porovnať s autoritatívnym materiálom, keď sa vyžaduje presnosť štítka, predmetu alebo zobrazenej udalosti.
Päť tried rozlíšenia je 768sq, 1k, 1.5k, 2k a 4k, s predvolenou 1k. Predstavujú úrovne s rovnakou pixelovou plochou, takže presná šírka a výška závisia od zvoleného pomeru. Pätnásť pevných pomerov siaha od 21:9 cez štvorcové a portrétové formáty po 9:21. Profil tohto modelu ovláda veľkosť cez pomer a rozlíšenie; nesprístupňuje polia seed, width alebo height používané v profiloch požiadaviek FLUX.2. Jeho dokumentovaný výber verzie aktuálne pomenúva priebežne aktualizované vydanie namiesto určenia zhody s dodávateľskými váhami k danému dátumu.
Postup výrobcu vracia obrázok po asynchrónnom spracovaní spolu s rozšíreným zadaním. Podpísaný odkaz na stiahnutie obrázka je platný jednu hodinu. Uchovajte samotný obrázok, konečné zadanie a referencie namiesto spoliehania sa na dočasný odkaz. Pri posúdenom vizuáli porovnajte požadovaný text, umiestnenie objektov, referenčnú identitu a zmenenú oblasť pri zamýšľanej veľkosti zobrazenia. Dokončené generovanie je východiskom na kontrolu týchto vizuálnych požiadaviek.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity black-forest-labs/flux-3-image | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 768, 1K, 1.5K, 2K, 4K | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | 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 | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 1 | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 10 | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parametermaterial_types | Špecifikáciatext, image |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.082 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
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\nStiahnite každý vrátený obrázok alebo 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ázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.
Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot Ultra black-forest-labs/flux-3-image
/v1/images