modeller

Black Forest Labs: FLUX.3 Image

Markdown · JSON

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 /black-forest-labs/flux-3-image

Start

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
FeltTypeKravVerdier & grenserStandard
FeltmodelTypestringKravPåkrevdVerdier & grenser
black-forest-labs/flux-3-image
Standard—
FeltpromptTypestringKravPåkrevdVerdier & grenser
Minste lengde: 1
Standard—
FeltresolutionTypestringKravValgfrittVerdier & grenser
768, 1K, 1.5K, 2K, 4K
Standard—
Feltaspect_ratioTypestringKravValgfrittVerdier & 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—
FeltnTypeintegerKravValgfrittVerdier & grenser
Minimum: 1
Maksimum: 1
Standard—
Feltinput_referencesTypearrayKravValgfrittVerdier & grenser
Minste antall elementer: 0
Maksimalt antall elementer: 10
Standard—
FeltproviderTypeobjectKravValgfrittVerdier & grenserStandard—
Metodeparametere og livssyklus
ParameterAvtale
Parametercontent_typeAvtaleapplication/json
ParameterrequiredAvtalemodel, prompt
Parametermaterial_typesAvtaletext, 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.

KonfigurasjonPrisplanForventet mengdeKostnad
KonfigurasjonGrunnpriser for tokenerPrisplanGrunnsatsForventet 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 genereringskostnadPrisplan—Forventet mengdeestimat for én genereringKostnad
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

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

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}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Andre innholdslesinger
Les eksisterende ressurser som tilhører deg
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
FeltType
FeltcreatedType
Feltdata[].urlType
Feltdata[].b64_jsonType
FeltusageType

Aliaser

Modellaliaser

Ailoot Ultra black-forest-labs/flux-3-image

Aliaser for metodestier

/v1/images

Tilknyttede anroper-ID-er

black-forest-labs/flux-3-image

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

Flere detaljer

Koble Ailoot til Claude Code, OpenCode, Hermes eller egen applikasjon.

Selskapet og dets prosjektportefølje

Selskapet og dets prosjektportefølje: millioner av kunder; månedlig salg for milliarder.

Kjøp tokener med rabatt.

Abonnementsrabatt for jevnlig bruk. Kampanjekoder gir opptil 50% på tokenkjøp.

Abonnement
Velg et rabattabonnement for faste forespørsler.
Kampanjekode opptil 50%
Oppgi kode ved kjøp. Prisen beregnes på nytt etter gjeldende kampanje.
Kostnader i historikken
Modell, tokener og beløp lagres for hver forespørsel.

Velg abonnement · Se modellpriser

Koble API-et til produktet du selger.

SaaS, apper og boter etter Ailoots offentlige tilbud og lisensavtale. Be om forhandlerlisens for videresalg.

Kommersiell applikasjon
Bygg tekst-, bilde-, video- og lydgenerering inn i betalte funksjoner i tjenesten.
Forhandlerlisens
Send prosjektbeskrivelse og tilgangsopplegg. Be om skriftlige vilkår for bruk og videresalg.
Dokumenter på nettstedet
Offentlig tilbud, lisensavtale og retningslinjer for databehandling er tilgjengelige før tilkobling.

Be om forhandlerlisens · Offentlig tilbud og lisensavtale