Black Forest Labs: FLUX.2 Flex

FLUX.2 [flex] specializuojasi vaizdų tipografijoje ir smulkiose vaizdinėse detalėse, suteikdamas reguliuojamus generavimo žingsnius bei nurodymų laikymosi stiprumą. Naudokite tekstą ir vaizdinius orientyrus plakatams, produktų maketams arba tikslioms pataisoms kurti, derindami nurodymų laikymąsi su tikroviškumu.

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

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

FLUX.2 [flex] yra Black Forest Labs vaizdų generavimo ir redagavimo versija, specializuota tipografijai, teksto atvaizdavimui ir smulkių detalių išsaugojimui. Ji naudoja rašytinius scenos nurodymus bei vaizdinius orientyrus vaizdui sukurti. Jos skiriamasis valdiklis – reguliuojamas generavimas: dokumentuotas profilis pateikia inferencijos žingsnius ir nurodymų laikymosi stiprumą, leisdamas vaizdinę užduotį tikslinti nustatymais bei žodžiais.

Užrašai ir smulkios detalės

Tipografijos užduotis turi prasidėti tikru tekstu. Pacituokite kiekvieną eilutę, apibrėžkite jos vietą ir atskirkite antraštę, papildomą tekstą bei etiketę. Raidžių stilių, mastelį ir spalvą aprašykite scenos atžvilgiu. Originali plakato užduotis gali rodyti kobalto mėlynumo dviratį šviesioje studijoje, didelį pavadinimą virš rėmo ir mažesnę specifikacijos eilutę po juo. Vaizdas turi kartu aiškiai parodyti produktą ir skaitymo tvarką.

Išsamiam produkto vaizdui įvardykite dalis, lemiančias rezultato naudingumą: ciferblatą, valdiklio žymą, siūlę, medžiagos kraštą arba pakuotės žymėjimą. Pateikite įskaitomą orientyrą ir paaiškinkite, kurią savybę jis nustato. Bendrai panaši scena vis tiek gali pakeisti svarbų simbolį ar komponentą, todėl sugeneruotą detalę lyginkite numatytu rodymo dydžiu. Modelio specializacija yra priežastis pateikti tikslius reikalavimus, o ne garantija, kad korektūra ar vaizdinė patikra tampa nereikalinga.

Žingsniai ir nurodymų laikymosi stiprumas turi skirtingą paskirtį

Konkretus gamintojo profilis priima nuo vieno iki penkiasdešimties inferencijos žingsnių, numatytasis skaičius – penkiasdešimt. Jo aprašymas daugiau žingsnių sieja su didesniu detalumu ir tikroviškumu. Nurodymų laikymosi stiprumas svyruoja nuo 1.5 iki 10, numatytasis – 5. Didesnis stiprumas gerina užklausos laikymąsi, bet gali mažinti tikroviškumą. Todėl vaizdui su tiksliais dizaino nurodymais ir vaizdui, siekiančiam natūralios fotografinės išvaizdos, šiame profilyje gali reikėti skirtingų pasirinkimų.

Lygindami nustatymo pakeitimą išlaikykite pastovius tekstą, orientyrus ir išvesties formą. Žiūrėkite į pakeitimą paskatinusią savybę: raidžių formas, daikto vietą ar medžiagos tekstūrą. Nustatymą keiskite dėl konkrečios vaizdinės priežasties, užuot laikę didesnį skaičių automatiškai geresniu. Tai gamintojo generavimo valdikliai; keturių žingsnių distiliuotas [klein] profilis bei standartiniai [pro] ar [max] valdikliai yra kiti modelio pasirinkimai.

[flex] specifikacijoje užklausos išplėtimas pagal numatytuosius nustatymus įjungtas ir gali būti išjungtas atskiru prompt_upsampling valdikliu. Tai leidžia išsamiai užduočiai prireikus likti pateiktu tekstu. Bendras gamintojo vadovas rekomenduoja pagrindinį objektą ir svarbų veiksmą dėti prieš antrinį dekorą ir aprašo JSON struktūros užklausas greta natūralios kalbos užduočių. Naudokite struktūrą, kuria reikiamus ryšius lengviausia nurodyti.

Orientyrais valdomos pataisos

Konkrečiame užklausos profilyje yra aštuonios orientyrinių vaizdų pozicijos. Interaktyvi gamintojo eiga atskirai leidžia iki dešimties vaizdų; šie skaičiai aprašo skirtingas sąsajas. Apibrėžkite, ar vaizdas suteikia redaguotiną sceną, produktą, personažą, aprangą arba stilių. Pataisai įvardykite daiktą ir pakeitimą, tada nurodykite išsaugotiną aplinkinę kompoziciją, medžiagas arba šviesą.

