gemini-api
Google Gemini 3 Pro Image API reference. Covers text-to-image, editing, reference images, aspect ratios, and error handling.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Google Gemini 3 Pro Image API reference. Covers text-to-image, editing, reference images, aspect ratios, and error handling.
How to use
Uzyskaj klucz API na stronie https://makersuite.google.com/app/apikey – zaloguj się na konto Google i utwórz nowy klucz dostępu.
Ustaw zmienną środowiskową GEMINI_API_KEY w terminalu: export GEMINI_API_KEY="twój-klucz-api". Upewnij się, że klucz jest dostępny dla procesu, w którym uruchamiasz umiejętność.
Uruchom podstawową generację obrazu poleceniem: uv run python main.py output.png "Twój opis obrazu". Zastąp opis konkretnym tekstem, np. "Minimalistyczna kostka 3D w stylu cyberpunk".
Dostosuj proporcje obrazu flagą --aspect, wybierając z dostępnych opcji: 1:1 (media społecznościowe), 16:9 (YouTube), 9:16 (mobile), 4:3 (tradycyjne zdjęcia) lub inne. Przykład: uv run python main.py output.png "Twój opis" --aspect 16:9.
Aby edytować istniejący obraz, użyj flagi --edit wraz ze ścieżką do pliku: uv run python main.py output.png "Zmień tło na niebieskie" --edit photo.jpg. Możesz też dodać obraz referencyjny flagą --ref style.png, aby utrzymać spójny styl.
W razie błędów (brak klucza, limit żądań, błąd sieci) umiejętność automatycznie ponawia próby – możesz zwiększyć liczbę prób flagą --max-retries 5. Sprawdź logi, jeśli prompt zostanie zablokowany przez politykę treści.