modeller

Black Forest Labs: FLUX.3 Image

Markdown · JSON

Black Forest Labs: FLUX.3 Image

FLUX 3 Image skaber og redigerer billeder fra en skrevet beskrivelse og op til ti referencer. Den tilføjer promptbaserede afgrænsningsbokse til komposition og lokale ændringer, web- og billedbaseret kildeforankring samt fem opløsningsklasser.

Om modellen

Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.

FLUX 3 Image er Black Forest Labs' model til billedgenerering og redigering med udtrykkelig kontrol over kompositionen. En tekstbeskrivelse kan skabe en ny scene; medsendte billeder kan fastlægge et motiv, en scene, der skal revideres, eller flere elementer, der skal kombineres. Afgrænsningsbokse lader en beskrivelse angive, hvor hvert element hører til, og hvilke dele af et eksisterende billede der skal ændres. Resultatet er et billede med den ønskede scene, tekst og opsætning, som kan kontrolleres.

Skab en scene, eller giv en redigeringsinstruktion

Til et nyt billede skal du beskrive motiv, handling eller positur, omgivelser, lys og indramning. Sæt præcis ordlyd inde i billedet i anførselstegn, og angiv, hvor den skal vises. En original produktbeskrivelse kan vise et rødt campingkrus på en lys stenoverflade med en stor overskrift ovenover og blødt morgenlys, der fremhæver hanken. Definér forholdet mellem overskrift, produkt og baggrund frem for at angive løsrevne stilord.

Ved redigering skal du identificere den bestemte genstand og ændringen: omfarv kruset, udskift en etiket, flyt en figur, eller giv scenen en anden stil. En enkelt redigering kræver ikke en manuelt tegnet boks. Den dokumenterede arbejdsgang udvider instruktionen før generering og kan finde det navngivne element og tilføje en boks automatisk. Den returnerede udvidede prompt registrerer denne fortolkning, hvilket er nyttigt, når en instruktion vælger den forkerte genstand eller indfører en uønsket detalje.

Kombinér og forbered referencebilleder

Den konkrete producentprofil accepterer ét til ti referencebilleder, medsendt som billed-URL'er eller kodede billeddata. Hvert billede skal være mindst 256×256 pixels og højst 16 megapixels. Navngiv en reference efter dens position eller synlige indhold, og forklar derefter dens rolle: personen fra Image 1, jakken fra Image 2 og rummet fra Image 3. En billedreference er en kilde til visuel information, ikke en instruktion om at kopiere hver uvedkommende detalje, den indeholder.

Indstillingen for billedformat har auto som standard. I anmodningsspecifikationen har et format, der ønskes i prompten, forrang; ellers fastlægger den første reference indramningen med kvadratisk output som reservevalg, når hverken en reference eller en ønsket form angiver den. Ved en sammenkomponering skal du placere den ønskede scenereference først eller vælge formatet udtrykkeligt. Gem kildebillederne og deres rækkefølge sammen med resultatet, så en senere revision bruger samme visuelle udgangspunkt.

Placér elementer med afgrænsningsbokse

En layoutprompt kombinerer en beskrivende tekst med et JSON-array af elementrækker. Teksten navngiver et element gennem en markør som <cup_1>; rækken indeholder id, bbox og desc. Koordinater er heltal fra 0 til 1000 i rækkefølgen [top, left, bottom, right], målt fra øverste venstre hjørne. For eksempel beskriver [0, 0, 500, 500] den øverste venstre fjerdedel uanset billedets pixeldimensioner. Brug det billedformat, som layoutet er udformet til, fordi koordinatgitteret strækkes med rammen.

En redigeringsrække bruger i stedet from, src_bbox og tgt_bbox sammen med identifikatoren og beskrivelsen. ref_image_0 betyder det første medsendte billede. Ens kilde- og målbokse forankrer et element; forskellige bokse flytter det eller ændrer dets størrelse. En ny række uden kilde genererer sin beskrivelse på målplaceringen, hvilket muliggør tilføjelser, udskiftninger eller omfarvning. En kilderække uden mål fjerner elementet. Angiv tilføjelser og fjernelser i både den skrevne instruktion og rækkerne, og behold forankringsrækker til detaljer, der skal blive på plads.

Giv tekst sin egen boks, og citér den præcise ordlyd i desc. Bokse styrer placering og størrelse; de er ikke beskæringsmasker, så et element kan strække sig ud over rektanglet. Producenten oplyser, at nye genstande i bokse på omkring 40×25 pixels ofte ikke kom frem i dens eksempler. Giv tilstrækkelig synlig plads, og undersøg de redigerede grænser. Pixels uden for målområdet forbliver som regel stabile, men skygger, refleksioner og nærliggende belysning kan stadig ændre sig.

Kildeforankring, outputklasser og nyttig dokumentation

Den dokumenterede profil aktiverer kildeforankring som standard, så web- og billedsøgning kan bidrage til genereringen. Det kan slås fra ved en beskrivelse, der kun skal bruge sin medsendte tekst og referencer. Ved et motiv fra virkeligheden skal du identificere sted, begivenhed eller genstand tydeligt og holde faktuelt indhold adskilt fra kunstnerisk behandling. Billeder med information fra søgning skal stadig sammenlignes med autoritativt materiale, når en etiket, genstand eller afbildet begivenhed skal være korrekt.

De fem opløsningsklasser er 768sq, 1k, 1.5k, 2k og 4k med 1k som standard. De repræsenterer niveauer med samme pixelareal, så den præcise bredde og højde afhænger af det valgte billedformat. Femten faste billedformater spænder fra 21:9 gennem kvadratiske og stående formater til 9:21. Denne models profil styrer størrelsen gennem billedformat og opløsning; den giver ikke adgang til felterne seed, width eller height, som bruges i FLUX.2-anmodningsprofilerne. Dens dokumenterede versionsvælger angiver aktuelt en løbende udgivelse frem for at fastlægge et dateret match med leverandørens vægte.

