Zum Hauptinhalt springen

FLUX.1 Dev LoRA: Ein Stilbriefing, das die Szene brauchbar hält

FLUX.1 Dev LoRA per API starten, ohne das Motiv zu verlieren: Kontrolle ohne Adapter, Startwerte für Skala und Guidance und wann Sie zur Maske wechseln.

Autor
Lydia
Erschienen
Lesedauer
12 Min. Lesezeit
Aktualisiert
Zwei Erwachsene an einem Tisch in einer Keramikwerkstatt betrachten eine kobaltblaue Kanne auf cremefarbenem Leinen

Um eine FLUX.1 Dev LoRA per API auszuführen, senden Sie ihre Gewichts-URL und eine Skala in der Liste loras. Um das Motiv intakt zu halten, führen Sie die Szene einmal ohne Adapter aus und fügen dann die Datei mit demselben Seed, derselben Guidance und denselben Schritten hinzu und ändern nur die LoRA-Skalierung. Ein brauchbarer Start ist Skala 1, Guidance 3.5, 28 Schritte und ein quadratisches Format. Realismus-Dateien sehen oft bei Guidance 2.5 bis 3 besser aus. Eine Kontrolle plus drei Skalastufen ergeben vier Bilder zu je $0.018, also $0.072. Behalten Sie das Ergebnis, dessen Objekte noch funktionieren, nicht das mit dem stärksten Look.

Die durchgearbeitete Szene ist eine fiktive matte Kobalt-Kanne mit einem halbmondförmigen Henkel auf cremefarbenem Leinen.

Legen Sie fest, was der Adapter beitragen soll

Die Szene braucht eine lesbare Kanne, einen kurzen Ausguss, einen offenen Henkel und Kontakt zum Leinen, weich beleuchtet mit zurückhaltender Keramikstruktur. Wenn der Adapter dramatischen Glanz oder aufwendige Verzierungen hinzufügt, kann er funktionieren und trotzdem falsch für dieses Briefing sein.

Für eine Variante mit einer erwachsenen Figur ersetzen Sie die Kanne durch eine fiktive erwachsene Person im Alter von 35 in einem zugeknöpften marineblauen Hemd neben einer schlichten Studiowand und lassen Pose und Kleidung über alle Bedingungen hinweg identisch.

Kobaltblaue Keramikkane mit sichtbarer Henkelöffnung auf cremefarbenem Leinen

Illustration, kein FLUX-Ergebnis: das Zielmotiv mit einem Körper, einer Henkelöffnung und einem kurzen Ausguss.

Wählen Sie eine Datei, die zu FLUX.1 Dev passt

Eine kompatible Datei nennt FLUX.1 Dev als Trainingsbasis. Eine LoRA für eine andere FLUX-Veröffentlichung, eine bearbeitungsspezifische Architektur, SDXL, Z-Image oder Qwen-Image lädt und ändert dann wenig, prüfen Sie also zuerst die Basis. Verwenden Sie in path einen direkten Link auf die Gewichtsdatei, nicht die Webseite, die sie beschreibt: Eine Seiten-URL wird bei der Übermittlung abgelehnt, und ein gesperrtes Repository mit Login-Pflicht ebenfalls.

Die XLabs-Modellkarte für Photorealismus nennt zum Beispiel FLUX.1 Dev als Basis, und der direkte Dateilink im Code unten endet auf /resolve/main/lora.safetensors (etwa 22 MB). Die Karte wendet die FLUX.1 Dev-Nichtkommerziell-Lizenz auf die Datei selbst an; lesen Sie deren Bedingungen, bevor Sie Ausgaben in Kundenarbeiten verwenden.

Dokumentiert die Karte eine Triggerphrase, setzen Sie sie ganz vorn in den Prompt, genau so geschrieben (die XLabs-Karte dokumentiert keine). Gibt sie eine empfohlene Stärke an, beginnen Sie dort; andernfalls verwenden Sie die Leiter unten.

Probieren Sie es zuerst im Playground

Öffnen Sie FLUX.1 Dev LoRA Text zu Bild im Tab Playground in der Ansicht Form und melden Sie sich mit einem Konto mit Guthaben an, um zu starten. Beginnen Sie mit der Kontrolle, einem Lauf ohne Gewichte:

  1. Fügen Sie den untenstehenden Prompt in Prompt ein. FLUX folgt langen, spezifischen Prompts, schreiben Sie also ganze Sätze. Es gibt kein Feld für einen negativen Prompt, sagen Sie deshalb, was Sie wollen ("one handle", "no lettering"), statt Ausschlüsse aufzulisten.
  2. Setzen Sie Aspect ratio auf 1:1.
  3. Unter Style LoRAs drücken Sie Remove item, bis die Liste leer ist.
  4. Öffnen Sie Advanced parameters und setzen Sie Prompt adherence auf 3.5, Sampling steps auf 28, Output format auf PNG und Seed auf 17231.
  5. Führen Sie das Modell aus und speichern Sie das Bild.