Originali pakuotės užduotis gali naudoti dėžutę iš pirmo vaizdo ir apdailą iš antro, pakeisti priekinę etiketę patvirtintu tekstu ir išlaikyti dėžutės proporcijas. Grupinė kompozicija gali kiekvienam objektui priskirti atskirą orientyrą ir tas priskirtis išlaikyti nuoseklias. Šeimos pavyzdžiai apima daiktų ir fonų keitimą, kompozitingą, teksto pataisas bei stiliaus transformacijas. Prašykite vienos susijusios pataisos su aiškiu tikslu, tada lyginkite redaguotą sritį ir dalis, kurios turėjo išlikti stabilios.

Dydis, spalva ir grąžintas vaizdas

FLUX.2 vadovas dokumentuoja mažiausiai 64×64 pikselius, 16 kartotinius matmenis ir iki 4 megapikselių išvestį, įprastam naudojimui rekomenduodamas iki 2 megapikselių. Konkreti [flex] specifikacija nurodo JPEG, PNG ir WebP, numatytasis – JPEG. Ji taip pat suteikia pasirenkamą pradinį atsitiktinumo skaičių. Lygindami versijas su pradiniais orientyrais laikykite tikrą modelį, pradinį skaičių bei generavimo nustatymus; vien šeimos pavadinimas neidentifikuoja visos generavimo konfigūracijos.

Spalvoms jautriame darbe kiekvieną šešioliktainį kodą susiekite su įvardytu daiktu arba teksto elementu. Kompozicijai norimą kraštinių santykį nurodykite vaizdo matmenimis ir palikite pakankamai vietos įskaitomiems užrašams. Bendras vadovas neturi neigiamos užklausos mechanizmo, todėl norimą išvaizdą aprašykite teigiamai: ryškus fokusas, švarus fonas arba aiškiai tuščia sritis tekstui. Daugiakalbiai jo pavyzdžiai palaiko kultūriškai konkrečios užduoties rašymą tinkama kalba, nenustatydami garantuoto fiksuoto kalbų skaičiaus.

Gamintojo FLUX.2 eiga po apdorojimo grąžina vaizdą ir naudoja laikinas pasirašytas nuorodas su dešimties minučių gavimo langu. Patį vaizdą ir užduotį išsaugokite kartu. Prieš dėdami failą į maketą patikrinkite tipografiją, smulkias detales, orientyrų tapatumą ir vaizdinę stilistiką. Galutinis rezultatas gali būti pasirinktas plakatas, produkto vaizdas arba redaguota kompozicija su tiksliais nustatymais, išsaugotais kitai pataisai.

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

black-forest-labs/flux.2-flex

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

Pradžia

Leidžiamos įvestys: Tekstas · Vaizdai
Rezultatai: Vaizdai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdai POST /v1/images/generations

Įvestis: text, image
Išvestis: image

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos black-forest-labs/flux.2-flex	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`aspect_ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Numatyta—
Laukas`output_format`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos png, jpeg	Numatyta—
Laukas`n`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 1	Numatyta—
Laukas`input_references`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 8	Numatyta—
Laukas`provider`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, prompt
Parametras`material_types`	Specifikacijatext, image

Gyvavimo ciklas: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Apskaitos vienetas	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Apskaitos vienetas—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
Konfigūracijaįvesties vaizdo megapikselis	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetasuž įvesties vaizdo megapikselį	Mokestis Įvestis · įvesties vaizdo megapikselis · Įvertis tik palyginimui $0.12 už įvesties vaizdo megapikselį
Konfigūracijaišvesties vaizdo megapikselis	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetasuž išvesties vaizdo megapikselį	Mokestis Išvestis · išvesties vaizdo megapikselis · Įvertis tik palyginimui $0.12 už išvesties vaizdo megapikselį
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Apskaitos vienetas—	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.12 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdai

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux.2-flex', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdai

Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Kito turinio skaitymas

Skaityti esamą jums priklausančią medžiagą

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.

Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.

Atsakymo laukai

Laukas	Tipas
Laukas`created`	Tipas
Laukas`data[].url`	Tipas
Laukas`data[].b64_json`	Tipas
Laukas`usage`	Tipas

Pseudonimai

Modelių pseudonimai

Ailoot Ultra black-forest-labs/flux.2-flex

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

black-forest-labs/flux.2-flex

FAQ · Black Forest Labs: FLUX.2 Flex

Kokios įvestys ir rezultatai prieinami?: POST /v1/images/generations · black-forest-labs/flux.2-flex: text, image → image
Kokius laukus naudoja užklausa?: POST /v1/images/generations · black-forest-labs/flux.2-flex: model, prompt, aspect_ratio, output_format, n, input_references, provider
Kokie apribojimai taikomi?: POST /v1/images/generations · black-forest-labs/flux.2-flex: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Flex