models

Black Forest Labs: FLUX.3 Image

Markdown · JSON

Black Forest Labs: FLUX.3 Image

FLUX 3 Image erstellt und bearbeitet Bilder aus einem schriftlichen Briefing und bis zu zehn Referenzen. Es ergänzt promptbasierte Begrenzungsrahmen für Komposition und lokale Änderungen, Web- und Bildfundierung sowie fünf Auflösungsklassen.

Über das Modell

Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.

FLUX 3 Image ist das Bilderzeugungs- und Bearbeitungsmodell von Black Forest Labs mit ausdrücklicher Steuerung der Komposition. Eine Textbeschreibung kann eine neue Szene erzeugen; bereitgestellte Bilder können ein Motiv, eine zu überarbeitende Szene oder mehrere zu kombinierende Elemente festlegen. Begrenzungsrahmen lassen eine Vorgabe bestimmen, wohin jedes Element gehört und welche Teile eines vorhandenen Bildes geändert werden sollen. Das Ergebnis ist ein Bild, dessen gewünschte Szene, Text und Layout geprüft werden können.

Erstellen Sie eine Szene oder geben Sie eine Bearbeitungsanweisung

Beschreiben Sie für ein neues Bild Motiv, Handlung oder Pose, Umgebung, Licht und Bildausschnitt. Setzen Sie den genauen Wortlaut im Bild in Anführungszeichen und benennen Sie seine Position. Eine eigene Produktbeschreibung könnte einen roten Campingbecher auf einer hellen Steinfläche zeigen, darüber eine grosse Überschrift und weiches Morgenlicht, das den Henkel sichtbar macht. Definieren Sie die Beziehung zwischen Überschrift, Produkt und Hintergrund, statt unverbundene Stilwörter anzubieten.

Benennen Sie für eine Bearbeitung das konkrete Objekt und die Änderung: den Becher umfärben, ein Etikett ersetzen, eine Figur verschieben oder den Szenenstil ändern. Eine einzelne Bearbeitung benötigt keinen von Hand gezeichneten Rahmen. Der dokumentierte Ablauf erweitert die Anweisung vor der Generierung, kann das benannte Element lokalisieren und automatisch einen Rahmen hinzufügen. Der zurückgegebene erweiterte Prompt hält diese Interpretation fest; dies ist hilfreich, wenn eine Anweisung das falsche Objekt auswählt oder ein unerwünschtes Detail einführt.

Kombinieren und bereiten Sie Referenzbilder vor

Das genaue Herstellerprofil nimmt eine bis zehn Referenzen als Bild-URLs oder kodierte Bilddaten an. Jede muss mindestens 256×256 Pixel gross sein und darf 16 Megapixel nicht überschreiten. Benennen Sie eine Referenz anhand ihrer Position oder ihres sichtbaren Inhalts und erklären Sie ihre Rolle: die Person aus Image 1, die Jacke aus Image 2 und der Raum aus Image 3. Eine Bildreferenz ist eine Quelle visueller Informationen und keine Anweisung, jedes sachfremde Detail daraus zu kopieren.

Die Einstellung des Seitenverhältnisses verwendet standardmässig auto. In der Anfragespezifikation hat ein im Prompt gewünschtes Verhältnis Vorrang; andernfalls legt die erste Referenz den Bildausschnitt fest. Wenn weder eine Referenz noch eine gewünschte Form ihn vorgibt, wird eine quadratische Ausgabe verwendet. Stellen Sie bei einer Komposition die gewünschte Szenenreferenz an die erste Stelle oder wählen Sie das Verhältnis ausdrücklich. Bewahren Sie die Quellbilder und ihre Reihenfolge zusammen mit dem Ergebnis, damit eine spätere Überarbeitung denselben visuellen Ausgangspunkt nutzt.

Platzieren Sie Elemente mit Begrenzungsrahmen

Ein Layoutprompt verbindet eine Bildbeschreibung mit einem JSON-Array aus Elementzeilen. Die Beschreibung benennt ein Element über einen Marker wie <cup_1>; die Zeile enthält id, bbox und desc. Koordinaten sind Ganzzahlen von 0 bis 1000 in der Reihenfolge [top, left, bottom, right], gemessen von der oberen linken Ecke. Beispielsweise beschreibt [0, 0, 500, 500] unabhängig von den Pixelabmessungen das obere linke Viertel. Verwenden Sie das Seitenverhältnis, für das das Layout entworfen wurde, weil sich dieses Koordinatenraster mit dem Bildrahmen streckt.

