Black Forest Labs: FLUX.2 Max

FLUX.2 [max] on Black Forest Labsin kuvamalli vaativiin lopullisiin kuviin ja yhtenäisiin muokkauksiin. Sen dokumentoitu profiili yhdistää visuaaliset viitteet, tarkan kohtauksen hallinnan sekä verkkotietoon perustamisen ajankohtaisille kohteille ja tuottaa enintään 4 megapikselin kuvia.

Ailoot Ultra · Kuvat POST /v1/images/generations black-forest-labs/flux.2-max

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

FLUX.2 [max] on Black Forest Labsin FLUX.2-kuvien generointi- ja muokkausperheen korkeimman laadun jäsen. Valmistaja asemoi sen vaativiin lopullisiin kuviin, monimutkaisen ohjeen vahvaan noudattamiseen ja muokkausten väliseen yhtenäisyyteen. Se luo kuvan kirjallisesta kuvauksesta tai käyttää annettuja kuvia visuaalisina viitteinä. Sen erottava perheominaisuus on tietoon perustava haku: pyyntö voi hyödyntää ajankohtaista tietoa pelkän kehotteessa kuvatun kohtauksen sijaan.

Todellisen maailman tieto ja visuaalinen ohje

Valmistaja dokumentoi verkkohaun esimerkiksi nykyistä säätä, tuoretta urheilutapahtumaa tai historiallista ympäristöä varten. Yksilöi kuvaan liittyvä todellinen paikka, tapahtuma ja aika ja kuvaile sitten taiteellinen käsittely erikseen. Tietoon perustuva sääkorttikonsepti voi määritellä kaupungin, visualisoitavan säätilan, tarkan otsikon ja asettelun. Haku ohjaa generointia; houkuttelevankin kuvituksen näkyvät faktat on tarkistettava olennaisesta lähteestä ennen faktaviestintäkäyttöä.

Tämä hakukyky kuuluu [max]:lle julkaistussa FLUX.2-vertailussa. Muilla nimetyillä jäsenillä on omat roolinsa: [pro] tuotantoon, [flex] säädettävään näytteistykseen ja typografiaan sekä [klein] kompaktiin interaktiiviseen generointiin. Säilytä valittu mallinimi tuloksen mukana, jotta myöhempi muutos ei huomaamatta vaihda tietoon perustettavaa profiilia toiseen versioon.

Viitteet vaativiin muokkauksiin

Dokumentoitu pyyntöprofiili hyväksyy enintään kahdeksan viitekuvaa; valmistajan interaktiivinen käyttöliittymä sallii erikseen kymmenen. Anna kullekin viitteelle rooli, kuten hahmon ulkonäkö, tuotemuotoilu, vaatetus, huone tai visuaalinen tyyli. Sommitelma voi yhdistää yhden kuvan tuolin toisen huoneeseen säilyttäen tuolin siluetin ja materiaalin. Yksilöi olemassa olevasta kohtauksesta muutettava esine ja säilytettävät yksityiskohdat, myös valon suunta ja ympäristön geometria.

Perheen esimerkkeihin kuuluvat taustamuutokset, esineiden korvaaminen, huonekalusommitelmat, tekstimuokkaukset ja yhtenäiset hahmot. Alkuperäinen lopullisen kuvan ohje voisi sijoittaa annetun kellon tummalle taitellulle kankaalle, säilyttää kellotaulun ja rannekkeen muotoilun ja muuttaa vain valaistuksen pehmeäksi sivuvaloksi. Nimeä, mikä lähde antaa kunkin piirteen, ja arvioi syntyneet kellotaulu, merkinnät, materiaali ja heijastukset yhdessä. Säilyttämisohje määrittelee tavoitteen; palautettu kuva on siihen verrattava näyttö.

Teksti, värit ja kehotteen tulkinta

FLUX.2-opas suosittelee rakennetta kohde–toiminta–tyyli–konteksti ja tärkeiden elementtien sijoittamista ensin. Se ehdottaa 10–30 sanaa nopeisiin konsepteihin, 30–80 tavallisiin projekteihin ja pidempiä kuvauksia monimutkaiseen kohtaukseen. Nämä ovat kirjoitussuosituksia, eivät kovia kontekstirajoja. Luonnollinen kieli ja JSON-rakenteiset kohtauskuvaukset ovat molemmat dokumentoituja tapoja järjestää kohteet, sijoittelu, valo ja tyyli. Rakenteinen kehote on kuvaohje, ei lupaus rakenteisesta tekstivastauksesta.

Lainaa näkyvän tekstin sanamuoto, määrittele sen sijainti ja kuvaile typografinen hierarkia. Liitä jokainen heksadesimaaliväri tiettyyn esineeseen tai tekstielementtiin; värikoodi ilman nimettyä kohdetta on monitulkintainen. Valmistajan opas käyttää myönteisiä kuvauksia negatiivisen kehotemekanismin sijaan. Kuvaile tuotenäkymän otsikolle varattu tyhjä alue ja sen tarkoitettu paikka suoraan.

