models

Black Forest Labs: FLUX.2 Pro

Markdown · JSON

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-pro

Black Forest Labs /black-forest-labs/flux.2-pro

Aan 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
VeldTypeVereisteWaarden en limietenStandaard
VeldmodelTypestringVereisteVereistWaarden en limieten
black-forest-labs/flux.2-pro
Standaard—
VeldpromptTypestringVereisteVereistWaarden en limieten
Minimumlengte: 1
Standaard—
Veldaspect_ratioTypestringVereisteOptioneelWaarden en limieten
1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto
Standaard—
Veldoutput_formatTypestringVereisteOptioneelWaarden en limieten
png, jpeg
Standaard—
VeldnTypeintegerVereisteOptioneelWaarden en limieten
Minimum: 1
Maximum: 1
Standaard—
Veldinput_referencesTypearrayVereisteOptioneelWaarden en limieten
Minimumaantal items: 0
Maximumaantal items: 8
Standaard—
VeldproviderTypeobjectVereisteOptioneelWaarden en limietenStandaard—
Methodeparameters en levenscyclus
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, prompt
Parametermaterial_typesContracttext, 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.

ConfiguratieTariefstaffelVerwachte hoeveelheidRekeneenheidKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefVerwachte 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 uitvoerafbeeldingTariefstaffel—Verwachte hoeveelheid—Rekeneenheidper megapixel van de uitvoerafbeeldingKosten
Uitvoer · megapixel van een uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.06 per megapixel van de uitvoerafbeelding
ConfiguratieGeschatte generatiekostenTariefstaffel—Verwachte hoeveelheidschatting voor één generatieRekeneenheid—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

curl
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}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Lezen van andere inhoud
Bestaande eigen bestanden ophalen
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
VeldType
VeldcreatedType
Velddata[].urlType
Velddata[].b64_jsonType
VeldusageType

Aliasnamen

Modelaliasnamen

Ailoot Ultra black-forest-labs/flux.2-pro

Aliasnamen voor methodepaden

/v1/images

Gerelateerde aanroeper-ID’s

black-forest-labs/flux.2-pro

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

Meer details

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement
Kies een abonnement met korting voor je terugkerende verzoeken.
Promotiecode tot 50%
Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.
Kosten in de geschiedenis
Model, tokens en bedrag worden per verzoek bewaard.

Kies een abonnement · Bekijk modelprijzen

Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie
Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.
Resellerlicentie
Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.
Documenten op de site
Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

Vraag een resellerlicentie aan · Aanbodvoorwaarden en licentieovereenkomst