Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

Generowanie obrazów Flux

Instrukcje konfiguracji i użytkowania generowania obrazów Flux

Flux to potężne narzędzie do generowania obrazów, które potrafi tworzyć wysokiej jakości grafiki na podstawie opisów tekstowych. Obsługuje różne style artystyczne i oferuje szerokie możliwości dostosowywania.

Instrukcje konfiguracji

  1. Pobierz swój klucz API z bfl.ml
  2. Ustaw zmienną środowiskową FLUX_API_KEY w swoim pliku .env:
FLUX_API_KEY=your_api_key_here
  1. Zrestartuj LibreChat i dodaj Flux do listy Tools agenta.
WdrożeniePolecenie
Dockerdocker compose down && docker compose up -d
LokalneZatrzymaj serwer, a następnie ponownie uruchom npm run backend

Funkcje

Główne możliwości

  • Generuj wysokiej jakości obrazy na podstawie szczegółowych opisów tekstowych
  • Obsługa wielu stylów artystycznych
  • Konfigurowalne wymiary obrazu
  • Regulowane parametry generowania
  • Wiele opcji endpoint dla różnych przypadków użycia
  • Obsługa generowania wsadowego (do 24 obrazów)

Dostępne endpointy

  • /v1/flux-pro - Standardowy endpoint (domyślny)
  • /v1/flux-pro-1.1 - Ulepszona wersja
  • /v1/flux-dev - Wersja deweloperska
  • /v1/flux-pro-1.1-ultra - endpoint o jakości premium

Parametry

Narzędzie Flux obsługuje trzy główne akcje:

  1. generate - Utwórz nowy obraz na podstawie opisu tekstowego
  2. generate_finetuned - Utwórz obraz przy użyciu dostrojonego modelu
  3. list_finetunes - Wyświetl listę dostępnych modeli niestandardowych dla użytkownika

Dla akcji generate:

prompt – Opis tekstowy obrazu (wymagane) • width – Szerokość w pikselach (wielokrotność 32) • height – Wysokość w pikselach (wielokrotność 32) • prompt_upsampling – Czy przeprowadzić upsampling promptu (domyślnie: false) • steps – Liczba kroków dyfuzji (1-50, domyślnie: 40) • seed – Opcjonalne ziarno dla powtarzalności • safety_tolerance – Poziom tolerancji dla moderacji (0-6, domyślnie: 6) • endpoint – Używany endpoint modelu:

  • /v1/flux-pro-1.1 (domyślne)
  • /v1/flux-pro
  • /v1/flux-dev
  • /v1/flux-pro-1.1-ultraraw – Generuj mniej przetworzone obrazy (tylko dla endpointu ultra, domyślnie: false)

Dla akcji generate_finetuned:

• Wszystkie parametry z generate oraz: • finetune_id – ID dostrojonego modelu (wymagane) • finetune_strength – Siła efektu dostrajania (0.1-1.2, domyślnie: 1.1) • guidance – Skala wskazówek (guidance scale) (domyślnie: 2.5) • aspect_ratio – Proporcje obrazu dla modeli ultra (domyślnie: "16:9") • endpoint – Musi być jednym z:

  • /v1/flux-pro-finetuned (domyślne)
  • /v1/flux-pro-1.1-ultra-finetuned

Najlepsze praktyki

Pisanie promptów

  1. Bądź precyzyjny i szczegółowy w opisach
  2. Uwzględnij kluczowe elementy:
    • Tematyka
    • Styl i podejście artystyczne
    • Szczegóły kompozycji
    • Oświetlenie i atmosfera
    • Preferencje kolorów
    • Specyfikacje techniczne

Wskazówki dla najlepszych rezultatów

  • Pisz prompty w języku angielskim
  • Zrównoważ precyzję z kreatywną swobodą
  • Unikaj sprzecznych koncepcji
  • Skup się na opisach wizualnych
  • Rozważ warstwy kompozycji (pierwszy plan, drugi plan, tło)

Szczegóły techniczne

Przetwarzanie obrazów

  • Obrazy są automatycznie zapisywane i zarządzane
  • Obsługuje format wyjściowy PNG
  • Zawiera wbudowane funkcje moderacji i bezpieczeństwa
  • Asynchroniczne generowanie ze śledzeniem statusu

Funkcje integracji

  • Bezproblemowa integracja z interfejsami czatu
  • Dane wyjściowe w formacie Markdown
  • Wbudowana obsługa błędów i logowanie
  • Obsługa przetwarzania wsadowego

Przykłady użycia

Oto kilka przykładowych promptów, które dobrze współpracują z Flux:

Spokojny górski krajobraz o zachodzie słońca, ze szczytami pokrytymi śniegiem odbijającymi się w krystalicznie czystym alpejskim jeziorze. Ciepłe, złote światło oświetla pierzaste chmury, tworząc dramatyczną atmosferę. Styl fotorealistyczny z bogatymi kolorami i ostrymi detalami.

Futurystyczny pejzaż miejski nocą, z wieżowcami oświetlonymi neonami i latającymi pojazdami. Styl cyberpunk z głębokimi odcieniami błękitu i fioletu, podkreślony jasnymi neonowymi kolorami. Ulice lśniące od deszczu odbijają światła miasta, tworząc nastrojową atmosferę.

Obsługa błędów

Typowe komunikaty o błędach i ich rozwiązania:

  • Problemy z kluczem API: Sprawdź, czy Twój klucz API jest poprawnie ustawiony w zmiennych środowiskowych
  • Błędy generowania: Sprawdź długość promptu oraz wytyczne dotyczące treści
  • Błędy przekroczenia limitu czasu (Timeout errors): Mogą wystąpić przy dużym obciążeniu serwera; spróbuj ponownie po krótkiej chwili.

Limity szybkości i użycie

  • Darmowy plan obejmuje hojne limity użytkowania
  • Wiele obrazów może zostać wygenerowanych w ramach jednego żądania
  • Rozważ użycie mniejszej liczby kroków (step counts) w celu szybszego generowania podczas testowania

Jaka jest ta instrukcja?