FLUX.1 Dev LoRA: zbuduj brief stylistyczny, który utrzymuje scenę w użyciu

Aby uruchomić FLUX.1 Dev LoRA przez API, wyślij adres URL wag i skalę na liście loras. Aby zachować motyw nienaruszony, wykonaj scenę raz bez adaptera, a potem dodaj plik, nie zmieniając seedu, guidance ani liczby kroków, i zmień tylko skalę LoRA. Działający punkt wyjścia to skala 1, guidance 3.5, 28 kroków i kwadratowy kadr. Pliki w stylu realistycznym często wyglądają lepiej przy guidance od 2.5 do 3. Kontrola plus trzy stopnie skali to cztery obrazy po 0,018 $, czyli 0,072 $. Zostaw ten wynik, w którym obiekty nadal są użyteczne, a nie ten o najsilniejszym wyglądzie.

Scena przykładowa to fikcyjny matowy kobaltowy dzbanek z jednym półksiężycowym uchem na kremowym lnie.

Zdecyduj, co adapter ma wnieść

Scena potrzebuje jednego czytelnego dzbanka, krótkiej wylewki, otwartego ucha i kontaktu z lnem, oświetlonych miękko, z powściągliwą fakturą ceramiki. Jeśli adapter dołoży dramatyczny połysk lub bogate ornamenty, może działać i nadal nie pasować do tego briefu.

W wersji z dorosłą postacią zastąp dzbanek jedną fikcyjną osobą dorosłą w wieku 35 lat, w zapinanej na guziki granatowej koszuli, obok prostej ściany studia, i utrzymaj identyczną pozę oraz ubiór we wszystkich warunkach.

Ilustracja, nie wynik FLUX: docelowy motyw, z jednym korpusem, jednym otworem ucha i krótką wylewką.

Wybierz plik pasujący do FLUX.1 Dev

Zgodny plik wymienia FLUX.1 Dev jako bazę treningową. LoRA dla innego wydania FLUX, architektury przeznaczonej do edycji, SDXL, Z-Image lub Qwen-Image wczyta się, a potem niewiele zmieni, więc najpierw sprawdź bazę. W path wstaw bezpośredni link do pliku z wagami, a nie stronę, która go opisuje: adres strony zostanie odrzucony przy wysłaniu, a repozytorium wymagające logowania również.

Na przykład karta modelu XLabs photorealism podaje FLUX.1 Dev jako bazę, a bezpośredni link do pliku użyty w kodzie poniżej kończy się na /resolve/main/lora.safetensors (około 22 MB). Karta stosuje niekomercyjną licencję FLUX.1 Dev do samego pliku; przeczytaj jej warunki, zanim użyjesz wyników w pracy dla klienta.

Jeśli karta opisuje frazę wyzwalającą, umieść ją na początku promptu dokładnie w podanym zapisie (karta XLabs nie opisuje żadnej). Jeśli podaje zalecaną siłę, zacznij od niej; w przeciwnym razie użyj drabinki poniżej.

Najpierw spróbuj w Playground

Otwórz FLUX.1 Dev LoRA tekst na obraz w zakładce Playground, w widoku Form, i zaloguj się kontem z saldem, aby uruchomić. Zacznij od kontroli, czyli przebiegu bez wag:

1. Wklej poniższy prompt w Prompt. FLUX stosuje się do długich, konkretnych promptów, więc pisz pełnymi zdaniami. Nie ma pola na prompt negatywny, więc mów, czego chcesz ("one handle", "no lettering"), zamiast wymieniać wykluczenia.
2. Ustaw Aspect ratio na 1:1.
3. W sekcji Style LoRAs naciskaj Remove item, aż lista będzie pusta.
4. Otwórz Advanced parameters i ustaw Prompt adherence na 3.5, Sampling steps na 28, Output format na PNG, a Seed na 17231.
5. Uruchom model i zapisz obraz.

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.

