Source: https://ailoot.ai/models/fi/black-forest-labs-flux-3-image/ Canonical: https://ailoot.ai/models/fi/black-forest-labs-flux-3-image/ Language: fi # Black Forest Labs: FLUX.3 Image [Markdown](https://ailoot.ai/models/fi/black-forest-labs-flux-3-image/index.md) · [JSON](https://ailoot.ai/models/fi/black-forest-labs-flux-3-image/facts.json) ## [Black Forest Labs: FLUX.3 Image](https://ailoot.ai/models/fi/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`](https://ailoot.ai/models/fi/black-forest-labs-flux-3-image/#method-0) 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 \; 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`](https://ailoot.ai/models/fi/#m=black-forest-labs%2Fflux-3-image&route=Ultra&caller=black-forest-labs%2Fflux-3-image&fmt=images) Black Forest Labs /`black-forest-labs/flux-3-image` ### Aloitus 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. 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 →](https://ailoot.ai/docs/fi/billing/reserve/) ### Esimerkkipyynnöt #### Ailoot Ultra · Kuvat curl ```bash 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"