Black Forest Labs: FLUX.2 Flex
FLUX.2 [flex] specialiseert zich in beeldtypografie en kleine visuele details, met instelbare samplingstappen en guidance. Gebruik tekst en afbeeldingsreferenties om posters, productlay-outs of precieze herzieningen te ontwikkelen en daarbij instructietrouw en realisme af te wegen.
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 beeldgeneratie- en bewerkingseditie van Black Forest Labs die gespecialiseerd is in typografie, tekstweergave en behoud van kleine details. Ze gebruikt geschreven scène-instructies en afbeeldingsreferenties om een beeld te produceren. Het kenmerkende bedieningselement is instelbare sampling: het gedocumenteerde profiel stelt zowel inferentiestappen als guidance beschikbaar, zodat je een visuele briefing via instellingen én woorden kan verfijnen.
Letters en fijne details
Een typografietaak begint 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 fietsframe en een kleinere specificatieregel eronder. Het beeld moet het product en de 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 in het algemeen gelijkende scène kan nog altijd een belangrijk teken of onderdeel veranderen, dus vergelijk het gegenereerde detail op de bedoelde weergavegrootte. De specialisatie van het model is een reden om exacte vereisten te geven, geen garantie dat nalezen of visuele inspectie overbodig wordt.
Stappen en guidance dienen verschillende doelen
Het specifieke fabrikantenprofiel accepteert één tot vijftig inferentiestappen, met vijftig als standaard. De beschrijving koppelt meer stappen aan meer detail en realisme. Guidance loopt van 1.5 tot 10, met 5 als standaard. Hogere guidance versterkt het volgen van de prompt, maar kan het realisme verminderen. Een beeld met exacte ontwerpinstructies en een beeld met een beoogd natuurlijk fotografisch uiterlijk kunnen dus verschillende keuzes binnen dat profiel vragen.
Hou formulering, referenties en uitvoerformaat gelijk wanneer je een instellingswijziging vergelijkt. Kijk naar het kenmerk dat aanleiding gaf tot de wijziging: lettervormen, objectplaatsing of materiaaltextuur. Verander een instelling om een specifieke visuele reden, in plaats van een groot getal automatisch als beter te beschouwen. Dit zijn samplinginstellingen van de producent; het gedistilleerde [klein]-profiel met vier stappen en de standaardbediening van [pro] of [max] zijn andere modelkeuzes.
Promptuitbreiding staat in de [flex]-specificatie standaard aan en kan via de eigen instelling prompt_upsampling worden uitgeschakeld. Zo kan de aangeleverde tekst van een gedetailleerde briefing waar passend behouden blijven. De gezamenlijke gids van de fabrikant beveelt aan het hoofdonderwerp en de belangrijke actie vóór secundaire decoratie te plaatsen en beschrijft naast natuurlijke-taalbriefings ook JSON-gestructureerde prompts. Gebruik de structuur waarmee je de vereiste relaties het gemakkelijkst kan vastleggen.
Herzieningen op basis van referenties
Het specifieke aanvraagprofiel bevat acht posities voor referentiebeelden. De interactieve workflow 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 voor een herziening het object en de wijziging en daarna 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 voorste etiket vervangen door de goedgekeurde tekst en de verhoudingen van de doos behouden. Een groepscompositie kan elk onderwerp een afzonderlijke referentie geven en die toewijzingen gelijk houden. De familievoorbeelden omvatten object- en achtergrondwijzigingen, compositing, tekstbewerkingen en stijltransformaties. Vraag één samenhangende herziening met een duidelijk doel en vergelijk daarna zowel het bewerkte gebied als de onderdelen die stabiel moesten blijven.
Formaat, kleur en de teruggestuurde afbeelding
De FLUX.2-gids documenteert een minimum van 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, standaard JPEG. Ze biedt ook een optionele willekeurige seed. Bewaar het daadwerkelijke model, de seed en samplinginstellingen bij de bronreferenties wanneer je versies vergelijkt; alleen een familienaam identificeert 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, dus beschrijf het gewenste uiterlijk positief: scherpe focus, een schone 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 aantal ondersteunde talen te garanderen.
De FLUX.2-procedure van de producent geeft na verwerking een afbeelding terug en gebruikt tijdelijke ondertekende links met tien minuten om het resultaat op te halen. Bewaar de daadwerkelijke afbeelding samen met de briefing. Controleer typografie, fijne details, referentie-identiteit en visuele uitwerking voordat je het beeld in een lay-out plaatst. De uiteindelijke levering kan een gekozen poster, productbeeld of bewerkte compositie zijn waarvan de exacte instellingen voor de volgende herziening bewaard blijven.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations black-forest-labs/flux.2-flex
black-forest-labs/flux.2-flexAan de slag
FLUX.2 [flex] specialiseert zich in beeldtypografie en kleine visuele details, met instelbare samplingstappen en guidance. Gebruik tekst en afbeeldingsreferenties om posters, productlay-outs of precieze herzieningen te ontwikkelen en daarbij instructietrouw en realisme af te wegen.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoer
text,image- Uitvoer
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} · daadwerkelijk teruggegeven task_id of 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 getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen 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 geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor 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 raming is geen extra kost 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 de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de teruggegeven X-Client-Request-ID voor de reconciliatie. Lees uitsluitend daadwerkelijk teruggegeven 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