Nimenomainen [max]-pyyntömääritys käyttää oletuksena kehotteen laajennusta. Sen disable_pup-asetus poistaa laajennuksen käytöstä, kun huolellisesti kirjoitettua ohjetta tulee käyttää sellaisenaan. Tämä on eri asia kuin väite, että jokainen sana näkyisi muuttumattomana lopullisessa kuvassa. Säilytä varsinainen ohje ja valittu asetus tuloksen mukana, kun arvioit, johtuiko odottamaton visuaalinen valinta ohjeesta vai sen tulkinnasta.

Tulos ja hyödyllinen lopullinen kuva

Perheen opas dokumentoi kuvat enintään 4 megapikseliin asti sekä täsmälliset mitat, vähintään 64×64 ja 16:n monikertoina. Tavallisen käytön suositus on enintään 2 megapikseliä. Nimenomainen [max]-profiili luettelee JPEG:n, PNG:n ja WebP:n, oletuksena JPEG:n, sekä valinnaisen satunnaissiemenen. Valitse tuloksen muoto käyttökohdetta varten ennen sommittelua. Mallin kuvagenerointi on erillinen asia kuin valmiin kuvan koon muuttaminen.

Säilytä kuva, viitteet, kehote, mitat ja mallin identiteetti lopullista versiota valitessasi. Valmistajan FLUX.2-opas varoittaa allekirjoitetun tuloslinkin väliaikaisuudesta: hakuaika on kymmenen minuuttia. Tarkasta pieni teksti, esineen identiteetti, asettelu, valo ja mahdolliset hausta saadut faktat tarkoitetussa näyttökoossa. Hyödyllinen lopputulos on valittu kuva, jolla on riittävä konteksti täsmällisen muutoksen jatkamiseen, eikä kohtaus, jonka tärkeitä yksityiskohtia ei ole koskaan verrattu ohjeeseen.

Ailoot Ultra · Kuvat POST /v1/images/generations black-forest-labs/flux.2-max

black-forest-labs/flux.2-max

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

Aloitus

Hyväksytyt syötteet: Teksti · Kuvat
Tulokset: Kuvat

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Kuvat POST /v1/images/generations

Syötetyypit: text, image
Tulostyypit: image

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat black-forest-labs/flux.2-max	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Vähimmäispituus: 1	Oletus—
Kenttä`aspect_ratio`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Oletus—
Kenttä`output_format`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat png, jpeg	Oletus—
Kenttä`n`	Tyyppi`integer`	VaatimusValinnainen	Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 1	Oletus—
Kenttä`input_references`	Tyyppi`array`	VaatimusValinnainen	Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 8	Oletus—
Kenttä`provider`	Tyyppi`object`	VaatimusValinnainen	Arvot & rajat	Oletus—

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`content_type`	Sopimusapplication/json
Parametri`required`	Sopimusmodel, prompt
Parametri`material_types`	Sopimustext, image

Elinkaari: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila: Ei määritetty Kun nopea tila on valittu
Flex-tila: Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho: Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

Asetukset	Hinnasto	Ennustettu määrä	Laskutusyksikkö	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	Laskutusyksikkö—	Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
Asetuksetkuvatulosteen megapikseli	Hinnasto—	Ennustettu määrä—	Laskutusyksikkötuloskuvan megapikseliä kohden	Veloitus Tuloste · kuvatulosteen megapikseli · Arvio vain vertailua varten $0.14 tuloskuvan megapikseliä kohden
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Laskutusyksikkö—	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.14 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot Ultra · Kuvat

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-max', '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

Vastaanota ja tallenna tulokset

Ailoot Ultra · Kuvat

Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö

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

Muut sisällön lukukerrat

Lue olemassa olevat omistamasi aineistot

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.

Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.

Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.

Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu X-Client-Request-ID täsmäytystä varten. Tee lukukyselyt vain todellisuudessa palautetuilla task_id/asset_id-arvoilla tai käytä omistamaasi mediakirjastoa; älä koskaan rakenna tehtävän URL-osoitetta operaation ID:n perusteella äläkä lähetä luontipyyntöä uudelleen.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`created`	Tyyppi
Kenttä`data[].url`	Tyyppi
Kenttä`data[].b64_json`	Tyyppi
Kenttä`usage`	Tyyppi

Aliakset

Mallin aliakset

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

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/images/generations · black-forest-labs/flux.2-max: text, image → image
Mitä kenttiä pyyntö käyttää?: POST /v1/images/generations · black-forest-labs/flux.2-max: model, prompt, aspect_ratio, output_format, n, input_references, provider
Mitä rajoja sovelletaan?: POST /v1/images/generations · black-forest-labs/flux.2-max: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Max