Jeśli ta kontrola ma dwa ucha albo unoszącą się podstawę, najpierw napraw scenę: odsuń stołek od otworu ucha, poproś o wyraźniejszy widok z trzech czwartych albo usuń stołek. Zmieniony prompt zmienia obraz nawet przy tym samym seedzie, więc w późniejszych przebiegach tekst zostaw identyczny.

Potem dodaj jeden adapter. Naciśnij Add item, wklej bezpośredni link do wag w LoRA file (osiągalny plik, do którego masz prawo) i ustaw Strength na 1. Nic więcej nie zmieniaj i uruchom ponownie. Siła 1 stosuje plik tak, jak go wytrenował autor, a pole przyjmuje od 0 do 4. Jako drabinkę wykonaj 0.8, 1.0 i 1.2 (dołóż 0.5, jeśli 0.8 wciąż jest za mocne): zejdź ku 0.8, gdy wygląd jest ciężki; mocne style ilustracyjne mogą potrzebować trochę powyżej 1. Nie układaj trzech plików, zanim jeden się nie sprawdzi. Jeśli plik wymaga frazy wyzwalającej, wykonaj też samą frazę bez LoRA; sam tekst może zmienić obraz bazowy.

Jeśli plik realizmu wygląda woskowo lub przesadnie ostro, powtórz najlepszą siłę z Prompt adherence na 2.5 i tym samym seedem. Prompt adherence ustala, jak ściśle obraz trzyma się promptu; to nie jest siła adaptera.

Potem uruchom to w kodzie

Ta sama kontrola i trzy stopnie siły, z seedem i każdym innym polem stałymi. Zainstaluj Python SDK (pip install spicyapi), ustaw SPICY_API_KEY w środowisku serwera i uruchom:

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

Tworzenie, oczekiwanie, pobieranie, ponowienia i kody błędów opisuje przewodnik po zadaniach oraz referencja Python SDK. Wagi są pobierane przy każdym zadaniu, więc pierwsze wywołanie z dużym plikiem jest wolniejsze niż zwykły przebieg (patrz Uruchom własną LoRA na hostowanym API).

Albo niech to wykona Agent

Gdy asystent ma przeprowadzić porównanie, wszystkie trzy oficjalne narzędzia pokazują cenę i pytają przed płatnym wywołaniem.

• CLI. Umieść obiekt input jednego warunku w input.json, a potem:

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

Zobacz dokumentację CLI; npx @spicyapi/cli działa bez instalacji.

• Serwer MCP. Dodaj serwer MCP do asystenta, a następnie poproś: "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." Wywołuje spicyapi_task_create, które zatrzymuje się na potwierdzeniu ceny, a potem spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill instaluje Agent Skill, dzięki któremu asystent programistyczny czyta rzeczywisty schemat modelu zamiast zgadywać pola.

Nie myl tych regulatorów

Zadanie oferuje dziewięć proporcji (od 21:9 do 9:21, wszystkie około jednego megapiksela i jednej ceny), ale nie ma rozdzielczości ani osobnych pól szerokości i wysokości, nie ma wejścia obrazu ani maski. Wpis z scale: 0 może mimo to pobrać plik, więc nie zastępuje kontroli z pustą listą.

Napraw nieudaną próbę z adapterem

Porównaj naczynie, krawędź ucha i ścianę w tej samej wielkości wyświetlania i wybieraj według stylizacji oraz użytecznej struktury, a nie według tego, ile się zmieniło.

Użyj edytora, gdy źródło ma prowadzić obraz

FLUX.1 Dev LoRA edycja to drugie zadanie w tym samym modelu, również 0,018 $ za obraz. Wymaga image_url i prompt i przyjmuje tę samą listę loras, guidance oraz kroki. Nowe są dwa regulatory: strength (od 0 do 1, domyślnie 0.8), które ustala, jak daleko wynik odchodzi od źródła, oraz opcjonalny mask_url, czarno-biały obraz tego samego rozmiaru, w którym białe jest przerysowywane, a czarne zachowywane. Źródło i maska są ograniczone do 10 MB każde i każde może być publicznym linkiem do pliku.

