Black Forest Labs: FLUX.3 Image
FLUX 3 Image lager og redigerer bilder fra en skriftlig beskrivelse og opptil ti referanser. Den legger til promptbaserte avgrensningsbokser for komposisjon og lokale endringer, nett- og bildeforankring og fem oppløsningsklasser.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
FLUX 3 Image er Black Forest Labs’ modell for bildegenerering og -redigering med uttrykkelig kontroll over komposisjonen. En tekstbeskrivelse kan lage en ny scene; innsendte bilder kan fastsette et motiv, en scene som skal bearbeides eller flere elementer som skal kombineres. Avgrensningsbokser lar beskrivelsen angi hvor hvert element hører hjemme, og hvilke deler av et eksisterende bilde som skal endres. Resultatet er et bilde med den ønskede scenen, teksten og layouten som kan undersøkes.
Lag en scene eller gi en redigeringsinstruksjon
For et nytt bilde beskriver du motivet, handlingen eller posituren, omgivelsene, lyset og utsnittet. Sett nøyaktig ordlyd som skal stå i bildet i anførselstegn, og angi hvor den vises. En original produktbeskrivelse kan vise et rødt turkrus på en lys steinoverflate, med en stor overskrift over og mykt morgenlys som fremhever hanken. Definer forholdet mellom overskriften, produktet og bakgrunnen, fremfor å tilby urelaterte stilord.
For redigering angir du det konkrete objektet og endringen: gi kruset ny farge, bytt en etikett, flytt en figur eller endre scenens stil. En enkelt redigering krever ikke en manuelt tegnet boks. Den dokumenterte arbeidsflyten utvider instruksjonen før generering og kan finne det navngitte elementet og legge til en boks automatisk. Den returnerte utvidede prompten registrerer denne tolkningen, noe som er nyttig når en instruksjon velger feil objekt eller innfører en uønsket detalj.
Kombiner og klargjør referansebilder
Den spesifikke produsentprofilen godtar ett til ti referansebilder, sendt inn som bilde-URL-er eller kodede bildedata. Hvert må være minst 256×256 piksler og ikke større enn 16 megapiksler. Navngi en referanse etter posisjonen eller synlig innhold, og forklar deretter rollen: personen fra Image 1, jakken fra Image 2 og rommet fra Image 3. En bildereferanse er en kilde til visuell informasjon, ikke en instruksjon om å kopiere hver urelaterte detalj den inneholder.
Innstillingen for sideforhold har auto som standard. I forespørselsspesifikasjonen har et sideforhold som etterspørres i prompten, prioritet; ellers fastsetter den første referansen utsnittet, med kvadratisk resultat som reservevalg når verken en referanse eller et ønsket format angir det. For en montasje plasserer du den ønskede scenereferansen først eller velger sideforholdet uttrykkelig. Behold kildebildene og rekkefølgen deres sammen med resultatet, slik at en senere revisjon bruker det samme visuelle utgangspunktet.
Plasser elementer med avgrensningsbokser
En layoutprompt kombinerer en bildetekst med en JSON-liste av elementrader. Bildeteksten navngir et element gjennom en markør som <cup_1>; raden inneholder id, bbox og desc. Koordinatene er heltall fra 0 til 1000 i rekkefølgen [top, left, bottom, right], målt fra øvre venstre hjørne. For eksempel beskriver [0, 0, 500, 500] øvre venstre fjerdedel uansett bildets pikseldimensjoner. Bruk sideforholdet layouten er laget for, fordi dette koordinatnettet strekkes med formatet.
En redigeringsrad bruker i stedet from, src_bbox og tgt_bbox sammen med identifikatoren og beskrivelsen. ref_image_0 betyr det første innsendte bildet. Samsvarende kilde- og målbokser forankrer et element; ulike bokser flytter det eller endrer størrelsen. En ny rad uten kilde genererer beskrivelsen på målplasseringen og muliggjør tillegg, erstatninger eller omfarging. En kilderad uten mål fjerner elementet. Angi tillegg og fjerning både i den skriftlige instruksjonen og i radene, og behold forankringsrader for detaljer som må bli på plass.
Gi tekst en egen boks, og sett den nøyaktige ordlyden i anførselstegn i desc. Bokser styrer plassering og størrelse; de er ikke klippemasker, så et element kan strekke seg utenfor rektangelet. Produsenten rapporterer at nye objekter i bokser på omkring 40×25 piksler ofte ikke dukket opp i eksemplene. Gi nok synlig plass, og undersøk de redigerte grensene. Piksler utenfor målet forblir vanligvis stabile, men skygger, refleksjoner og nærliggende lyssetting kan fortsatt endres.
Forankring, utdataklasser og nyttige opplysninger
Den dokumenterte profilen aktiverer forankring som standard og lar nett- og bildesøk informere genereringen. Dette kan deaktiveres for en beskrivelse som bare skal bruke innsendt tekst og referanser. For et virkelig motiv angir du lokasjonen, hendelsen eller objektet tydelig og holder faktainnhold atskilt fra kunstnerisk behandling. Søkestyrte bilder må fortsatt sammenlignes med autoritativt materiale når en etikett, et objekt eller en avbildet hendelse skal være korrekt.
De fem oppløsningsklassene er 768sq, 1k, 1.5k, 2k og 4k, med 1k som standard. De representerer nivåer med samme pikselareal, så den nøyaktige bredden og høyden avhenger av det valgte sideforholdet. Femten faste sideforhold strekker seg fra 21:9 via kvadratiske og stående formater til 9:21. Denne modellprofilen styrer størrelse gjennom sideforhold og oppløsning; den eksponerer ikke feltene seed, width eller height som brukes i forespørselsprofilene for FLUX.2. Den dokumenterte versjonsvelgeren navngir for tiden en løpende utgivelse fremfor å fastslå et datert samsvar med leverandørens modellvekter.
Produsentens arbeidsflyt returnerer et bilde etter asynkron behandling, sammen med den utvidede prompten. Den signerte nedlastingslenken for bildet er gyldig i én time. Behold selve bildet, den endelige prompten og referansene fremfor å støtte deg på en midlertidig lenke. For et gjennomgått bilde sammenligner du ønsket tekst, objektplassering, referanseidentitet og det endrede området i den tiltenkte visningsstørrelsen. En fullført generering er utgangspunktet for å kontrollere disse visuelle kravene.
Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux-3-image
black-forest-labs/flux-3-image
black-forest-labs/flux-3-imageStart
FLUX 3 Image lager og redigerer bilder fra en skriftlig beskrivelse og opptil ti referanser. Den legger til promptbaserte avgrensningsbokser for komposisjon og lokale endringer, nett- og bildeforankring og fem oppløsningsklasser.
- Godkjente inndata
- Tekst · Bilder
- Resultater
- Bilder
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Bilder POST /v1/images/generations
- Inndatatyper
text,image- Utdatatyper
image
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser black-forest-labs/flux-3-image | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Minste lengde: 1 | Standard— |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 768, 1K, 1.5K, 2K, 4K | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 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 | Standard— |
Feltn | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 1 | Standard— |
Feltinput_references | Typearray | KravValgfritt | Verdier & grenser Minste antall elementer: 0 Maksimalt antall elementer: 10 | Standard— |
Feltprovider | Typeobject | KravValgfritt | Verdier & grenser | Standard— |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parametermaterial_types | Avtaletext, image |
Livssyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktisk returnert task_id eller oppføring i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Kostnad |
|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.082 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Bilder
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
Motta og lagre resultater
Ailoot Ultra · Bilder
Last ned hvert returnerte bilde eller lagre Base64-innholdet
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Andre innholdslesinger
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.
Behold alle ferdige resultater
Lagre hvert ferdige bilde; hent hver returnerte URL eller dekod Base64-innholdet.
Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.
Hvis det opprinnelige svaret må kontrolleres
Bevar returnert X-Client-Request-ID for avstemming. Les bare faktisk returnerte task_id/asset_id-verdier eller egne oppføringer i mediebiblioteket; bygg aldri en oppgave-URL fra operasjons-ID-en, og send aldri opprettelsesforespørselen på nytt.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modellaliaser
Ailoot Ultra black-forest-labs/flux-3-image
Aliaser for metodestier
/v1/images
Tilknyttede anroper-ID-er
FAQ · Black Forest Labs: FLUX.3 Image
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/images/generations·black-forest-labs/flux-3-image:text,image→image- Hvilke felt bruker forespørselen?
POST /v1/images/generations·black-forest-labs/flux-3-image:model,prompt,resolution,aspect_ratio,n,input_references,provider- Hvilke grenser gjelder?
POST /v1/images/generations·black-forest-labs/flux-3-image:n.minimum:1;n.maximum:1