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/flux-3-imageStart
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ält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser black-forest-labs/flux-3-image | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältresolution | Typstring | KravValfritt | Värden & gränser 768, 1K, 1.5K, 2K, 4K | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Vä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ältn | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 1 | Standard— |
Fältinput_references | Typarray | KravValfritt | Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 10 | Standard— |
Fältprovider | Typobject | KravValfritt | Värden & gränser | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parametermaterial_types | Avtaltext, 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.
| Konfiguration | Prislista | Prognostiserad mängd | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad 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 genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Avgift 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
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Andra innehållsläsningar
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ält | Typ |
|---|---|
Fältcreated | Typ |
Fältdata[].url | Typ |
Fältdata[].b64_json | Typ |
Fältusage | Typ |
Alias
Modellalias
Ailoot Ultra black-forest-labs/flux-3-image
Alias för metodsökvägar
/v1/images
Relaterade anropar-ID:n
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