Black Forest Labs: FLUX.2 Flex
FLUX.2 [flex] specialiserar sig på typografi i bilder och små visuella detaljer, med justerbara samplingssteg och guidance. Använd text och bildreferenser för att utveckla affischer, produktlayouter eller precisa revideringar med en balans mellan följsamhet och realism.
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.2 [flex] är Black Forest Labs utgåva för bildgenerering och redigering med specialisering på typografi, textrendering och bevarande av små detaljer. Den använder skrivna sceninstruktioner och bildreferenser för att producera en bild. Dess utmärkande kontroll är justerbar sampling: den dokumenterade profilen exponerar både inferenssteg och guidance, så att en visuell instruktion kan förfinas genom inställningar och ord.
Bokstäver och fina detaljer
En typografiuppgift bör börja med den faktiska texten. Citera varje rad, ange var den hör hemma och skilj mellan rubrik, stödtext och etikett. Beskriv bokstavsstil, skala och färg i relation till scenen. En egen affischinstruktion kan visa en koboltblå cykel i en ljus studio, med en stor titel ovanför ramen och en mindre specifikationsrad under den. Bilden måste göra både produkten och läsordningen tydliga.
För en detaljerad produktbild identifierar du delarna som avgör om resultatet är användbart: en urtavla, kontrolletikett, söm, materialkant eller förpackningsmärkning. Skicka in en läsbar referens och förklara vilken egenskap den fastställer. En scen som liknar originalet i stort kan ändå ändra ett avgörande tecken eller en komponent, så jämför den genererade detaljen i avsedd visningsstorlek. Modellens specialisering är ett skäl att ge exakta krav, inte en garanti för att korrekturläsning eller visuell granskning blir överflödig.
Steg och guidance har olika syften
Tillverkarens specifika profil accepterar ett till femtio inferenssteg, med femtio som standard. Beskrivningen kopplar fler steg till större detaljrikedom och realism. Guidance går från 1,5 till 10, med standardvärdet 5. Högre guidance stärker följsamheten mot prompten men kan minska realismen. En bild med exakta designinstruktioner och en som eftersträvar naturligt fotografiskt utseende kan därför kräva olika val inom profilen.
Håll ordalydelse, referenser och utdataform konstanta när du jämför en inställningsändring. Titta på egenskapen som motiverade ändringen: bokstavsformer, objektplacering eller materialtextur. Ändra en inställning av ett specifikt visuellt skäl i stället för att automatiskt behandla ett stort tal som bättre. Detta är tillverkarens samplingskontroller; den destillerade fyrstegsprofilen [klein] och standardkontrollerna i [pro] eller [max] är andra modellval.
Promptutökning är aktiverad som standard i specifikationen för [flex] och kan inaktiveras genom dess egen kontroll prompt_upsampling. Detta låter en detaljerad instruktion förbli den inskickade texten när det är lämpligt. Tillverkarens gemensamma guide rekommenderar att huvudmotivet och viktig handling placeras före sekundär dekoration och beskriver JSON-strukturerade prompter jämte instruktioner på naturligt språk. Använd strukturen som gör de nödvändiga relationerna lättast att ange.
Referensstyrda revideringar
Den specifika förfrågningsprofilen innehåller åtta referensbildspositioner. Tillverkarens interaktiva arbetsflöde tillåter separat upp till tio bilder; antalen beskriver olika gränssnitt. Definiera om en bild ger scenen att redigera, en produkt, en karaktär, kläder eller en stil. För en revidering identifierar du föremålet och ändringen och anger sedan omgivande komposition, material eller ljus som ska bevaras.
En egen förpackningsuppgift kan använda kartongen från första bilden och ytfinishen från en andra, ersätta frontetiketten med godkänd ordalydelse och bevara kartongens proportioner. En gruppkomposition kan ge varje motiv en egen referens och hålla dessa kopplingar konsekventa. Familjens exempel omfattar objekt- och bakgrundsändringar, kompositioner, textredigeringar och stilomvandlingar. Begär en sammanhängande revidering med tydligt mål och jämför sedan både det redigerade området och delarna som skulle förbli stabila.
Storlek, färg och den returnerade bilden
FLUX.2-guiden dokumenterar minst 64×64 pixlar, dimensioner i multiplar av 16 och utdata på upp till 4 megapixlar, med upp till 2 megapixlar rekommenderat för vanlig användning. Den specifika [flex]-specifikationen listar JPEG, PNG och WebP som utdata med JPEG som standard. Den erbjuder även ett valfritt slumpseed. Behåll faktisk modell, seed och samplingsinställningar med källreferenserna när versioner jämförs; ett familjenamn ensamt identifierar inte hela genereringskonfigurationen.
För färgkänsligt arbete kopplar du varje hexkod till ett namngivet föremål eller textelement. För komposition anger du avsett bildförhållande genom bilddimensionerna och lämnar tillräckligt utrymme för läsbara bokstäver. Den gemensamma guiden saknar en mekanism för negativa prompter, så beskriv önskat utseende positivt: skarpt fokus, ren bakgrund eller ett tydligt tomt område för text. Dess flerspråkiga exempel stöder en kulturellt specifik instruktion på lämpligt språk utan att fastställa en garanti för ett visst antal språk.
Tillverkarens FLUX.2-flöde returnerar en bild efter bearbetning och använder tillfälliga signerade länkar med tio minuter för hämtning. Bevara själva bilden och instruktionen tillsammans. Kontrollera typografi, fina detaljer, referensidentitet och visuell behandling innan materialet placeras i en layout. Slutleveransen kan vara en vald affisch, produktbild eller redigerad komposition vars exakta inställningar sparas inför nästa revidering.
Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux.2-flex
black-forest-labs/flux.2-flexStart
FLUX.2 [flex] specialiserar sig på typografi i bilder och små visuella detaljer, med justerbara samplingssteg och guidance. Använd text och bildreferenser för att utveckla affischer, produktlayouter eller precisa revideringar med en balans mellan följsamhet och realism.
- 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.2-flex | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standard— |
Fältoutput_format | Typstring | KravValfritt | Värden & gränser png, jpeg | 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: 8 | 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 | Debiteringsenhet | Avgift |
|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Debiteringsenhet— | 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 |
| Konfigurationmegapixel i indatabild | Prislista— | Prognostiserad mängd— | Debiteringsenhetper megapixel indatabild | Avgift Indata · megapixel i indatabild · Uppskattning endast för jämförelse $0.12 per megapixel indatabild |
| Konfigurationmegapixel i utdatabild | Prislista— | Prognostiserad mängd— | Debiteringsenhetper megapixel utdatabild | Avgift Utdata · megapixel i utdatabild · Uppskattning endast för jämförelse $0.12 per megapixel utdatabild |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.12 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.2-flex', '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.2-flex
Alias för metodsökvägar
/v1/images
Relaterade anropar-ID:n
FAQ · Black Forest Labs: FLUX.2 Flex
- Vilka indata och resultat finns?
POST /v1/images/generations·black-forest-labs/flux.2-flex:text,image→image- Vilka fält använder begäran?
POST /v1/images/generations·black-forest-labs/flux.2-flex:model,prompt,aspect_ratio,output_format,n,input_references,provider- Vilka gränser gäller?
POST /v1/images/generations·black-forest-labs/flux.2-flex:n.minimum:1;n.maximum:1