Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] on Black Forest Labsin tuotantokäyttöön tarkoitettu kuvamalli tekstipohjaiseen luomiseen ja viitteillä ohjattuun muokkaukseen. Sen dokumentoitu profiili yhdistää fotorealistiset yksityiskohdat, tekstin ja värin hallinnan sekä viitteiden ja tuloksen yhteisen pikselibudjetin enintään 4 megapikselin kuviin.

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

Tietoa mallista

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

FLUX.2 [pro] on Black Forest Labsin tuotantoon keskittyvä kuvien generointi- ja muokkausmalli. Valmistaja esittelee sen oletusvalintana useimpiin FLUX.2:n visuaalisiin tehtäviin: luo uusi kuva tekstistä tai muokkaa kohtausta visuaalisten viitteiden avulla. Perheen ominaisuuksiin kuuluvat fotorealistiset materiaalit ja valaistus, luettava teksti, tarkat väriohjeet sekä yhtenäiset kohteet toisiinsa liittyvissä muokkauksissa. Palautettu lopputulos on kuva tuotenäkymään, toimitukselliseen sommitelmaan, suunnittelukonseptiin tai visuaaliseen viestintään.

Valmistele tuotanto-ohje

Aloita kohteesta, sen toiminnasta tai järjestelystä, tyylistä sekä ympäristöstä tai valosta. Valmistajan kehoteopas antaa alun sanoille enemmän painoa ja suosittelee olennaisen kohteen ja toiminnan sijoittamista ennen koristeellisia yksityiskohtia. Se ehdottaa 10–30 sanaa nopeisiin konsepteihin ja 30–80 sanaa tavallisiin projekteihin sekä pidempiä kuvauksia monimutkaisiin kohtauksiin. Nämä välit ovat kehotteen kirjoitusohjeita, eivät tekstikontekstin raja.

Alkuperäinen katalogiohje voisi näyttää harjatusta teräksestä valmistetun lampun lämpimänharmaalla pöytätasolla kolmen neljäsosan näkymässä, joka paljastaa kytkimen ja varjostimen. Määrittele pinta, valaistus ja näkökulma, joista tuotteen tunnistaa. Ratkaise infografiikkaa tai markkinointikuvaa varten ensin näkyvä sanamuoto ja hierarkia; lainaa tarkka otsikko, yksilöi sen paikka ja nimeä kirjainten tyyli ja koko. Tarkasta nimikkeet, määrät ja tuoteyksityiskohdat lopullisessa näyttökoossa.

Perheen opas dokumentoi sekä luonnollisen kielen että JSON-rakenteiset kehotteet. Rakenteinen kohtausohje voi pitää kohteen, taustan, valon ja sommittelun erillisissä kentissä, jotta yhtä vaatimusta voidaan muuttaa selvästi. Se tukee myös heksadesimaalivärien kuvauksia: liitä koodi tiettyyn väritettävään esineeseen tai tekstiin. Kuvaile haluttu ulkoasu myönteisesti, sillä dokumentoitu FLUX.2:n kehoteprosessi ei tarjoa negatiivisia kehotteita.

Muokkaa viitteillä yhteisen pikselibudjetin puitteissa

Nimenomainen [pro]-pyyntöprofiili tarjoaa kahdeksan viitekuvapaikkaa; valmistajan interaktiivinen käyttöliittymä tukee erikseen kymmentä. Anna jokaiselle kuvalle rooli, kuten kohteen ulkonäkö, vaatetus, tuotemuotoilu, huone tai tyyli. Kerro olemassa olevasta kohtauksesta muutettava elementti sekä säilytettävä sommittelu, ympäristö ja visuaaliset yksityiskohdat. Julkaistuihin esimerkkeihin kuuluvat huonekaluyhdistelmät, taustan tai sään muutokset, korvaavat esineet ja tekstimuutokset.