Przy domyślnej 0.8 poza i układ się utrzymują; około 0.95 model przerysowuje prawie wszystko. Zacznij od 0.8 i idź krokami po 0.05, zmieniając w jednym przebiegu tylko siłę albo skalę LoRA: jeśli źródło przebija, podnieś wartość; jeśli kształt się rozjeżdża, obniż. Z maską użyj od 0.9 do 1, żeby biały obszar naprawdę się zmienił, i opisz wyłącznie to, co ma być w białym obszarze.

Praktyczne zastosowanie przy tym briefie: zostaw zatwierdzony dzbanek i przerób styl całego otoczenia. W Playground otwórz zadanie edycji, wstaw obraz kontrolny w Input image, pomaluj ścianę i len na biało, a dzbanek na czarno w obrazie tego samego rozmiaru i dodaj go w Advanced parameters jako Mask, następnie ustaw Transformation strength na 0.95, dodaj wagi w Style LoRAs i użyj promptu tylko dla nowej stylizacji: "Cream linen with deep folds and a quiet plaster wall, soft daylight from the left, restrained film grain." Zachowaj seed, Prompt adherence 3.5 i Sampling steps 28 z kontroli. W żądaniach API te same pola to image_url, mask_url, strength i loras w modelu black-forest-labs/flux-1-dev-lora/edit.

Zmiękczyj krawędź maski albo podążaj za konturem przedmiotu; twardy prostokąt zostawia widoczne przejście. Edycja idzie za kształtem źródła, więc nie ma pola aspect_ratio, a wynik wraca z około 0.7 megapiksela (źródło 1024 x 1536 wraca jako 672 x 1008), czyli mniejszy niż kadr tekst na obraz. Gdy dokładne piksele produktu są obowiązkowe, zostaw oryginalną warstwę produktu na osobno przygotowanym tle i potraktuj to składanie jako wykończenie.

Materiały referencyjne do briefu: zdjęcie, rysunek i próbki glazury.

Treści dla dorosłych: co LoRA zmienia, a czego nie

FLUX.1 Dev LoRA to ścieżka bez cenzury: SpicyAPI nie dodaje filtra treści platformy, a LoRA ukierunkowane na dorosłych wczytują się i renderują. Wczytanie LoRA nie ustala zakresu treści; o tym, co wróci, nadal decyduje model bazowy. Na podstawie naszych testów z września 2026 zwykły model dostarczał z tekstu sugestywne obrazy NSFW oraz obrazy NSFW górnej części ciała, a prośby o całą sylwetkę i o dwie osoby łagodził. Po wczytaniu LoRA dla dorosłych najsilniejsza próba dała zaawansowane obrazy NSFW, ale nigdy sceny o najwyższym nasileniu. W edycji prośba o tors na ubranym portrecie wróciła zgodnie z prośbą przy sile 0.95 (z LoRA lub bez) i przy 1 z maską, ale przy 0.85 została złagodzona, więc podnieś siłę, zanim zmienisz model. Czy FLUX jest bez cenzury? zawiera wyniki poziom po poziomie.

Styl LoRA o charakterze fotograficznym zmienia wygląd, nie zakres treści. Korzystaj wyłącznie z fikcyjnych dorosłych albo osób, które wyraziły udokumentowaną zgodę.

Co dalej

Jeśli zwykły przebieg już spełnia brief, zostaw LoRA poza. Aby sprawdzić nowy plik pod kątem złych linków i martwych wag w całej bibliotece, zobacz Uruchom własną LoRA na hostowanym API. Tę samą metodę kontroli najpierw na innej bazie opisuje test Z-Image Turbo LoRA z tym samym seedem.