FLUX 3 Image je model Black Forest Labs za ustvarjanje in urejanje slik z izrecnim nadzorom kompozicije. Besedilni opis lahko ustvari nov prizor; priložene slike lahko določijo motiv, prizor za spremembo ali več elementov za združitev. Omejevalni okvirji opisu omogočajo določiti, kam sodi vsak element in kateri deli obstoječe slike naj se spremenijo. Rezultat je slika z zahtevanim prizorom, besedilom in postavitvijo za pregled.
Pri novi sliki opišite motiv, dejanje ali držo, okolje, svetlobo in kadriranje. Točno besedilo v sliki postavite v narekovaje in navedite, kje se pojavi. Izviren opis izdelka lahko pokaže rdečo pohodniško skodelico na svetli kamniti površini z velikim naslovom nad njo in mehko jutranjo svetlobo, ki razkrije ročaj. Določite razmerje med naslovom, izdelkom in ozadjem, namesto da podajate nepovezane slogovne besede.
Pri urejanju označite določen predmet in spremembo: prebarvajte skodelico, zamenjajte etiketo, premaknite figuro ali spremenite slog prizora. Posamezna ureditev ne zahteva ročno narisanega okvirja. Dokumentirani postopek pred ustvarjanjem razširi navodilo ter lahko poimenovani element najde in samodejno doda okvir. Vrnjeni razširjeni poziv zabeleži to razlago, kar je uporabno, kadar navodilo izbere napačen predmet ali uvede neželeno podrobnost.
Natančni proizvajalčev profil sprejme od ene do deset referenc, podanih kot URL slik ali kodirani slikovni podatki. Vsaka mora meriti vsaj 256×256 pikslov in ne sme presegati 16 megapikslov. Referenco poimenujte po mestu ali vidni vsebini, nato pojasnite njeno vlogo: oseba iz Image 1, jakna iz Image 2 in soba iz Image 3. Slikovna referenca je vir vizualnih informacij, ne navodilo za kopiranje vsake nepovezane podrobnosti, ki jo vsebuje.
Nastavitev razmerja stranic je privzeto auto. V specifikaciji zahteve ima razmerje, zahtevano v pozivu, prednost; sicer kadriranje določi prva referenca, kvadratni izhod pa je rezervna možnost, kadar ga ne določa niti referenca niti zahtevana oblika. Pri sestavljeni sliki želeno referenco prizora postavite najprej ali razmerje izberite izrecno. Izvorne slike in njihov vrstni red hranite z rezultatom, da poznejša sprememba uporabi isto vizualno izhodišče.
Poziv za postavitev združi opis z nizom vrstic elementov JSON. Opis element poimenuje z oznako, kot je <cup_1>; vrstica vsebuje id, bbox in desc. Koordinate so cela števila od 0 do 1000 v vrstnem redu [top, left, bottom, right], merjena od zgornjega levega kota. [0, 0, 500, 500] denimo opisuje zgornjo levo četrtino ne glede na mere slike v pikslih. Uporabite razmerje stranic, za katero je bila postavitev zasnovana, saj se ta koordinatna mreža raztegne skupaj s kadrom.
Vrstica urejanja namesto tega poleg identifikatorja in opisa uporablja from, src_bbox in tgt_bbox. ref_image_0 pomeni prvo priloženo sliko. Ujemajoča se izvorni in ciljni okvir element zasidrata; različna okvirja ga premakneta ali spremenita njegovo velikost. Nova vrstica brez vira svoj opis ustvari na ciljni lokaciji, kar omogoča dodatke, zamenjave ali prebarvanje. Izvorna vrstica brez cilja element odstrani. Dodajanja in odstranjevanja navedite v pisnem navodilu in vrsticah ter ohranite sidrne vrstice za podrobnosti, ki morajo ostati na mestu.
Napisom dodelite lasten okvir in njihovo točno besedilo navedite v narekovajih v desc. Okvirji usmerjajo postavitev in velikost; niso obrezovalne maske, zato element lahko sega čez pravokotnik. Proizvajalec poroča, da se novi predmeti v okvirjih okoli 40×25 pikslov v njegovih primerih pogosto niso pojavili. Dovolite dovolj vidnega prostora in preverite urejene meje. Piksli zunaj cilja običajno ostanejo stabilni, vendar se sence, odsevi in bližnja osvetlitev še vedno lahko spremenijo.
Dokumentirani profil privzeto omogoča navezavo na podatke, tako da spletno in slikovno iskanje usmerjata ustvarjanje. Izklopite jo lahko pri opisu, ki naj uporablja samo priloženi opis in reference. Pri motivu iz resničnega sveta jasno označite lokacijo, dogodek ali predmet ter stvarno vsebino ločite od umetniške obdelave. Podobe, informirane z iskanjem, je še vedno treba primerjati z avtoritativnim gradivom, kadar mora biti etiketa, predmet ali upodobljen dogodek natančen.
Pet razredov ločljivosti je 768sq, 1k, 1.5k, 2k in 4k, privzeto 1k. Predstavljajo razrede z enako površino pikslov, zato sta natančna širina in višina odvisni od izbranega razmerja. Petnajst stalnih razmerij sega od 21:9 prek kvadratnih in pokončnih formatov do 9:21. Profil tega modela velikost nadzoruje z razmerjem in ločljivostjo; ne ponuja polj semena, širine ali višine, ki jih uporabljajo profili zahtev FLUX.2. Njegov dokumentirani izbirnik različice trenutno poimenuje spreminjajočo se izdajo, ne potrjuje pa ujemanja z datiranimi utežmi dobavitelja.
Proizvajalčev postopek po asinhroni obdelavi vrne sliko skupaj z razširjenim pozivom. Podpisana povezava za prenos slike velja eno uro. Shranite dejansko sliko, končni poziv in reference, namesto da bi se zanašali na začasno povezavo. Pri pregledanem gradivu zahtevano besedilo, postavitev predmetov, referenčno identiteto in spremenjeno območje primerjajte pri predvideni velikosti prikaza. Končano ustvarjanje je izhodišče za preverjanje teh vizualnih zahtev.
", "aboutText": "FLUX 3 Image je model Black Forest Labs za ustvarjanje in urejanje slik z izrecnim nadzorom kompozicije. Besedilni opis lahko ustvari nov prizor; priložene slike lahko določijo motiv, prizor za spremembo ali več elementov za združitev. Omejevalni okvirji opisu omogočajo določiti, kam sodi vsak element in kateri deli obstoječe slike naj se spremenijo. Rezultat je slika z zahtevanim prizorom, besedilom in postavitvijo za pregled.\n\n### Ustvarite prizor ali podajte navodilo za urejanje\n\nPri novi sliki opišite motiv, dejanje ali držo, okolje, svetlobo in kadriranje. Točno besedilo v sliki postavite v narekovaje in navedite, kje se pojavi. Izviren opis izdelka lahko pokaže rdečo pohodniško skodelico na svetli kamniti površini z velikim naslovom nad njo in mehko jutranjo svetlobo, ki razkrije ročaj. Določite razmerje med naslovom, izdelkom in ozadjem, namesto da podajate nepovezane slogovne besede.\n\nPri urejanju označite določen predmet in spremembo: prebarvajte skodelico, zamenjajte etiketo, premaknite figuro ali spremenite slog prizora. Posamezna ureditev ne zahteva ročno narisanega okvirja. Dokumentirani postopek pred ustvarjanjem razširi navodilo ter lahko poimenovani element najde in samodejno doda okvir. Vrnjeni razširjeni poziv zabeleži to razlago, kar je uporabno, kadar navodilo izbere napačen predmet ali uvede neželeno podrobnost.\n\n### Združite in pripravite referenčne slike\n\nNatančni proizvajalčev profil sprejme od ene do deset referenc, podanih kot URL slik ali kodirani slikovni podatki. Vsaka mora meriti vsaj 256×256 pikslov in ne sme presegati 16 megapikslov. Referenco poimenujte po mestu ali vidni vsebini, nato pojasnite njeno vlogo: oseba iz Image 1, jakna iz Image 2 in soba iz Image 3. Slikovna referenca je vir vizualnih informacij, ne navodilo za kopiranje vsake nepovezane podrobnosti, ki jo vsebuje.\n\nNastavitev razmerja stranic je privzeto auto. V specifikaciji zahteve ima razmerje, zahtevano v pozivu, prednost; sicer kadriranje določi prva referenca, kvadratni izhod pa je rezervna možnost, kadar ga ne določa niti referenca niti zahtevana oblika. Pri sestavljeni sliki želeno referenco prizora postavite najprej ali razmerje izberite izrecno. Izvorne slike in njihov vrstni red hranite z rezultatom, da poznejša sprememba uporabi isto vizualno izhodišče.\n\n### Elemente postavite z omejevalnimi okvirji\n\nPoziv za postavitev združi opis z nizom vrstic elementov JSON. Opis element poimenuje z oznako, kot jeblack-forest-labs/flux-3-imageFLUX 3 Image ustvarja in ureja slike iz pisnega opisa ter do desetih referenc. Dodaja omejevalne okvirje na podlagi poziva za kompozicijo in lokalne spremembe, navezavo na spletne in slikovne podatke ter pet razredov ločljivosti.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
FLUX 3 Image je model Black Forest Labs za ustvarjanje in urejanje slik z izrecnim nadzorom kompozicije. Besedilni opis lahko ustvari nov prizor; priložene slike lahko določijo motiv, prizor za spremembo ali več elementov za združitev. Omejevalni okvirji opisu omogočajo določiti, kam sodi vsak element in kateri deli obstoječe slike naj se spremenijo. Rezultat je slika z zahtevanim prizorom, besedilom in postavitvijo za pregled.
Pri novi sliki opišite motiv, dejanje ali držo, okolje, svetlobo in kadriranje. Točno besedilo v sliki postavite v narekovaje in navedite, kje se pojavi. Izviren opis izdelka lahko pokaže rdečo pohodniško skodelico na svetli kamniti površini z velikim naslovom nad njo in mehko jutranjo svetlobo, ki razkrije ročaj. Določite razmerje med naslovom, izdelkom in ozadjem, namesto da podajate nepovezane slogovne besede.
Pri urejanju označite določen predmet in spremembo: prebarvajte skodelico, zamenjajte etiketo, premaknite figuro ali spremenite slog prizora. Posamezna ureditev ne zahteva ročno narisanega okvirja. Dokumentirani postopek pred ustvarjanjem razširi navodilo ter lahko poimenovani element najde in samodejno doda okvir. Vrnjeni razširjeni poziv zabeleži to razlago, kar je uporabno, kadar navodilo izbere napačen predmet ali uvede neželeno podrobnost.
Natančni proizvajalčev profil sprejme od ene do deset referenc, podanih kot URL slik ali kodirani slikovni podatki. Vsaka mora meriti vsaj 256×256 pikslov in ne sme presegati 16 megapikslov. Referenco poimenujte po mestu ali vidni vsebini, nato pojasnite njeno vlogo: oseba iz Image 1, jakna iz Image 2 in soba iz Image 3. Slikovna referenca je vir vizualnih informacij, ne navodilo za kopiranje vsake nepovezane podrobnosti, ki jo vsebuje.
Nastavitev razmerja stranic je privzeto auto. V specifikaciji zahteve ima razmerje, zahtevano v pozivu, prednost; sicer kadriranje določi prva referenca, kvadratni izhod pa je rezervna možnost, kadar ga ne določa niti referenca niti zahtevana oblika. Pri sestavljeni sliki želeno referenco prizora postavite najprej ali razmerje izberite izrecno. Izvorne slike in njihov vrstni red hranite z rezultatom, da poznejša sprememba uporabi isto vizualno izhodišče.
Poziv za postavitev združi opis z nizom vrstic elementov JSON. Opis element poimenuje z oznako, kot je <cup_1>; vrstica vsebuje id, bbox in desc. Koordinate so cela števila od 0 do 1000 v vrstnem redu [top, left, bottom, right], merjena od zgornjega levega kota. [0, 0, 500, 500] denimo opisuje zgornjo levo četrtino ne glede na mere slike v pikslih. Uporabite razmerje stranic, za katero je bila postavitev zasnovana, saj se ta koordinatna mreža raztegne skupaj s kadrom.
Vrstica urejanja namesto tega poleg identifikatorja in opisa uporablja from, src_bbox in tgt_bbox. ref_image_0 pomeni prvo priloženo sliko. Ujemajoča se izvorni in ciljni okvir element zasidrata; različna okvirja ga premakneta ali spremenita njegovo velikost. Nova vrstica brez vira svoj opis ustvari na ciljni lokaciji, kar omogoča dodatke, zamenjave ali prebarvanje. Izvorna vrstica brez cilja element odstrani. Dodajanja in odstranjevanja navedite v pisnem navodilu in vrsticah ter ohranite sidrne vrstice za podrobnosti, ki morajo ostati na mestu.
Napisom dodelite lasten okvir in njihovo točno besedilo navedite v narekovajih v desc. Okvirji usmerjajo postavitev in velikost; niso obrezovalne maske, zato element lahko sega čez pravokotnik. Proizvajalec poroča, da se novi predmeti v okvirjih okoli 40×25 pikslov v njegovih primerih pogosto niso pojavili. Dovolite dovolj vidnega prostora in preverite urejene meje. Piksli zunaj cilja običajno ostanejo stabilni, vendar se sence, odsevi in bližnja osvetlitev še vedno lahko spremenijo.
Dokumentirani profil privzeto omogoča navezavo na podatke, tako da spletno in slikovno iskanje usmerjata ustvarjanje. Izklopite jo lahko pri opisu, ki naj uporablja samo priloženi opis in reference. Pri motivu iz resničnega sveta jasno označite lokacijo, dogodek ali predmet ter stvarno vsebino ločite od umetniške obdelave. Podobe, informirane z iskanjem, je še vedno treba primerjati z avtoritativnim gradivom, kadar mora biti etiketa, predmet ali upodobljen dogodek natančen.
Pet razredov ločljivosti je 768sq, 1k, 1.5k, 2k in 4k, privzeto 1k. Predstavljajo razrede z enako površino pikslov, zato sta natančna širina in višina odvisni od izbranega razmerja. Petnajst stalnih razmerij sega od 21:9 prek kvadratnih in pokončnih formatov do 9:21. Profil tega modela velikost nadzoruje z razmerjem in ločljivostjo; ne ponuja polj semena, širine ali višine, ki jih uporabljajo profili zahtev FLUX.2. Njegov dokumentirani izbirnik različice trenutno poimenuje spreminjajočo se izdajo, ne potrjuje pa ujemanja z datiranimi utežmi dobavitelja.
Proizvajalčev postopek po asinhroni obdelavi vrne sliko skupaj z razširjenim pozivom. Podpisana povezava za prenos slike velja eno uro. Shranite dejansko sliko, končni poziv in reference, namesto da bi se zanašali na začasno povezavo. Pri pregledanem gradivu zahtevano besedilo, postavitev predmetov, referenčno identiteto in spremenjeno območje primerjajte pri predvideni velikosti prikaza. Končano ustvarjanje je izhodišče za preverjanje teh vizualnih zahtev.
POST /v1/images/generationstext, imageimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve black-forest-labs/flux-3-image | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 768, 1K, 1.5K, 2K, 4K | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 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 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 1 | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 10 | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt |
Parametermaterial_types | Specifikacijatext, image |
Življenjski cikel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Strošek |
|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.082 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
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-3-image', '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\nPrenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64
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.\nShranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.
Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrsta |
Poljedata[].url | Vrsta |
Poljedata[].b64_json | Vrsta |
Poljeusage | Vrsta |
Ailoot Ultra black-forest-labs/flux-3-image
/v1/images