Black Forest Labs: FLUX.2 Pro
FLUX.2 [pro] is het productiebeeldmodel van Black Forest Labs voor creatie vanuit tekst en bewerking met referenties. Het gedocumenteerde profiel combineert fotorealistische details, tekst- en kleurcontrole met een pixelbudget voor referenties en uitvoer en afbeeldingen tot 4 megapixels.
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 [pro] is het op productie gerichte model van Black Forest Labs voor beeldgeneratie en -bewerking. De fabrikant presenteert het als de standaardkeuze voor de meeste visuele FLUX.2-taken: maak een nieuwe afbeelding vanuit tekst of herwerk een scène met visuele referenties. De mogelijkheden van de familie omvatten fotorealistische materialen en belichting, leesbare tekst, instructies voor exacte kleuren en consistente onderwerpen bij verwante bewerkingen. Het teruggestuurde resultaat is een afbeelding voor een productscène, redactionele compositie, ontwerpconcept of visuele communicatie.
Bereid een productiebriefing voor
Begin met het onderwerp, wat het doet of hoe het is opgesteld, de stijl en de omgeving of belichting. De promptgids van de fabrikant geeft meer gewicht aan woorden aan het begin en beveelt aan het essentiële onderwerp en de actie vóór decoratieve details te plaatsen. Hij suggereert 10–30 woorden voor snelle concepten en 30–80 voor gewone projecten, met langere beschrijvingen voor complexe scènes. Die bereiken zijn richtlijnen voor het schrijven van prompts, geen limiet voor de tekstcontext.
Een oorspronkelijke catalogusbriefing kan een lamp van geborsteld staal tonen op een warmgrijs tafelblad, in driekwartaanzicht zodat schakelaar en kap zichtbaar zijn. Benoem het oppervlak, de verlichting en het standpunt die het product herkenbaar maken. Leg voor een infographic of marketingbeeld eerst de zichtbare formulering en hiërarchie vast; citeer de exacte titel, geef de plaatsing aan en benoem de stijl en grootte van de letters. Controleer etiketten, hoeveelheden en productdetails op de uiteindelijke weergavegrootte.
De familiegids documenteert zowel prompts in natuurlijke taal als JSON-gestructureerde prompts. Een gestructureerde scènebriefing kan onderwerp, achtergrond, licht en compositie in afzonderlijke velden houden, zodat je één vereiste duidelijk kan aanpassen. Hij ondersteunt ook beschrijvingen met hexkleuren: koppel de code aan het specifieke object of de tekst die die kleur moet krijgen. Beschrijf het gewenste uiterlijk positief, want de gedocumenteerde FLUX.2-promptprocedure biedt geen negatieve prompts.
Bewerk met referenties en een gedeeld pixelbudget
Het specifieke [pro]-aanvraagprofiel biedt acht posities voor referentiebeelden; de interactieve interface van de maker ondersteunt afzonderlijk tien. Geef elke afbeelding een rol, zoals uiterlijk van het onderwerp, kleding, productontwerp, kamer of stijl. Geef bij een bestaande scène aan welk element moet veranderen en welke compositie, omgeving en visuele details behouden moeten blijven. De gepubliceerde voorbeelden omvatten meubelcomposities, achtergrond- of weerswijzigingen, vervangende objecten en tekstherzieningen.
De referentiecapaciteit hangt ook af van het uitvoerformaat. De [pro]-gids van de producent specificeert een totaalbudget van 9 megapixels voor invoer en uitvoer samen. De voorbeelden staan acht referenties toe bij uitvoer van 1 megapixel en zeven bij uitvoer van 2 megapixels; de referentiecapaciteit daalt naarmate het gevraagde resultaat groter wordt. Plan de bronnen en uitvoer samen in plaats van te verwachten dat het maximale aantal plaatsen voor elk uitvoerformaat beschikbaar is. Gebruik de referenties die noodzakelijke informatie vastleggen en benoem hun bedoelde bijdrage.
Voor een productcompositie kan de eerste afbeelding het product leveren en de tweede een kamer, terwijl een derde een materiaalafwerking vastlegt. Leg uit hoe ze één samenhangende scène moeten vormen. Als het resultaat een vorm, markering of identiteit verandert die behouden moest blijven, richt de vervolgopdracht dan op dat probleem in plaats van de hele briefing te vervangen. Het praktische resultaat is het herziene beeld, waarbij referentiegetrouwheid en de specifieke wijziging met de invoer worden vergeleken.
Promptuitbreiding en vaste profielen tegenover previewprofielen
De specifieke [pro]-specificatie schakelt promptuitbreiding standaard in. De instelling disable_pup stopt die uitbreiding wanneer een zorgvuldig geschreven instructie ongewijzigd moet worden gebruikt. Behoud de gekozen instelling wanneer je versies vergelijkt, want hetzelfde korte concept en een uitgebreide beschrijving zijn verschillende generatie-invoeren. Dit is een instelling van het makersprofiel, geen garantie dat elk gevraagd detail correct verschijnt.
De documentatie onderscheidt het gewone [pro]-endpoint als een vaste momentopname van [pro] Preview, waarin latere modelverbeteringen worden geïntroduceerd. Hun aanvraag- en antwoordstructuren zijn gelijk, maar hun onderliggende gewichten verschillen. Bewaar het exact gekozen profiel bij de afbeelding en referenties. Het afzonderlijke Preview-label mag een gewone [pro]-selectie niet stilzwijgend vervangen wanneer een herziening van dezelfde gedocumenteerde modelkeuze afhangt.
Afmetingen, formaten en het gekozen beeld
De familiegids documenteert uitvoer tot 4 megapixels, met expliciete afmetingen van minstens 64×64 en veelvouden van 16. Hij beveelt voor de meeste toepassingen maximaal 2 megapixels aan. Breedte en hoogte bepalen de bedoelde kadrering; een vierkant productbeeld, staande lay-out en brede redactionele scène verdelen de ruimte anders. De specifieke aanvraag vermeldt JPEG-, PNG- en WebP-uitvoer, met JPEG als standaard, en een optionele seed.
Het [max]-profiel heeft een afzonderlijke zoekfunctie voor onderbouwing met bronnen, terwijl [flex] samplingstappen en guidance beschikbaar stelt en [klein] een kleiner profiel met vier referenties heeft. Kies de editie op basis van het benodigde werk, in plaats van die instellingen naar [pro] over te nemen. Bewaar voor het gekozen beeld de daadwerkelijke afbeelding, definitieve prompt, referenties, afmetingen en modelnaam. De ondertekende FLUX.2-resultaatlinks van de producent vervallen na tien minuten, dus haal de afbeelding op in plaats van op de tijdelijke locatie te vertrouwen. Beoordeel identiteit van het onderwerp, kleuren, tekst, compositie en bewerkte details voordat je het resultaat in klantgericht materiaal plaatst.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations black-forest-labs/flux.2-pro
black-forest-labs/flux.2-proAan de slag
FLUX.2 [pro] is het productiebeeldmodel van Black Forest Labs voor creatie vanuit tekst en bewerking met referenties. Het gedocumenteerde profiel combineert fotorealistische details, tekst- en kleurcontrole met een pixelbudget voor referenties en uitvoer en afbeeldingen tot 4 megapixels.
- 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-pro | 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 uitvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper megapixel van de uitvoerafbeelding | Kosten Uitvoer · megapixel van een uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.06 per megapixel van de uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.06 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-pro', '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-pro
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Black Forest Labs: FLUX.2 Pro
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·black-forest-labs/flux.2-pro:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·black-forest-labs/flux.2-pro:model,prompt,aspect_ratio,output_format,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·black-forest-labs/flux.2-pro:n.minimum:1;n.maximum:1