FLUX.2 [flex] on Black Forest Labsin kuvien generointi- ja muokkausversio, joka erikoistuu typografiaan, tekstin muodostamiseen ja pienten yksityiskohtien säilyttämiseen. Se käyttää kirjallisia kohtausohjeita ja kuvaviitteitä kuvan tuottamiseen. Sen määrittelevä asetus on säädettävä näytteistys: dokumentoitu profiili tarjoaa sekä päättelyaskeleet että ohjausvoimakkuuden, joten visuaalista ohjetta voidaan tarkentaa asetuksilla sanojen lisäksi.
Typografiatehtävän tulee alkaa varsinaisesta tekstistä. Lainaa jokainen rivi, määrittele sen paikka ja erota otsikko, tukiteksti ja nimike. Kuvaile kirjainten tyyli, koko ja väri suhteessa kohtaukseen. Alkuperäinen julisteohje voisi näyttää koboltinsinisen polkupyörän vaaleassa studiossa, suuren otsikon rungon yläpuolella ja pienemmän teknisen tekstirivin alapuolella. Kuvan on tehtävä sekä tuote että lukujärjestys selkeiksi.
Yksilöi yksityiskohtaisesta tuotekuvasta sen hyödyllisyyden ratkaisevat osat: kellotaulu, ohjaimen nimike, sauma, materiaalin reuna tai pakkausmerkintä. Anna luettava viite ja selitä, minkä piirteen se määrittelee. Yleisesti samannäköinen kohtaus voi silti muuttaa tärkeän merkin tai komponentin, joten vertaa generoitua yksityiskohtaa tarkoitetussa näyttökoossa. Mallin erikoistuminen on syy antaa tarkat vaatimukset, ei takuu oikoluvun tai visuaalisen tarkastuksen tarpeettomuudesta.
Valmistajan nimenomainen profiili hyväksyy 1–50 päättelyaskelta, oletuksena viisikymmentä. Kuvaus yhdistää suuremman askelmäärän runsaampiin yksityiskohtiin ja realismiin. Ohjausvoimakkuus on 1.5–10, oletuksena 5. Suurempi ohjausvoimakkuus vahvistaa kehotteen noudattamista mutta voi vähentää realismia. Tarkkoja suunnitteluohjeita noudattava kuva ja luonnollista valokuvamaista ulkonäköä tavoitteleva kuva voivat siksi vaatia profiilin sisällä erilaisia valintoja.
Pidä sanamuoto, viitteet ja tuloksen muoto samoina asetusmuutosta vertaillessasi. Tarkastele muutoksen aiheuttanutta piirrettä: kirjainten muotoja, esineen sijoittelua tai materiaalin tekstuuria. Muuta asetusta tietystä visuaalisesta syystä äläkä pidä suurta lukua automaattisesti parempana. Nämä ovat valmistajan näytteistysasetuksia; neljän askeleen tislattu [klein]-profiili ja [pro]:n tai [max]:n vakioasetukset ovat eri mallivalintoja.
Kehotteen laajennus on [flex]-määrityksessä oletuksena käytössä, ja sen voi poistaa käytöstä omalla prompt_upsampling-asetuksella. Näin yksityiskohtainen ohje voi tarvittaessa säilyä annettuna tekstinä. Valmistajan yhteinen opas suosittelee pääkohteen ja tärkeän toiminnan sijoittamista ennen toissijaista koristelua ja kuvaa JSON-rakenteisia kehotteita luonnollisen kielen ohjeiden rinnalla. Käytä rakennetta, jolla tarvittavat suhteet on helpointa määritellä.
Nimenomaisessa pyyntöprofiilissa on kahdeksan viitekuvapaikkaa. Valmistajan interaktiivinen työnkulku sallii erikseen enintään kymmenen kuvaa; luvut kuvaavat eri rajapintoja. Määrittele, antaako kuva muokattavan kohtauksen, tuotteen, hahmon, vaatetuksen vai tyylin. Yksilöi muutosta varten esine ja muutos ja nimeä sitten säilytettävä ympäröivä sommittelu, materiaalit tai valo.
Alkuperäinen pakkaustehtävä voisi käyttää ensimmäisen kuvan kartonkirasiaa ja toisen viimeistelyä, korvata etuetiketin hyväksytyllä sanamuodolla ja säilyttää rasian mittasuhteet. Ryhmäsommittelu voi antaa jokaiselle kohteelle oman viitteen ja pitää nämä määritykset samoina. Perheen esimerkit kattavat esine- ja taustamuutokset, yhdistelyn, tekstimuokkaukset ja tyylimuunnokset. Pyydä yksi yhtenäinen muutos selkeällä tavoitteella ja vertaa sitten sekä muokattua aluetta että ennallaan pysyviksi tarkoitettuja osia.
FLUX.2-opas dokumentoi vähimmäiskooksi 64×64 pikseliä, mitat 16:n monikertoina ja enintään 4 megapikselin tuloksen sekä suosittelee tavalliseen käyttöön enintään 2 megapikseliä. Nimenomainen [flex]-määritys luettelee JPEG-, PNG- ja WebP-tulokset, oletuksena JPEG:n. Se tarjoaa myös valinnaisen satunnaissiemenen. Säilytä varsinainen malli, siemen ja näytteistysasetukset lähdeviitteiden mukana versioita vertaillessasi; pelkkä perheen nimi ei yksilöi koko generointiasetusta.
Liitä väriherkässä työssä jokainen heksakoodi nimettyyn esineeseen tai tekstielementtiin. Määrittele sommittelua varten haluttu kuvasuhde kuvamitoilla ja jätä tarpeeksi tilaa luettavalle tekstille. Yhteisessä oppaassa ei ole negatiivisen kehotteen mekanismia, joten kuvaile haluttu ulkoasu myönteisesti: terävä tarkennus, siisti tausta tai selvästi tyhjä tekstialue. Sen monikieliset esimerkit tukevat kulttuurisesti täsmällisen ohjeen kirjoittamista sopivalla kielellä mutta eivät vahvista kiinteää kielimäärätakuuta.
Valmistajan FLUX.2-prosessi palauttaa kuvan käsittelyn jälkeen ja käyttää väliaikaisia allekirjoitettuja linkkejä, joiden hakuaika on kymmenen minuuttia. Säilytä varsinainen kuva ja ohje yhdessä. Tarkista typografia, hienot yksityiskohdat, viiteidentiteetti ja visuaalinen käsittely ennen kuvan sijoittamista asetteluun. Lopullinen toimitus voi olla valittu juliste, tuotekuva tai muokattu sommitelma, jonka tarkat asetukset säilytetään seuraavaa muutosta varten.
", "aboutText": "FLUX.2 [flex] on Black Forest Labsin kuvien generointi- ja muokkausversio, joka erikoistuu typografiaan, tekstin muodostamiseen ja pienten yksityiskohtien säilyttämiseen. Se käyttää kirjallisia kohtausohjeita ja kuvaviitteitä kuvan tuottamiseen. Sen määrittelevä asetus on säädettävä näytteistys: dokumentoitu profiili tarjoaa sekä päättelyaskeleet että ohjausvoimakkuuden, joten visuaalista ohjetta voidaan tarkentaa asetuksilla sanojen lisäksi.\n\n### Tekstaus ja hienot yksityiskohdat\n\nTypografiatehtävän tulee alkaa varsinaisesta tekstistä. Lainaa jokainen rivi, määrittele sen paikka ja erota otsikko, tukiteksti ja nimike. Kuvaile kirjainten tyyli, koko ja väri suhteessa kohtaukseen. Alkuperäinen julisteohje voisi näyttää koboltinsinisen polkupyörän vaaleassa studiossa, suuren otsikon rungon yläpuolella ja pienemmän teknisen tekstirivin alapuolella. Kuvan on tehtävä sekä tuote että lukujärjestys selkeiksi.\n\nYksilöi yksityiskohtaisesta tuotekuvasta sen hyödyllisyyden ratkaisevat osat: kellotaulu, ohjaimen nimike, sauma, materiaalin reuna tai pakkausmerkintä. Anna luettava viite ja selitä, minkä piirteen se määrittelee. Yleisesti samannäköinen kohtaus voi silti muuttaa tärkeän merkin tai komponentin, joten vertaa generoitua yksityiskohtaa tarkoitetussa näyttökoossa. Mallin erikoistuminen on syy antaa tarkat vaatimukset, ei takuu oikoluvun tai visuaalisen tarkastuksen tarpeettomuudesta.\n\n### Askeleilla ja ohjausvoimakkuudella on eri tarkoitukset\n\nValmistajan nimenomainen profiili hyväksyy 1–50 päättelyaskelta, oletuksena viisikymmentä. Kuvaus yhdistää suuremman askelmäärän runsaampiin yksityiskohtiin ja realismiin. Ohjausvoimakkuus on 1.5–10, oletuksena 5. Suurempi ohjausvoimakkuus vahvistaa kehotteen noudattamista mutta voi vähentää realismia. Tarkkoja suunnitteluohjeita noudattava kuva ja luonnollista valokuvamaista ulkonäköä tavoitteleva kuva voivat siksi vaatia profiilin sisällä erilaisia valintoja.\n\nPidä sanamuoto, viitteet ja tuloksen muoto samoina asetusmuutosta vertaillessasi. Tarkastele muutoksen aiheuttanutta piirrettä: kirjainten muotoja, esineen sijoittelua tai materiaalin tekstuuria. Muuta asetusta tietystä visuaalisesta syystä äläkä pidä suurta lukua automaattisesti parempana. Nämä ovat valmistajan näytteistysasetuksia; neljän askeleen tislattu [klein]-profiili ja [pro]:n tai [max]:n vakioasetukset ovat eri mallivalintoja.\n\nKehotteen laajennus on [flex]-määrityksessä oletuksena käytössä, ja sen voi poistaa käytöstä omalla prompt_upsampling-asetuksella. Näin yksityiskohtainen ohje voi tarvittaessa säilyä annettuna tekstinä. Valmistajan yhteinen opas suosittelee pääkohteen ja tärkeän toiminnan sijoittamista ennen toissijaista koristelua ja kuvaa JSON-rakenteisia kehotteita luonnollisen kielen ohjeiden rinnalla. Käytä rakennetta, jolla tarvittavat suhteet on helpointa määritellä.\n\n### Viitteisiin perustuvat muutokset\n\nNimenomaisessa pyyntöprofiilissa on kahdeksan viitekuvapaikkaa. Valmistajan interaktiivinen työnkulku sallii erikseen enintään kymmenen kuvaa; luvut kuvaavat eri rajapintoja. Määrittele, antaako kuva muokattavan kohtauksen, tuotteen, hahmon, vaatetuksen vai tyylin. Yksilöi muutosta varten esine ja muutos ja nimeä sitten säilytettävä ympäröivä sommittelu, materiaalit tai valo.\n\nAlkuperäinen pakkaustehtävä voisi käyttää ensimmäisen kuvan kartonkirasiaa ja toisen viimeistelyä, korvata etuetiketin hyväksytyllä sanamuodolla ja säilyttää rasian mittasuhteet. Ryhmäsommittelu voi antaa jokaiselle kohteelle oman viitteen ja pitää nämä määritykset samoina. Perheen esimerkit kattavat esine- ja taustamuutokset, yhdistelyn, tekstimuokkaukset ja tyylimuunnokset. Pyydä yksi yhtenäinen muutos selkeällä tavoitteella ja vertaa sitten sekä muokattua aluetta että ennallaan pysyviksi tarkoitettuja osia.\n\n### Koko, väri ja palautettu kuva\n\nFLUX.2-opas dokumentoi vähimmäiskooksi 64×64 pikseliä, mitat 16:n monikertoina ja enintään 4 megapikselin tuloksen sekä suosittelee tavalliseen käyttöön enintään 2 megapikseliä. Nimenomainen [flex]-määritys luettelee JPEG-, PNG- ja WebP-tulokset, oletuksena JPEG:n. Se tarjoaa myös valinnaisen satunnaissiemenen. Säilytä varsinainen malli, siemen ja näytteistysasetukset lähdeviitteiden mukana versioita vertaillessasi; pelkkä perheen nimi ei yksilöi koko generointiasetusta.\n\nLiitä väriherkässä työssä jokainen heksakoodi nimettyyn esineeseen tai tekstielementtiin. Määrittele sommittelua varten haluttu kuvasuhde kuvamitoilla ja jätä tarpeeksi tilaa luettavalle tekstille. Yhteisessä oppaassa ei ole negatiivisen kehotteen mekanismia, joten kuvaile haluttu ulkoasu myönteisesti: terävä tarkennus, siisti tausta tai selvästi tyhjä tekstialue. Sen monikieliset esimerkit tukevat kulttuurisesti täsmällisen ohjeen kirjoittamista sopivalla kielellä mutta eivät vahvista kiinteää kielimäärätakuuta.\n\nValmistajan FLUX.2-prosessi palauttaa kuvan käsittelyn jälkeen ja käyttää väliaikaisia allekirjoitettuja linkkejä, joiden hakuaika on kymmenen minuuttia. Säilytä varsinainen kuva ja ohje yhdessä. Tarkista typografia, hienot yksityiskohdat, viiteidentiteetti ja visuaalinen käsittely ennen kuvan sijoittamista asetteluun. Lopullinen toimitus voi olla valittu juliste, tuotekuva tai muokattu sommitelma, jonka tarkat asetukset säilytetään seuraavaa muutosta varten.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a2a16e0d705908b0aa1740e86433ea6a848829ded0ebd68ea718919ead3c0d7a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "black-forest-labs/flux.2-flexFLUX.2 [flex] erikoistuu kuvien typografiaan ja pieniin visuaalisiin yksityiskohtiin säädettävillä näytteistysaskelilla ja ohjausvoimakkuudella. Kehitä tekstillä ja kuvaviitteillä julisteita, tuoteasetteluja tai täsmällisiä muutoksia ja tasapainota ohjeen noudattaminen ja realismi.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
FLUX.2 [flex] on Black Forest Labsin kuvien generointi- ja muokkausversio, joka erikoistuu typografiaan, tekstin muodostamiseen ja pienten yksityiskohtien säilyttämiseen. Se käyttää kirjallisia kohtausohjeita ja kuvaviitteitä kuvan tuottamiseen. Sen määrittelevä asetus on säädettävä näytteistys: dokumentoitu profiili tarjoaa sekä päättelyaskeleet että ohjausvoimakkuuden, joten visuaalista ohjetta voidaan tarkentaa asetuksilla sanojen lisäksi.
Typografiatehtävän tulee alkaa varsinaisesta tekstistä. Lainaa jokainen rivi, määrittele sen paikka ja erota otsikko, tukiteksti ja nimike. Kuvaile kirjainten tyyli, koko ja väri suhteessa kohtaukseen. Alkuperäinen julisteohje voisi näyttää koboltinsinisen polkupyörän vaaleassa studiossa, suuren otsikon rungon yläpuolella ja pienemmän teknisen tekstirivin alapuolella. Kuvan on tehtävä sekä tuote että lukujärjestys selkeiksi.
Yksilöi yksityiskohtaisesta tuotekuvasta sen hyödyllisyyden ratkaisevat osat: kellotaulu, ohjaimen nimike, sauma, materiaalin reuna tai pakkausmerkintä. Anna luettava viite ja selitä, minkä piirteen se määrittelee. Yleisesti samannäköinen kohtaus voi silti muuttaa tärkeän merkin tai komponentin, joten vertaa generoitua yksityiskohtaa tarkoitetussa näyttökoossa. Mallin erikoistuminen on syy antaa tarkat vaatimukset, ei takuu oikoluvun tai visuaalisen tarkastuksen tarpeettomuudesta.
Valmistajan nimenomainen profiili hyväksyy 1–50 päättelyaskelta, oletuksena viisikymmentä. Kuvaus yhdistää suuremman askelmäärän runsaampiin yksityiskohtiin ja realismiin. Ohjausvoimakkuus on 1.5–10, oletuksena 5. Suurempi ohjausvoimakkuus vahvistaa kehotteen noudattamista mutta voi vähentää realismia. Tarkkoja suunnitteluohjeita noudattava kuva ja luonnollista valokuvamaista ulkonäköä tavoitteleva kuva voivat siksi vaatia profiilin sisällä erilaisia valintoja.
Pidä sanamuoto, viitteet ja tuloksen muoto samoina asetusmuutosta vertaillessasi. Tarkastele muutoksen aiheuttanutta piirrettä: kirjainten muotoja, esineen sijoittelua tai materiaalin tekstuuria. Muuta asetusta tietystä visuaalisesta syystä äläkä pidä suurta lukua automaattisesti parempana. Nämä ovat valmistajan näytteistysasetuksia; neljän askeleen tislattu [klein]-profiili ja [pro]:n tai [max]:n vakioasetukset ovat eri mallivalintoja.
Kehotteen laajennus on [flex]-määrityksessä oletuksena käytössä, ja sen voi poistaa käytöstä omalla prompt_upsampling-asetuksella. Näin yksityiskohtainen ohje voi tarvittaessa säilyä annettuna tekstinä. Valmistajan yhteinen opas suosittelee pääkohteen ja tärkeän toiminnan sijoittamista ennen toissijaista koristelua ja kuvaa JSON-rakenteisia kehotteita luonnollisen kielen ohjeiden rinnalla. Käytä rakennetta, jolla tarvittavat suhteet on helpointa määritellä.
Nimenomaisessa pyyntöprofiilissa on kahdeksan viitekuvapaikkaa. Valmistajan interaktiivinen työnkulku sallii erikseen enintään kymmenen kuvaa; luvut kuvaavat eri rajapintoja. Määrittele, antaako kuva muokattavan kohtauksen, tuotteen, hahmon, vaatetuksen vai tyylin. Yksilöi muutosta varten esine ja muutos ja nimeä sitten säilytettävä ympäröivä sommittelu, materiaalit tai valo.
Alkuperäinen pakkaustehtävä voisi käyttää ensimmäisen kuvan kartonkirasiaa ja toisen viimeistelyä, korvata etuetiketin hyväksytyllä sanamuodolla ja säilyttää rasian mittasuhteet. Ryhmäsommittelu voi antaa jokaiselle kohteelle oman viitteen ja pitää nämä määritykset samoina. Perheen esimerkit kattavat esine- ja taustamuutokset, yhdistelyn, tekstimuokkaukset ja tyylimuunnokset. Pyydä yksi yhtenäinen muutos selkeällä tavoitteella ja vertaa sitten sekä muokattua aluetta että ennallaan pysyviksi tarkoitettuja osia.
FLUX.2-opas dokumentoi vähimmäiskooksi 64×64 pikseliä, mitat 16:n monikertoina ja enintään 4 megapikselin tuloksen sekä suosittelee tavalliseen käyttöön enintään 2 megapikseliä. Nimenomainen [flex]-määritys luettelee JPEG-, PNG- ja WebP-tulokset, oletuksena JPEG:n. Se tarjoaa myös valinnaisen satunnaissiemenen. Säilytä varsinainen malli, siemen ja näytteistysasetukset lähdeviitteiden mukana versioita vertaillessasi; pelkkä perheen nimi ei yksilöi koko generointiasetusta.
Liitä väriherkässä työssä jokainen heksakoodi nimettyyn esineeseen tai tekstielementtiin. Määrittele sommittelua varten haluttu kuvasuhde kuvamitoilla ja jätä tarpeeksi tilaa luettavalle tekstille. Yhteisessä oppaassa ei ole negatiivisen kehotteen mekanismia, joten kuvaile haluttu ulkoasu myönteisesti: terävä tarkennus, siisti tausta tai selvästi tyhjä tekstialue. Sen monikieliset esimerkit tukevat kulttuurisesti täsmällisen ohjeen kirjoittamista sopivalla kielellä mutta eivät vahvista kiinteää kielimäärätakuuta.
Valmistajan FLUX.2-prosessi palauttaa kuvan käsittelyn jälkeen ja käyttää väliaikaisia allekirjoitettuja linkkejä, joiden hakuaika on kymmenen minuuttia. Säilytä varsinainen kuva ja ohje yhdessä. Tarkista typografia, hienot yksityiskohdat, viiteidentiteetti ja visuaalinen käsittely ennen kuvan sijoittamista asetteluun. Lopullinen toimitus voi olla valittu juliste, tuotekuva tai muokattu sommitelma, jonka tarkat asetukset säilytetään seuraavaa muutosta varten.
POST /v1/images/generationstext, imageimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat black-forest-labs/flux.2-flex | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Vähimmäispituus: 1 | Oletus— |
Kenttäaspect_ratio | Tyyppistring | VaatimusValinnainen | Arvot & rajat 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Oletus— |
Kenttäoutput_format | Tyyppistring | VaatimusValinnainen | Arvot & rajat png, jpeg | Oletus— |
Kenttän | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 1 | Oletus— |
Kenttäinput_references | Tyyppiarray | VaatimusValinnainen | Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 8 | Oletus— |
Kenttäprovider | Tyyppiobject | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt |
Parametrimaterial_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}
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.
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 |
| Asetuksetsyötekuvan megapikseli | Hinnasto— | Ennustettu määrä— | Laskutusyksikkösyötekuvan megapikseliä kohden | Veloitus Syöte · syötekuvan megapikseli · Arvio vain vertailua varten $0.12 syötekuvan megapikseliä kohden |
| Asetuksetkuvatulosteen megapikseli | Hinnasto— | Ennustettu määrä— | Laskutusyksikkötuloskuvan megapikseliä kohden | Veloitus Tuloste · kuvatulosteen megapikseli · Arvio vain vertailua varten $0.12 tuloskuvan megapikseliä kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusyksikkö— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.12 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux.2-flex', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nLataa jokainen palautettu kuva tai tallenna sen Base64-sisältö
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nTallenna 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.
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.
| Kenttä | Tyyppi |
|---|---|
Kenttäcreated | Tyyppi |
Kenttädata[].url | Tyyppi |
Kenttädata[].b64_json | Tyyppi |
Kenttäusage | Tyyppi |
Ailoot Ultra black-forest-labs/flux.2-flex
/v1/images