Black Forest Labs: FLUX.3 Image

FLUX 3 Image luo ja muokkaa kuvia kirjallisesta ohjeesta ja enintään kymmenestä viitteestä. Se lisää kehotepohjaiset rajauslaatikot sommitteluun ja paikallisiin muutoksiin, verkko- ja kuvahakuun perustamisen sekä viisi tarkkuusluokkaa.

Ailoot Ultra · Kuvat POST /v1/images/generations black-forest-labs/flux-3-image

Tietoa mallista

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

FLUX 3 Image on Black Forest Labsin kuvien generointi- ja muokkausmalli, jossa sommittelua voi hallita tarkasti. Tekstikuvaus voi luoda uuden kohtauksen; annetut kuvat voivat määritellä kohteen, muokattavan kohtauksen tai useita yhdistettäviä elementtejä. Rajauslaatikot antavat ohjeelle mahdollisuuden määritellä, mihin kukin elementti kuuluu ja mitä olemassa olevan kuvan osia tulee muuttaa. Tuloksena on kuva, josta tarkastetaan pyydetty kohtaus, teksti ja asettelu.

Luo kohtaus tai anna muokkausohje

Kuvaile uutta kuvaa varten kohde, toiminta tai asento, ympäristö, valo ja rajaus. Kirjoita tarkka kuvan sisäinen sanamuoto lainausmerkkeihin ja kerro, missä se näkyy. Alkuperäinen tuoteohje voisi näyttää punaisen retkimukin vaalealla kivipinnalla, suuren otsikon sen yläpuolella ja pehmeän aamuvalon paljastamassa kahvan. Määrittele otsikon, tuotteen ja taustan suhde irrallisten tyylisanojen sijaan.

Yksilöi muokkausta varten tietty esine ja muutos: väritä muki uudelleen, vaihda etiketti, siirrä hahmoa tai muuta kohtauksen tyyliä. Yksittäinen muokkaus ei vaadi käsin piirrettyä laatikkoa. Dokumentoitu työnkulku laajentaa ohjeen ennen generointia ja voi paikantaa nimetyn elementin sekä lisätä laatikon automaattisesti. Sen palautettu laajennettu kehote tallentaa tulkinnan, mistä on hyötyä ohjeen valitessa väärän esineen tai tuodessa ei-toivotun yksityiskohdan.

Yhdistä ja valmistele viitekuvat

Valmistajan nimenomainen profiili hyväksyy yhdestä kymmeneen viitettä kuva-URL-osoitteina tai koodattuna kuvadatana. Jokaisen on oltava vähintään 256×256 pikseliä ja enintään 16 megapikseliä. Nimeä viite sen paikan tai näkyvän sisällön mukaan ja selitä rooli: henkilö kuvasta Image 1, takki kuvasta Image 2 ja huone kuvasta Image 3. Kuvaviite on visuaalisen tiedon lähde, ei ohje kopioida sen jokaista asiaankuulumatonta yksityiskohtaa.

Kuvasuhdeasetuksen oletus on auto. Pyyntömäärityksessä kehotteessa pyydetty kuvasuhde on ensisijainen; muuten ensimmäinen viite määrittelee rajauksen, ja varavaihtoehto on neliö, jos viite tai pyydetty muoto ei anna sitä. Aseta yhdistelmässä halutun kohtauksen viite ensimmäiseksi tai valitse suhde täsmällisesti. Säilytä lähdekuvat ja niiden järjestys tuloksen mukana, jotta myöhempi muutos käyttää samaa visuaalista lähtökohtaa.

Sijoita elementit rajauslaatikoilla

Asettelukehote yhdistää kuvauksen ja elementtirivien JSON-taulukon. Kuvaus nimeää elementin merkillä, kuten <cup_1>; rivi sisältää id-, bbox- ja desc-kentät. Koordinaatit ovat kokonaislukuja 0–1000 järjestyksessä [top, left, bottom, right], mitattuina vasemmasta yläkulmasta. Esimerkiksi [0, 0, 500, 500] kuvaa vasenta yläneljännestä kuvan pikselimitoista riippumatta. Käytä kuvasuhdetta, jolle asettelu suunniteltiin, koska koordinaatisto venyy ruudun mukana.

