modeller

Black Forest Labs: FLUX.3 Image

Markdown · JSON

Black Forest Labs: FLUX.3 Image

FLUX 3 Image skapar och redigerar bilder från en skriven instruktion och upp till tio referenser. Den lägger till promptbaserade begränsningsrutor för komposition och lokala ändringar, webb- och bildförankring samt fem upplösningsklasser.

Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

FLUX 3 Image är Black Forest Labs modell för bildgenerering och redigering med uttrycklig kontroll över kompositionen. En textbeskrivning kan skapa en ny scen; inskickade bilder kan fastställa ett motiv, en scen att bearbeta eller flera element att kombinera. Begränsningsrutor låter instruktionen ange var varje element hör hemma och vilka delar av en befintlig bild som ska ändras. Resultatet är en bild där begärd scen, text och layout kan granskas.

Skapa en scen eller ge en redigeringsinstruktion

För en ny bild beskriver du motiv, handling eller pose, miljö, ljus och utsnitt. Sätt exakt ordalydelse i bilden inom citattecken och ange var den visas. En egen produktinstruktion kan visa en röd campingmugg på en ljus stenyta, med en stor rubrik ovanför och mjukt morgonljus som framhäver handtaget. Definiera relationen mellan rubrik, produkt och bakgrund i stället för att ange orelaterade stilord.

För redigering identifierar du det specifika föremålet och ändringen: färga om muggen, ersätt en etikett, flytta en figur eller ändra scenens stil. En enda redigering kräver ingen manuellt ritad ruta. Det dokumenterade flödet utökar instruktionen före generering och kan lokalisera det namngivna elementet och lägga till en ruta automatiskt. Den returnerade utökade prompten registrerar tolkningen, vilket är användbart när en instruktion väljer fel föremål eller tillför en oönskad detalj.

Kombinera och förbered referensbilder

Tillverkarens specifika profil tar emot en till tio referenser som bild-URL:er eller kodade bilddata. Var och en måste vara minst 256×256 pixlar och högst 16 megapixlar. Namnge en referens genom dess position eller synliga innehåll och förklara sedan dess roll: personen från Image 1, jackan från Image 2 och rummet från Image 3. En bildreferens är en källa till visuell information, inte en instruktion att kopiera varje orelaterad detalj i den.

Inställningen för bildförhållande har auto som standard. I förfrågningsspecifikationen prioriteras ett förhållande som begärs i prompten; annars fastställer första referensen utsnittet, med kvadratiska utdata som reserv när varken en referens eller begärd form anger det. För en komposition placerar du avsedd scenreferens först eller väljer förhållandet uttryckligen. Behåll källbilderna och deras ordning med resultatet så att en senare revidering använder samma visuella utgångspunkt.

Placera element med begränsningsrutor

En layoutprompt kombinerar en bildtext med en JSON-array av elementrader. Bildtexten namnger ett element genom en markör som <cup_1>; raden innehåller id, bbox och desc. Koordinaterna är heltal från 0 till 1000 i ordningen [top, left, bottom, right], mätta från det övre vänstra hörnet. Exempelvis beskriver [0, 0, 500, 500] den övre vänstra fjärdedelen oberoende av bildens pixeldimensioner. Använd bildförhållandet som layouten utformats för, eftersom koordinatrutnätet sträcks med ramen.

En redigeringsrad använder i stället from, src_bbox och tgt_bbox tillsammans med identifierare och beskrivning. ref_image_0 betyder den första inskickade bilden. Matchande käll- och målrutor förankrar ett element; olika rutor flyttar eller ändrar storlek på det. En ny rad utan källa genererar sin beskrivning på målplatsen och möjliggör tillägg, ersättningar eller omfärgning. En källrad utan mål tar bort elementet. Ange tillägg och borttagningar i både den skrivna instruktionen och raderna, och behåll förankringsrader för detaljer som måste stanna på plats.

Ge text en egen ruta och citera dess exakta ordalydelse i desc. Rutorna styr placering och skala; de är inte urklippsmasker, så ett element kan sträcka sig utanför rektangeln. Tillverkaren rapporterar att nya föremål i rutor runt 40×25 pixlar ofta inte visades i dess exempel. Ge tillräckligt synligt utrymme och granska de redigerade gränserna. Pixlar utanför målet brukar förbli stabila, men skuggor, reflexer och närliggande belysning kan fortfarande ändras.

Informationsförankring, utdataklasser och användbara underlag

Den dokumenterade profilen aktiverar informationsförankring som standard, så att webb- och bildsökning kan informera genereringen. Den kan inaktiveras för en instruktion som enbart ska använda sin inskickade beskrivning och referenser. För ett verkligt motiv identifierar du platsen, händelsen eller föremålet tydligt och håller faktainnehåll separat från konstnärlig behandling. Sökinformerade bilder behöver fortfarande jämföras med auktoritativt material när en etikett, ett föremål eller en avbildad händelse måste vara korrekt.

