nanobanana-pro-fallback

Umiejętność do generowania i edycji obrazów poprzez API Gemini z wbudowanym mechanizmem fallbacku — jeśli jeden model zawiedzie, system automatycznie przełączy się na alternatywny. Obsługuje zarówno generowanie z tekstu, jak i edycję istniejących obrazów, z możliwością łączenia do 14 obrazów w jedną kompozycję. Dostępne rozdzielczości: 1K, 2K i 4K. Wymaga klucza API Gemini i narzędzia uv do uruchomienia.

1. Zainstaluj narzędzie uv, jeśli jeszcze go nie masz — jest to wymagane do uruchomienia skryptu. Sprawdź, czy polecenie uv działa w terminalu.

2. Ustaw zmienną środowiskową GEMINI_API_KEY z Twoim kluczem API Gemini. Możesz to zrobić w bieżącej sesji terminala lub dodać do pliku konfiguracyjnego agenta.

3. Aby wygenerować obraz z opisu tekstowego, użyj polecenia: uv run {baseDir}/scripts/generate_image.py --prompt "Twój opis obrazu" --filename "output.png" --resolution 1K. Zastąp "Twój opis obrazu" rzeczywistym opisem, a 1K zmień na 2K lub 4K w zależności od potrzebnej rozdzielczości.

4. Aby edytować istniejący obraz, dodaj flagę -i ze ścieżką do pliku wejściowego: uv run {baseDir}/scripts/generate_image.py --prompt "instrukcje edycji" --filename "output.png" -i "/ścieżka/do/obrazu.png" --resolution 2K.

5. Jeśli chcesz połączyć wiele obrazów w jedną kompozycję, podaj każdy plik z osobną flagą -i: uv run {baseDir}/scripts/generate_image.py --prompt "połącz w jedną scenę" --filename "output.png" -i obraz1.png -i obraz2.png -i obraz3.png. Możesz użyć do 14 obrazów jednocześnie.

6. Zawsze używaj uv run do uruchomienia skryptu — bezpośrednie użycie python3 nie zadziała, ponieważ zależności nie będą dostępne. Jeśli prefetujesz, możesz też użyć skryptu opakowującego: {baseDir}/scripts/generate --prompt "opis" --filename "output.png" --resolution 1K.