Viitekapasiteetti riippuu myös tuloskoosta. Valmistajan [pro]-opas määrittelee syötteen ja tuloksen yhteiseksi budjetiksi 9 megapikseliä. Sen esimerkit sallivat kahdeksan viitettä 1 megapikselin tuloksella ja seitsemän 2 megapikselin tuloksella, joten viitekapasiteetti pienenee pyydetyn tuloksen kasvaessa. Suunnittele lähdejoukko ja tulos yhdessä äläkä oleta kaikkien enimmäispaikkojen olevan käytettävissä joka tuloskoossa. Käytä tarpeellisen tiedon määritteleviä viitteitä ja yksilöi niiden tarkoitettu vaikutus.

Tuoteyhdistelmässä ensimmäinen kuva voi antaa tuotteen, toinen huoneen ja kolmas materiaalin viimeistelyn. Selitä, miten niistä tulee yksi yhtenäinen kohtaus. Jos tulos muuttaa säilytettävää muotoa, merkintää tai identiteettiä, kohdista jatkopyyntö tähän ongelmaan koko ohjeen korvaamisen sijaan. Käytännön tulos on muokattu kuva, jonka viiteuskollisuutta ja täsmällistä muutosta verrataan syötteisiin.

Kehotteen laajennus sekä kiinteät ja esikatseluprofiilit

Nimenomainen [pro]-määritys käyttää oletuksena kehotteen laajennusta. Sen disable_pup-asetus pysäyttää laajennuksen, kun huolellisesti kirjoitettua ohjetta tulee käyttää sellaisenaan. Säilytä valittu asetus versioita vertaillessasi, sillä sama lyhyt konsepti ja laajennettu kuvaus ovat eri generointisyötteitä. Tämä on valmistajaprofiilin asetus, ei takuu jokaisen pyydetyn yksityiskohdan oikeasta toteutumisesta.

Dokumentaatio erottaa tavallisen [pro]-päätepisteen kiinteänä tilannekuvana [pro] Preview -profiilista, johon tuodaan myöhempiä malliparannuksia. Pyyntöjen ja vastausten rakenteet ovat samat, mutta taustalla olevat painot eroavat. Säilytä tarkka valittu profiili kuvan ja viitteiden mukana. Erillinen Preview-nimike ei saa huomaamatta korvata tavallista [pro]-valintaa, kun muutos riippuu samasta dokumentoidusta mallivalinnasta.

Mitat, muodot ja valittu kuva

Perheen opas dokumentoi enintään 4 megapikselin tuloksen sekä täsmälliset mitat, joiden on oltava vähintään 64×64 ja 16:n monikertoja. Se suosittelee useimpiin käyttötapauksiin enintään 2 megapikseliä. Leveys ja korkeus määrittelevät halutun rajauksen; neliömäinen tuotekuva, pystyasettelu ja leveä toimituksellinen kohtaus jakavat tilan eri tavoin. Nimenomainen pyyntö luettelee JPEG-, PNG- ja WebP-tulokset, oletuksena JPEG:n, sekä valinnaisen siemenen.

[max]-profiililla on erillinen tietoon perustava hakutoiminto, [flex] tarjoaa näytteistysaskeleet ja ohjausvoimakkuuden ja [klein] pienemmän neljän viitteen profiilin. Valitse versio tehtävän mukaan sen sijaan, että siirtäisit näitä asetuksia [pro]:hon. Säilytä valitusta kuvasta varsinainen tiedosto, lopullinen kehote, viitteet, mitat ja mallinimike. Valmistajan FLUX.2:n allekirjoitetut tuloslinkit vanhenevat kymmenessä minuutissa, joten hae kuva sen sijaan, että luottaisit väliaikaiseen sijaintiin. Arvioi kohteen identiteetti, värit, teksti, sommittelu ja muokatut yksityiskohdat ennen tuloksen sijoittamista asiakkaille näkyvään aineistoon.

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

black-forest-labs/flux.2-pro

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

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-pro	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.06 tuloskuvan megapikseliä kohden
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Laskutusyksikkö—	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.06 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-pro', '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-pro

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

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

Black Forest Labs: FLUX.2 Pro