One matte cobalt ceramic pitcher with a rounded body, short spout and one crescent handle on cream linen. Whole vessel visible, open handle against a quiet cream wall, oak stool behind without overlap. Soft daylight from the left, natural ceramic texture, contact shadow. Square composition, no lettering or extra vessels.

Hat diese Kontrolle zwei Henkel oder einen schwebenden Boden, reparieren Sie zuerst die Szene: Stellen Sie den Hocker von der Henkelöffnung weg, verlangen Sie eine klarere Dreiviertelansicht oder entfernen Sie den Hocker. Ein geänderter Prompt ändert das Bild auch bei demselben Seed, halten Sie den Text in allen späteren Läufen also identisch.

Dann fügen Sie einen Adapter hinzu. Drücken Sie Add item, fügen Sie den direkten Gewichtslink in LoRA file ein (eine erreichbare Datei, die Sie nutzen dürfen) und setzen Sie Strength auf 1. Ändern Sie nichts weiter und führen Sie erneut aus. Stärke 1 wendet die Datei so an, wie ihr Autor sie trainiert hat, und das Feld akzeptiert 0 bis 4. Führen Sie 0.8, 1.0 und 1.2 als Leiter aus (ergänzen Sie 0.5, wenn 0.8 noch zu stark ist): Senken Sie Richtung 0.8, wenn der Look schwer ist; kräftige Illustrationsstile brauchen manchmal etwas mehr als 1. Stapeln Sie nicht drei Dateien, bevor sich eine bewährt hat. Benötigt die Datei einen Trigger, führen Sie den Trigger zusätzlich allein ohne LoRA aus; der Text allein kann das Basisbild verschieben.

Sieht eine Realismus-Datei wächsig oder überschärft aus, wiederholen Sie die beste Stärke mit Prompt adherence auf 2.5 und demselben Seed. Prompt adherence legt fest, wie strikt das Bild dem Prompt folgt; es ist nicht die Adapterstärke.

Führen Sie es dann im Code aus

Dieselbe Kontrolle und dieselben drei Stärkestufen, wobei der Seed und jedes andere Feld konstant bleiben. Installieren Sie das Python SDK (pip install spicyapi), setzen Sie SPICY_API_KEY in Ihrer Serverumgebung und führen Sie aus:

python
import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

PROMPT = ("One matte cobalt ceramic pitcher with a rounded body, short spout and one crescent handle "
          "on cream linen. Whole vessel visible, open handle against a quiet cream wall, oak stool "
          "behind without overlap. Soft daylight from the left, natural ceramic texture, contact "
          "shadow. Square composition, no lettering or extra vessels.")
WEIGHTS = "https://huggingface.co/XLabs-AI/flux-RealismLora/resolve/main/lora.safetensors"  # XLabs realism, FLUX.1 Dev; swap in your own file
# 4 images x $0.018 = $0.072

for scale in (None, 0.8, 1.0, 1.2):  # None = control with no adapter
    task = client.create_task(
        model="black-forest-labs/flux-1-dev-lora/text-to-image",
        input_data={
            "prompt": PROMPT,
            "aspect_ratio": "1:1",
            "loras": [] if scale is None else [{"path": WEIGHTS, "scale": scale}],
            "guidance_scale": 3.5,
            "steps": 28,
            "seed": 17231,
            "output_format": "png",
        },
        idempotency_key=str(uuid.uuid4()),
    )
    final = client.wait_for_terminal(task["taskId"])
    if final["state"] != "succeeded":
        raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
    assets = output_assets(final)
    if not assets or any(a.get("pending") or a.get("unavailable") or not a.get("url") for a in assets):
        raise RuntimeError(f"Task {task['taskId']} has no ready output; check this task before running more images")
    print(scale, assets[0]["url"])  # copy the image to your own storage now

Erstellen, Warten, Herunterladen, Wiederholungen und Fehlercodes behandelt der Tasks-Leitfaden und die Python SDK-Referenz. Gewichte werden bei jedem Job geladen, ein erster Aufruf mit einer großen Datei ist also langsamer als ein einfacher Lauf (siehe Eigene LoRA auf einer gehosteten API ausführen).

Oder lassen Sie einen Agenten laufen