Muokkausrivi käyttää sen sijaan from-, src_bbox- ja tgt_bbox-kenttiä tunnisteen ja kuvauksen rinnalla. ref_image_0 tarkoittaa ensimmäistä annettua kuvaa. Yhtenevät lähde- ja kohdelaatikot ankkuroivat elementin; erilaiset laatikot siirtävät sitä tai muuttavat sen kokoa. Uusi rivi ilman lähdettä generoi kuvauksensa kohdepaikkaan ja sallii lisäykset, korvaukset tai uudelleenvärityksen. Lähderivi ilman kohdetta poistaa elementin. Kerro lisäykset ja poistot sekä kirjallisessa ohjeessa että riveillä ja säilytä ankkuririvit paikoillaan pysyville yksityiskohdille.

Anna tekstille oma laatikko ja lainaa tarkka sanamuoto desc-kentässä. Laatikot ohjaavat sijoittelua ja kokoa; ne eivät ole leikkausmaskeja, joten elementti voi ulottua suorakulmion ulkopuolelle. Valmistaja kertoo, että uudet esineet noin 40×25 pikselin laatikoissa jäivät usein ilmestymättä sen esimerkeissä. Varaa tarpeeksi näkyvää tilaa ja tarkasta muokatut rajat. Kohteen ulkopuoliset pikselit pysyvät yleensä vakaina, mutta varjot, heijastukset ja lähellä oleva valaistus voivat silti muuttua.

Tietoon perustaminen, tulosluokat ja hyödylliset tallenteet

Dokumentoitu profiili ottaa oletuksena käyttöön tietoon perustamisen, jolloin verkko- ja kuvahaku voivat ohjata generointia. Sen voi poistaa käytöstä ohjeessa, jonka tulee käyttää vain annettua kuvausta ja viitteitä. Yksilöi todellisen maailman aiheesta paikka, tapahtuma tai esine selvästi ja pidä faktasisältö erillään taiteellisesta käsittelystä. Hakutietoon perustuvaa kuvaa on silti verrattava auktoritatiiviseen aineistoon, kun nimikkeen, esineen tai kuvatun tapahtuman on oltava oikein.

Viisi tarkkuusluokkaa ovat 768sq, 1k, 1.5k, 2k ja 4k, oletuksena 1k. Ne ovat saman pikselipinta-alan tasoja, joten tarkka leveys ja korkeus riippuvat valitusta suhteesta. Viisitoista kiinteää suhdetta ulottuvat 21:9:stä neliön ja pystymuotojen kautta 9:21:een. Tämän mallin profiili hallitsee kokoa kuvasuhteella ja tarkkuudella; se ei tarjoa FLUX.2:n pyyntöprofiilien seed-, width- tai height-kenttiä. Sen dokumentoitu versionvalitsin nimeää tällä hetkellä muuttuvan julkaisun eikä vahvista päivättyä vastaavuutta toimittajan mallipainoihin.

Valmistajan työnkulku palauttaa kuvan asynkronisen käsittelyn jälkeen yhdessä laajennetun kehotteen kanssa. Allekirjoitettu kuvan latauslinkki on voimassa yhden tunnin. Säilytä varsinainen kuva, lopullinen kehote ja viitteet väliaikaiseen linkkiin luottamisen sijaan. Vertaa arvioidusta kuvasta pyydettyä tekstiä, esineiden sijoittelua, viiteidentiteettiä ja muutettua aluetta tarkoitetussa näyttökoossa. Valmistunut generointi on näiden visuaalisten vaatimusten tarkistamisen lähtökohta.

Ailoot Ultra · Kuvat POST /v1/images/generations black-forest-labs/flux-3-image

black-forest-labs/flux-3-image

Black Forest Labs /black-forest-labs/flux-3-image

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-3-image	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Vähimmäispituus: 1	Oletus—
Kenttä`resolution`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 768, 1K, 1.5K, 2K, 4K	Oletus—
Kenttä`aspect_ratio`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 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	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ä: 10	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ä	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	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
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.082 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-3-image', '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-3-image

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image

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

Black Forest Labs: FLUX.3 Image