Eine Bearbeitungszeile verwendet stattdessen from, src_bbox und tgt_bbox neben Kennung und Beschreibung. ref_image_0 bezeichnet das erste bereitgestellte Bild. Übereinstimmende Quell- und Zielrahmen verankern ein Element; unterschiedliche Rahmen verschieben es oder ändern seine Grösse. Eine neue Zeile ohne Quelle erzeugt ihre Beschreibung am Zielort und erlaubt Ergänzungen, Ersetzungen oder Umfärbungen. Eine Quellzeile ohne Ziel entfernt das Element. Benennen Sie Ergänzungen und Entfernungen sowohl in der schriftlichen Anweisung als auch in den Zeilen und behalten Sie Ankerzeilen für Details bei, die an ihrem Platz bleiben müssen.

Geben Sie Schrift einen eigenen Rahmen und zitieren Sie ihren genauen Wortlaut in desc. Rahmen leiten Platzierung und Massstab; sie sind keine Beschneidungsmasken, sodass ein Element über das Rechteck hinausragen kann. Der Hersteller berichtet, dass neue Objekte in Rahmen von ungefähr 40×25 Pixeln in seinen Beispielen häufig nicht erschienen. Lassen Sie genügend sichtbaren Platz und prüfen Sie die bearbeiteten Grenzen. Pixel ausserhalb des Ziels bleiben meist stabil, aber Schatten, Spiegelungen und benachbartes Licht können sich dennoch ändern.

Quellenbezug, Ausgabeklassen und hilfreiche Aufzeichnungen

Das dokumentierte Profil aktiviert Grounding standardmässig, sodass Ergebnisse aus Web- und Bildsuche in die Generierung einfliessen können. Es kann für eine Vorgabe deaktiviert werden, die nur ihre bereitgestellte Beschreibung und Referenzen verwenden soll. Benennen Sie bei einem realen Motiv Ort, Ereignis oder Gegenstand klar und halten Sie sachliche Inhalte von künstlerischer Gestaltung getrennt. Suchgestützte Bilder müssen weiterhin mit massgeblichem Material verglichen werden, wenn eine Beschriftung, ein Objekt oder ein dargestelltes Ereignis korrekt sein muss.

Die fünf Auflösungsklassen sind 768sq, 1k, 1.5k, 2k und 4k mit 1k als Standard. Sie stellen Stufen gleicher Pixelfläche dar; die genaue Breite und Höhe hängen deshalb vom gewählten Verhältnis ab. Fünfzehn feste Verhältnisse reichen von 21:9 über quadratische und vertikale Formate bis 9:21. Dieses Modellprofil steuert die Grösse über Verhältnis und Auflösung; es stellt die Felder seed, width oder height der FLUX.2-Anfrageprofile nicht bereit. Sein dokumentierter Versionswähler nennt derzeit eine wechselnde Veröffentlichung, statt eine datierte Übereinstimmung mit Lieferantengewichten zu belegen.

Der Herstellerablauf gibt nach asynchroner Verarbeitung ein Bild zusammen mit dem erweiterten Prompt zurück. Der signierte Downloadlink des Bildes gilt eine Stunde. Bewahren Sie das tatsächliche Bild, den endgültigen Prompt und die Referenzen auf, statt sich auf einen vorübergehenden Link zu verlassen. Vergleichen Sie für ein geprüftes Artefakt gewünschten Text, Objektplatzierung, Referenzidentität und geänderten Bereich bei der vorgesehenen Anzeigegrösse. Eine abgeschlossene Generierung ist der Ausgangspunkt für die Prüfung dieser visuellen Anforderungen.

Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux-3-image

black-forest-labs/flux-3-image

Black Forest Labs /black-forest-labs/flux-3-image

Einstieg

FLUX 3 Image erstellt und bearbeitet Bilder aus einem schriftlichen Briefing und bis zu zehn Referenzen. Es ergänzt promptbasierte Begrenzungsrahmen für Komposition und lokale Änderungen, Web- und Bildfundierung sowie fünf Auflösungsklassen.