De fem upplösningsklasserna är 768sq, 1k, 1.5k, 2k och 4k, med 1k som standard. De representerar nivåer med samma pixelarea, så exakt bredd och höjd beror på valt förhållande. Femton fasta förhållanden går från 21:9 via kvadratiska och stående format till 9:21. Modellprofilen styr storleken genom förhållande och upplösning; den exponerar inte fälten seed, width eller height som används i förfrågningsprofilerna för FLUX.2. Dess dokumenterade versionsväljare namnger för närvarande en rörlig utgåva i stället för att fastställa en daterad matchning av leverantörsvikter.

Tillverkarflödet returnerar en bild efter asynkron bearbetning tillsammans med den utökade prompten. Dess signerade bildnedladdningslänk gäller i en timme. Bevara själva bilden, den slutliga prompten och referenserna i stället för att förlita dig på en tillfällig länk. För ett granskat material jämför du begärd text, objektplacering, referensidentitet och ändrat område i avsedd visningsstorlek. En färdig generering är utgångspunkten för att kontrollera dessa visuella krav.

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 skapar och redigerar bilder från en skriven instruktion och upp till tio referenser. Den lägger till promptbaserade begränsningsrutor för komposition och lokala ändringar, webb- och bildförankring samt fem upplösningsklasser.

Godkända indata
Text · Bilder
Resultat
Bilder

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Bilder POST /v1/images/generations
Indatatyper
text, image
Utdatatyper
image
FältTypKravVärden & gränserStandard
FältmodelTypstringKravObligatorisktVärden & gränser
black-forest-labs/flux-3-image
Standard—
FältpromptTypstringKravObligatorisktVärden & gränser
Minsta längd: 1
Standard—
FältresolutionTypstringKravValfrittVärden & gränser
768, 1K, 1.5K, 2K, 4K
Standard—
Fältaspect_ratioTypstringKravValfrittVärden & 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—
FältnTypintegerKravValfrittVärden & gränser
Minimum: 1
Maximum: 1
Standard—
Fältinput_referencesTyparrayKravValfrittVärden & gränser
Minsta antal objekt: 0
Maximalt antal objekt: 10
Standard—
FältproviderTypobjectKravValfrittVärden & gränserStandard—
Metodparametrar och livscykel
ParameterAvtal
Parametercontent_typeAvtalapplication/json
ParameterrequiredAvtalmodel, prompt
Parametermaterial_typesAvtaltext, image

Livscykel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Priser

Så beräknas slutavgiften

De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge
Ej angivet När snabbt läge är valt
Flex-läge
Ej angivet När läget flex är valt
Högsta resonemangsnivå
Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Uppskattade priser för jämförelse

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

KonfigurationPrislistaPrognostiserad mängdAvgift
KonfigurationGrundpriser för tokenPrislistaGrundprisPrognostiserad mängd—Avgift
Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token
Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token
Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token
Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token
Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token
KonfigurationUppskattad genereringskostnadPrislista—Prognostiserad mängduppskattning för en genereringAvgift
Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.082 uppskattning före generering

Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Exempelbegäranden

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

Ta emot och spara resultat

Ailoot Ultra · Bilder

Ladda ned varje returnerad bild eller spara dess Base64-innehåll

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Andra innehållsläsningar
Läs befintliga resurser som tillhör dig
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.
Behåll alla färdiga resultat

Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.

Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.

Om det ursprungliga svaret behöver kontrolleras

Behåll det returnerade värdet för X-Client-Request-ID för avstämning. Läs endast av resultat via de task_id/asset_id-värden som faktiskt returnerades eller via det mediebibliotek som tillhör dig. Bygg aldrig en uppgifts-URL från operations-ID:t och skicka aldrig skapandeförfrågan igen.

Svarsfält
FältTyp
FältcreatedTyp
Fältdata[].urlTyp
Fältdata[].b64_jsonTyp
FältusageTyp

Alias

Modellalias

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

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image
Vilka indata och resultat finns?

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

Vilka fält använder begäran?

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

Vilka gränser gäller?

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

Fler detaljer

Anslut Ailoot till Claude Code, OpenCode, Hermes eller din app.

Företaget och dess projektportfölj

Företaget och dess projektportfölj: miljontals kunder; månatlig försäljning för miljarder.

Köp token med rabatt.

Prenumerationsrabatt för återkommande arbete. Kampanjkoder ger upp till 50% vid tokenköp.

Prenumeration
Välj en rabatterad plan för återkommande anrop.
Kampanjkod upp till 50%
Ange koden vid köpet. Priset räknas om enligt kampanjen.
Kostnader i historiken
Modell, token och belopp sparas för varje anrop.

Välj prenumeration · Se modellpriser

Anslut API till produkten som du säljer.

SaaS, appar och botar enligt Ailoots officiella villkor och licensavtal. Begär återförsäljarlicens för vidareförsäljning.

Kommersiell applikation
Bygg text-, bild-, video- och ljudgenerering i tjänstens betalda funktioner.
Återförsäljarlicens
Skicka projektbeskrivning och åtkomstupplägg. Begär skriftliga villkor för användning och vidareförsäljning.
Dokument på webbplatsen
Officiella villkor, licensavtal och databehandlingspolicy finns tillgängliga före anslutning.

Begär återförsäljarlicens · Officiella villkor och licensavtal