Producentens arbejdsgang returnerer et billede efter asynkron behandling sammen med den udvidede prompt. Det signerede downloadlink til billedet er gyldigt i én time. Gem selve billedet, den endelige prompt og referencerne frem for at stole på et midlertidigt link. Ved et gennemgået visuelt materiale skal du sammenligne den ønskede tekst, genstandsplacering, referenceidentitet og det ændrede område i den tilsigtede visningsstørrelse. En afsluttet generering er udgangspunktet for at kontrollere disse visuelle krav.

Ailoot Ultra · Billeder 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 skaber og redigerer billeder fra en skrevet beskrivelse og op til ti referencer. Den tilføjer promptbaserede afgrænsningsbokse til komposition og lokale ændringer, web- og billedbaseret kildeforankring samt fem opløsningsklasser.

Accepterede input
Tekst · Billeder
Resultater
Billeder

Tilgængelig i Ailoot · input og metoder

Ailoot Ultra · Billeder POST /v1/images/generations
Inputtyper
text, image
Outputtyper
image
FeltTypeKravVærdier og grænserStandard
FeltmodelTypestringKravPåkrævetVærdier og grænser
black-forest-labs/flux-3-image
Standard—
FeltpromptTypestringKravPåkrævetVærdier og grænser
Minimumslængde: 1
Standard—
FeltresolutionTypestringKravValgfritVærdier og grænser
768, 1K, 1.5K, 2K, 4K
Standard—
Feltaspect_ratioTypestringKravValgfritVærdier og grænser
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—
FeltnTypeintegerKravValgfritVærdier og grænser
Minimum: 1
Maksimum: 1
Standard—
Feltinput_referencesTypearrayKravValgfritVærdier og grænser
Minimumsantal elementer: 0
Maksimalt antal elementer: 10
Standard—
FeltproviderTypeobjectKravValgfritVærdier og grænserStandard—
Metodeparametre og livscyklus
ParameterKontrakt
Parametercontent_typeKontraktapplication/json
ParameterrequiredKontraktmodel, prompt
Parametermaterial_typesKontrakttext, image

Livscyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Priser

Sådan beregnes det endelige beløb

De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.

Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.

Hurtig tilstand
Ikke angivet Når hurtig tilstand er valgt
flex-tilstand
Ikke angivet Når flex-tilstanden er valgt
Maksimal ræsonneringsindsats
Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats

Estimerede takster til sammenligning

Priser efter konfiguration

Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.

KonfigurationTakstplanForventet mængdeBeløb
KonfigurationGrundpriser for tokensTakstplanGrundtakstForventet mængde—Beløb
Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens
Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens
Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens
Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens
Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens
KonfigurationAnslået genereringsomkostningTakstplan—Forventet mængdeestimat for én genereringBeløb
Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.082 estimat før generering

Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering.

Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →

Eksempelanmodninger

Ailoot Ultra · Billeder

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

Hent og gem resultater

Ailoot Ultra · Billeder

Hent hvert returneret billede, eller gem dets Base64-indhold

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Læsning af andet indhold
Hent eksisterende filer, du ejer
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 færdige resultater

Gem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.

Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.

Hvis det oprindelige svar skal kontrolleres

Gem det returnerede X-Client-Request-ID til afstemning. Brug kun faktisk returnerede task_id/asset_id-værdier eller dit eget mediebibliotek til læseanmodninger; opbyg aldrig en opgave-URL ud fra operations-ID’et, og send aldrig oprettelsesanmodningen igen.

Svarfelter
FeltType
FeltcreatedType
Feltdata[].urlType
Feltdata[].b64_jsonType
FeltusageType

Aliaser

Modelaliaser

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

Aliaser for metodestier

/v1/images

Relaterede kalder-ID’er

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image
Hvilke input og resultater er tilgængelige?

POST /v1/images/generations · black-forest-labs/flux-3-image: text, image → image

Hvilke felter bruger anmodningen?

POST /v1/images/generations · black-forest-labs/flux-3-image: model, prompt, resolution, aspect_ratio, n, input_references, provider

Hvilke grænser gælder?

POST /v1/images/generations · black-forest-labs/flux-3-image: n.minimum: 1; n.maximum: 1

Flere oplysninger

Tilslut Ailoot til Claude Code, OpenCode, Hermes eller din egen applikation.

Virksomheden og dens projektportefølje

Virksomheden og dens projektportefølje: millioner af kunder; månedligt salg for milliarder.

Køb tokens med rabat.

Abonnementsrabat til regelmæssigt arbejde. Rabatkoder giver op til 50% på tokenkøb.

Abonnement
Vælg et abonnement med rabat til dine regelmæssige anmodninger.
Rabatkode på op til 50%
Indtast koden ved købet. Prisen genberegnes efter den aktuelle kampagne.
Udgifter i historikken
Model, tokens og beløb gemmes for hver anmodning.

Vælg abonnement · Se modelpriser

Tilslut API’et til produktet, du sælger.

SaaS, apps og bots efter Ailoots tilbudsvilkår og licensaftale. Anmod om en forhandlerlicens til videresalg.

Kommerciel applikation
Byg generering af tekst, billeder, video og lyd ind i tjenestens betalte funktioner.
Licens til forhandlere
Send projektbeskrivelse og adgangsmodel. Bed om skriftlige vilkår for anvendelse og videresalg.
Dokumenter på websitet
Tilbudsvilkår, licensaftale og politik for behandling af data kan læses før tilslutning.

Anmod om forhandlerlicens · Tilbudsvilkår og licensaftale