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.

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:
- 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.
- Setzen Sie Aspect ratio auf 1:1.
- Unter Style LoRAs drücken Sie Remove item, bis die Liste leer ist.
- Öffnen Sie Advanced parameters und setzen Sie Prompt adherence auf 3.5, Sampling steps auf 28, Output format auf PNG und Seed auf 17231.
- 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:
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 nowErstellen, 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 ininput.jsonund 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_createauf, das für Ihre Preisbestätigung anhält, und dannspicyapi_task_wait. - Skill.
npx skills add spicyapi-ai/spicy-skillinstalliert den Agent Skill, der einen Coding-Assistenten das Live-Modellschema lesen lässt, statt Felder zu raten.
Verwechseln Sie die Regler nicht
| Regler | Bereich in der Text-zu-Bild-Aufgabe | Verwendung in diesem Vergleich |
|---|---|---|
loras (Style LoRAs) | bis zu 3, je path und scale | Beginnen Sie mit einer; die Kontrolle ohne Datei nutzt [] |
| LoRA-Skalierung (Strength) | 0–4, 1 wendet die Datei wie trainiert an | Variieren Sie diesen Wert bei sonstigen Einstellungen |
guidance_scale (Prompt adherence) | 0–20, Standard 3.5 | Lassen Sie ihn bei 3.5; testen Sie 2.5 für wachsigen Realismus |
steps (Sampling steps) | 1–50, Standard 28 | Lassen Sie ihn bei 28, um eine weitere veränderliche Bedingung zu vermeiden |
seed | 0–2147483647 | Behalten Sie 17231, damit die Läufe vergleichbar bleiben |
| Formate | JPEG (Standard), PNG, WebP | PNG |
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
| Problem | Konkreter nächster Schritt |
|---|---|
| Anfrage abgelehnt oder späterer Fehlschlag | Prü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 kaum | Prü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 Objekt | Senken Sie die Skala Richtung 0.8 oder 0.6. |
| Realismus sieht wächsig aus | Senken Sie die Guidance bei demselben Seed auf 2.5. |
| Henkel wird massiv oder doppelt | Senken Sie die Skala oder verwerfen Sie die Datei für dieses Motiv. |
| Trigger allein erzeugt den Look | Der 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 sich | Verwenden 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.

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.