Zulässige Eingaben
Text · Bilder
Ergebnisse
Bilder

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Bilder POST /v1/images/generations
Eingabe
text, image
Ausgabe
image
FeldTypAnforderungWerte und LimitsStandard
FeldmodelTypstringAnforderungErforderlichWerte und Limits
black-forest-labs/flux-3-image
Standard—
FeldpromptTypstringAnforderungErforderlichWerte und Limits
Mindestlänge: 1
Standard—
FeldresolutionTypstringAnforderungOptionalWerte und Limits
768, 1K, 1.5K, 2K, 4K
Standard—
Feldaspect_ratioTypstringAnforderungOptionalWerte und Limits
21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto
Standard—
FeldnTypintegerAnforderungOptionalWerte und Limits
Minimum: 1
Maximum: 1
Standard—
Feldinput_referencesTyparrayAnforderungOptionalWerte und Limits
Mindestanzahl Elemente: 0
Maximale Anzahl Elemente: 10
Standard—
FeldproviderTypobjectAnforderungOptionalWerte und LimitsStandard—
Methodenparameter und Lebenszyklus
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, prompt
Parametermaterial_typesVertragtext, image

Lebenszyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarife

So wird die endgültige Gebühr berechnet

Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.

Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.

Schnellmodus
Nicht angegeben Wenn der Schnellmodus ausgewählt ist
Flex-Modus
Nicht angegeben Wenn der Modus flex ausgewählt ist
Maximaler Denkaufwand
Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird

Geschätzte Tarife zum Vergleich

Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

KonfigurationTarifstaffelPrognostizierte MengeGebühr
KonfigurationToken-BasistarifeTarifstaffelGrundtarifPrognostizierte Menge—Gebühr
Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens
Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens
KonfigurationGeschätzte ErzeugungskostenTarifstaffel—Prognostizierte MengeSchätzung für eine GenerierungGebühr
Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.082 Schätzung vor der Generierung

Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.

Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →

Beispielanfragen

Ailoot Ultra · Bilder

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-3-image', '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

Ergebnisse abrufen und speichern

Ailoot Ultra · Bilder

Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
Vorhandene eigene Dateien abrufen
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 fertiggestellten Ergebnisse aufbewahren

Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.

Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.

Wenn die ursprüngliche Antwort geprüft werden muss

Die zurückgegebene X-Client-Request-ID zum Abgleich aufbewahren. Nur tatsächlich zurückgegebene task_id-/asset_id-Werte oder die eigene Medienbibliothek abfragen; niemals eine Aufgaben-URL aus der Vorgangs-ID bilden und die Erstellung niemals erneut anfordern.

Antwortfelder
FeldTyp
FeldcreatedTyp
Felddata[].urlTyp
Felddata[].b64_jsonTyp
FeldusageTyp

Aliasnamen

Modellaliasnamen

Ailoot Ultra black-forest-labs/flux-3-image

Aliasnamen für Methodenpfade

/v1/images

Zugehörige Aufrufer-IDs

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image
Welche Eingaben und Ergebnisse sind verfügbar?

POST /v1/images/generations · black-forest-labs/flux-3-image: text, image → image

Welche Felder verwendet die Anfrage?

POST /v1/images/generations · black-forest-labs/flux-3-image: model, prompt, resolution, aspect_ratio, n, input_references, provider

Welche Grenzen gelten?

POST /v1/images/generations · black-forest-labs/flux-3-image: n.minimum: 1; n.maximum: 1

Weitere Details

Verbinden Sie Ailoot mit Claude Code, OpenCode, Hermes oder Ihrer eigenen Anwendung.

Das Unternehmen und sein Projektportfolio

Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.

Tokens mit Rabatt kaufen.

Aborabatt für regelmäßige Arbeit. Aktionscodes bieten bis 50% beim Tokenkauf.

Abo
Wählen Sie einen Tarif mit Rabatt für Ihre regelmäßigen Anfragen.
Aktionscode bis 50%
Geben Sie den Code beim Kauf ein. Der Preis wird nach den gültigen Aktionsbedingungen berechnet.
Ausgaben in der Historie
Modell, Tokens und Betrag werden für jede Anfrage gespeichert.

Abo wählen · Modellpreise ansehen

Verbinden Sie die API mit dem Produkt, das Sie verkaufen.

SaaS, Anwendungen und Bots nach dem offiziellen Angebot und Lizenzvertrag von Ailoot. Fordern Sie für den Weiterverkauf eine Reseller-Lizenz an.

Kommerzielle Anwendung
Integrieren Sie Text-, Bild-, Video- und Audioerzeugung in kostenpflichtige Funktionen Ihres Dienstes.
Reseller-Lizenz
Senden Sie Projektbeschreibung und Zugangsmodell. Fordern Sie schriftliche Nutzungs- und Weiterverkaufsbedingungen an.
Dokumente auf der Website
Offizielles Angebot, Lizenzvertrag und Datenschutzerklärung sind vor der Verbindung zugänglich.

Reseller-Lizenz anfordern · Offizielles Angebot und Lizenzvertrag