Black Forest Labs: FLUX.2 Flex
FLUX.2 [flex] is gespecialiseerd in afbeeldingstypografie en kleine visuele details, met instelbare samplingstappen en guidance. Gebruik tekst en afbeeldingsreferenties om posters, productlay-outs of precieze revisies te ontwikkelen, met een afweging tussen instructietrouw en realisme.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
FLUX.2 [flex] is de editie van Black Forest Labs voor afbeeldingsgeneratie en -bewerking die is gespecialiseerd in typografie, tekstweergave en behoud van kleine details. Het gebruikt geschreven scène-instructies en afbeeldingsreferenties om een afbeelding te produceren. De kenmerkende instelling is instelbare sampling: het gedocumenteerde profiel stelt zowel inferentiestappen als guidance beschikbaar, zodat een visuele briefing met instellingen én woorden kan worden verfijnd.
Letters en fijne details
Een typografietaak moet beginnen met de daadwerkelijke tekst. Citeer elke regel, bepaal waar die hoort en onderscheid kop, ondersteunende tekst en label. Beschrijf letterstijl, schaal en kleur in relatie tot de scène. Een oorspronkelijke posterbriefing kan een kobaltblauwe fiets in een lichte studio tonen, met een grote titel boven het frame en een kleinere specificatieregel eronder. De afbeelding moet product en leesvolgorde samen duidelijk maken.
Benoem voor een gedetailleerd productbeeld de onderdelen die bepalen of het resultaat bruikbaar is: een wijzerplaat, bedieningslabel, naad, materiaalrand of verpakkingsmarkering. Lever een leesbare referentie aan en leg uit welk kenmerk die vastlegt. Een scène die in grote lijnen vergelijkbaar oogt, kan toch een essentieel teken of onderdeel veranderen; vergelijk daarom het gegenereerde detail op het beoogde weergaveformaat. De specialisatie van het model is een reden om exacte eisen te geven en geen garantie dat proeflezen of visuele inspectie overbodig wordt.
Stappen en guidance hebben verschillende doelen
Het specifieke fabrikantprofiel accepteert één tot vijftig inferentiestappen, met standaard vijftig. De beschrijving verbindt meer stappen aan meer detail en realisme. Guidance loopt van 1,5 tot 10, met standaard 5. Hogere guidance versterkt het volgen van de prompt, maar kan het realisme verminderen. Een afbeelding met exacte ontwerpinstructies en een afbeelding die een natuurlijk fotografisch uiterlijk beoogt, kunnen daarom verschillende keuzes binnen dat profiel vereisen.
Houd formulering, referenties en uitvoervorm gelijk wanneer je een gewijzigde instelling vergelijkt. Kijk naar het kenmerk dat de aanleiding vormde: lettervormen, objectplaatsing of materiaaltextuur. Verander een instelling om een specifieke visuele reden in plaats van een hoog getal automatisch als beter te behandelen. Dit zijn samplinginstellingen van de producent; het gedistilleerde [klein]-profiel met vier stappen en de standaardinstellingen van [pro] of [max] zijn andere modelkeuzes.
Prompt upsampling is in de [flex]-specificatie standaard ingeschakeld en kan via de eigen instelling prompt_upsampling worden uitgeschakeld. Daardoor kan een gedetailleerde briefing waar passend de aangeleverde tekst blijven. De gezamenlijke gids van de fabrikant beveelt aan het hoofdonderwerp en de belangrijke handeling vóór bijkomende decoratie te plaatsen en beschrijft JSON-prompts naast briefings in natuurlijke taal. Gebruik de structuur waarmee de vereiste relaties het gemakkelijkst te specificeren zijn.
Revisies vanuit referenties
Het specifieke aanvraagprofiel bevat acht posities voor referentieafbeeldingen. De interactieve procedure van de maker staat afzonderlijk maximaal tien afbeeldingen toe; die aantallen beschrijven verschillende interfaces. Bepaal of een afbeelding de te bewerken scène, een product, een personage, kleding of een stijl levert. Benoem bij een revisie het object en de wijziging en vervolgens de omringende compositie, materialen of belichting die moeten blijven.
Een oorspronkelijke verpakkingstaak kan de doos uit de eerste afbeelding en de afwerking uit een tweede gebruiken, het etiket aan de voorkant vervangen door goedgekeurde tekst en de verhoudingen van de doos behouden. Een groepscompositie kan aan elk onderwerp een afzonderlijke referentie toewijzen en die toewijzingen consistent houden. De familievoorbeelden behandelen wijzigingen van object en achtergrond, compositing, tekstbewerking en stijltransformaties. Vraag om één samenhangende revisie met een duidelijk doel en vergelijk daarna zowel het bewerkte gebied als de delen die stabiel moeten blijven.
Formaat, kleur en de geretourneerde afbeelding
De FLUX.2-gids documenteert minimaal 64×64 pixels, afmetingen in veelvouden van 16 en uitvoer tot 4 megapixels, met maximaal 2 megapixels aanbevolen voor gewoon gebruik. De specifieke [flex]-specificatie vermeldt JPEG-, PNG- en WebP-uitvoer, met standaard JPEG. Ook is er een optionele willekeurige seed. Bewaar het daadwerkelijke model, de seed en samplinginstellingen bij de bronreferenties wanneer je versies vergelijkt; alleen een familienaam bepaalt niet de volledige generatieconfiguratie.
Koppel voor kleurgevoelig werk elke hexcode aan een benoemd object of tekstelement. Specificeer voor de compositie de gewenste beeldverhouding via de afbeeldingsafmetingen en laat voldoende ruimte voor leesbare letters. De gezamenlijke gids heeft geen mechanisme voor negatieve prompts; beschrijf het gewenste uiterlijk dus positief: scherpe focus, een rustige achtergrond of een duidelijk lege zone voor tekst. De meertalige voorbeelden ondersteunen het schrijven van een cultureel specifieke briefing in de passende taal zonder een vast gegarandeerd aantal talen vast te leggen.
De FLUX.2-procedure van de producent retourneert na verwerking een afbeelding en gebruikt tijdelijke ondertekende links met tien minuten om het resultaat op te halen. Bewaar de daadwerkelijke afbeelding en briefing samen. Controleer typografie, fijne details, referentie-identiteit en visuele behandeling voordat je het beeld in een lay-out plaatst. Het uiteindelijke resultaat kan een gekozen poster, productafbeelding of bewerkte compositie zijn, met de exacte instellingen bewaard voor de volgende revisie.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations black-forest-labs/flux.2-flex
black-forest-labs/flux.2-flexAan de slag
FLUX.2 [flex] is gespecialiseerd in afbeeldingstypografie en kleine visuele details, met instelbare samplingstappen en guidance. Gebruik tekst en afbeeldingsreferenties om posters, productlay-outs of precieze revisies te ontwikkelen, met een afweging tussen instructietrouw en realisme.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoertypen
text,image- Uitvoertypen
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten black-forest-labs/flux.2-flex | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standaard— |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten png, jpeg | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 8 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| Configuratiemegapixel van een invoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper megapixel van de invoerafbeelding | Kosten Invoer · megapixel van een invoerafbeelding · Schatting uitsluitend ter vergelijking $0.12 per megapixel van de invoerafbeelding |
| Configuratiemegapixel van een uitvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper megapixel van de uitvoerafbeelding | Kosten Uitvoer · megapixel van een uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.12 per megapixel van de uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.12 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Afbeeldingen
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
Resultaten ophalen en opslaan
Ailoot Ultra · Afbeeldingen
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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.
Alle voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra black-forest-labs/flux.2-flex
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Black Forest Labs: FLUX.2 Flex
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·black-forest-labs/flux.2-flex:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·black-forest-labs/flux.2-flex:model,prompt,aspect_ratio,output_format,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·black-forest-labs/flux.2-flex:n.minimum:1;n.maximum:1