Wenn ein Assistent den Vergleich ausführen soll, zeigen alle drei offiziellen Tools den Preis und fragen Sie vor einem kostenpflichtigen Aufruf.

  • CLI. Legen Sie das input-Objekt einer Bedingung in input.json und führen Sie dann aus:

``bash spicyapi tasks create --model black-forest-labs/flux-1-dev-lora/text-to-image --input-file input.json --wait ``

Siehe die CLI-Doku; npx @spicyapi/cli funktioniert ohne Installation.

  • MCP-Server. Fügen Sie Ihrem Assistenten den MCP-Server hinzu und fragen Sie dann: "Run FLUX.1 Dev LoRA with this prompt, seed 17231, no LoRA, then again with this weights link at strength 0.8, 1 and 1.2." Er ruft spicyapi_task_create auf, das für Ihre Preisbestätigung anhält, und dann spicyapi_task_wait.
  • Skill. npx skills add spicyapi-ai/spicy-skill installiert den Agent Skill, der einen Coding-Assistenten das Live-Modellschema lesen lässt, statt Felder zu raten.

Verwechseln Sie die Regler nicht

ReglerBereich in der Text-zu-Bild-AufgabeVerwendung in diesem Vergleich
loras (Style LoRAs)bis zu 3, je path und scaleBeginnen Sie mit einer; die Kontrolle ohne Datei nutzt []
LoRA-Skalierung (Strength)0–4, 1 wendet die Datei wie trainiert anVariieren Sie diesen Wert bei sonstigen Einstellungen
guidance_scale (Prompt adherence)0–20, Standard 3.5Lassen Sie ihn bei 3.5; testen Sie 2.5 für wachsigen Realismus
steps (Sampling steps)1–50, Standard 28Lassen Sie ihn bei 28, um eine weitere veränderliche Bedingung zu vermeiden
seed0–2147483647Behalten Sie 17231, damit die Läufe vergleichbar bleiben
FormateJPEG (Standard), PNG, WebPPNG

Die Aufgabe bietet neun Seitenverhältnisse (21:9 bis 9:21, alle etwa ein Megapixel und ein Preis), aber keine Auflösung und keine unabhängigen Felder für Breite und Höhe, kein Bildeingang und keine Maske. Ein Eintrag mit scale: 0 kann die Datei trotzdem laden, er ist also kein Ersatz für die Kontrolle mit leerer Liste.

Beheben Sie ein gescheitertes Adapter-Experiment

ProblemKonkreter nächster Schritt
Anfrage abgelehnt oder späterer FehlschlagPrüfen Sie, ob path die .safetensors-Datei ohne Anmeldung liefert und nicht eine Modellkartenseite. Ein falsch getippter Host oder eine Datei, die später verschwindet, wird bei der Übermittlung akzeptiert und scheitert danach.
Bild ändert sich kaumPrüfen Sie, ob die Basis der Datei FLUX.1 Dev ist und ein erforderlicher Trigger im Prompt ganz vorn steht; erhöhen Sie dann die Skala um 0.2.
Stil überwältigt das ObjektSenken Sie die Skala Richtung 0.8 oder 0.6.
Realismus sieht wächsig ausSenken Sie die Guidance bei demselben Seed auf 2.5.
Henkel wird massiv oder doppeltSenken Sie die Skala oder verwerfen Sie die Datei für dieses Motiv.
Trigger allein erzeugt den LookDer Look kommt aus den Wörtern, nicht aus der Datei; beurteilen Sie die Datei nur danach, was sie über das Bild mit reinem Trigger hinaus beiträgt.
Stil ist nützlich, aber die Produktform ändert sichVerwenden Sie den Editor mit Maske (nächster Abschnitt) oder komponieren Sie die Produktebene.

Vergleichen Sie Gefäß, Henkelkante und Wand bei gleicher Anzeigegröße und wählen Sie nach Behandlung und brauchbarer Struktur, nicht danach, wie viel sich geändert hat.

Verwenden Sie den Editor, wenn eine Quelle das Bild führen muss

FLUX.1 Dev LoRA Bearbeitung ist eine zweite Aufgabe auf demselben Modell, ebenfalls $0.018 pro Bild. Sie benötigt image_url und prompt und akzeptiert dieselbe loras-Liste, dieselbe Guidance und dieselben Schritte. Zwei Regler sind neu: strength (0 bis 1, Standard 0.8) legt fest, wie weit sich das Ergebnis von der Quelle entfernt, und ein optionales mask_url, ein schwarzweißes Bild in derselben Größe, in dem Weiß neu gezeichnet und Schwarz beibehalten wird. Quelle und Maske sind auf je 10 MB begrenzt, und beide können ein öffentlicher Link auf die Datei sein.

Bei Standard 0.8 bleiben Pose und Layout erhalten; um 0.95 zeichnet das Modell fast alles neu. Starten Sie bei 0.8 und gehen Sie in Schritten von 0.05 vor, wobei Sie pro Lauf nur Stärke oder LoRA-Skalierung ändern: Wenn die Quelle durchscheint, erhöhen Sie sie; wenn die Form driftet, senken Sie sie. Mit einer Maske verwenden Sie 0.9 bis 1, damit sich der weiße Bereich wirklich ändert, und beschreiben Sie nur, was in den weißen Bereich gehört.

Eine praktische Nutzung für dieses Briefing: Behalten Sie die freigegebene Kanne und gestalten Sie alles um sie herum neu. Öffnen Sie im Playground die Bearbeitungsaufgabe, legen Sie das Kontrollbild in Input image, malen Sie Wand und Leinen in einem gleich großen Bild weiß und die Kanne schwarz und fügen Sie es unter Advanced parameters als Mask hinzu, setzen Sie dann Transformation strength auf 0.95, fügen Sie Ihre Gewichte unter Style LoRAs hinzu und verwenden Sie einen Prompt nur für die neue Behandlung: "Cream linen with deep folds and a quiet plaster wall, soft daylight from the left, restrained film grain." Behalten Sie den Seed, Prompt adherence 3.5 und Sampling steps 28 aus der Kontrolle. In API-Anfragen heißen dieselben Felder image_url, mask_url, strength und loras beim Modell black-forest-labs/flux-1-dev-lora/edit.

Zeichnen Sie die Maskenkante weich oder folgen Sie der Objektkontur; ein hartes Rechteck hinterlässt eine sichtbare Naht. Die Bearbeitung folgt der Quellform, es gibt also kein Feld aspect_ratio, und das Ergebnis kommt mit etwa 0.7 Megapixeln zurück (eine Quelle mit 1024 x 1536 kommt mit 672 x 1008 zurück), kleiner als ein Text-zu-Bild-Format. Wenn exakte Produktpixel Pflicht sind, halten Sie die ursprüngliche Produktebene über einem separat vorbereiteten Hintergrund und behandeln Sie dieses Compositing als Fertigstellung.

Hände ordnen eine Fotografie einer kobaltblauen Kanne, eine Bleistiftzeichnung und eine Glasurfliese auf einem Werkstatttisch

Referenzmaterial für das Briefing: eine Fotografie, eine Zeichnung und Glasurmuster.

Inhalte für Erwachsene: was die LoRA ändert und was nicht

FLUX.1 Dev LoRA ist eine unzensierte Route: SpicyAPI fügt keinen Plattform-Inhaltsfilter hinzu, und auf Erwachsene ausgerichtete LoRAs laden und rendern. Das Laden einer LoRA legt den Inhaltsumfang nicht fest; das Basismodell entscheidet weiterhin, was zurückkommt. Auf Grundlage unserer Tests vom September 2026 lieferte das reine Modell aus Text anzügliche NSFW-Bilder und NSFW-Bilder mit Oberkörper und milderte Anfragen mit ganzer Figur und mit zwei Personen. Mit geladener Erwachsenen-LoRA lieferte die stärkste Probe fortgeschrittene NSFW-Bilder, aber nie die Szene höchster Intensität. In der Bearbeitung kam eine Oberkörper-Anfrage auf einem bekleideten Porträt bei Stärke 0.95 wie gewünscht zurück (mit oder ohne LoRA) und bei 1 mit Maske, bei 0.85 jedoch gemildert, erhöhen Sie also die Stärke, bevor Sie das Modell wechseln. Ist FLUX unzensiert? enthält die Ergebnisse Stufe für Stufe.

Eine fotografische Style-LoRA ändert den Look, nicht den Inhaltsumfang. Verwenden Sie nur fiktive Erwachsene oder Personen mit dokumentierter Einwilligung.

Wie es weitergeht

Lassen Sie die LoRA weg, wenn der reine Lauf das Briefing bereits erfüllt. Um eine neue Datei über eine ganze Bibliothek auf schlechte Links und wirkungslose Gewichte zu prüfen, siehe Eigene LoRA auf einer gehosteten API ausführen. Für dieselbe Methode mit Kontrolle zuerst auf einer anderen Basis siehe den Z-Image Turbo LoRA Test mit gleichem Seed.

Auch in English · 日本語 · 한국어 · Français · Español · Português (Brasil) · Русский · Italiano · Polski

Setzen Sie diesen Leitfaden um

Selbst ausprobieren

Sie zahlen nur für das, was Sie ausführen – ohne Tarif, ohne Abo.

Erstellt mit MiniMax H3 · ByteDance Seedance 2.0 Fast