| name | kie-generate |
| description | Generuje grafiki AI przez Kie.ai (Nano Banana 2 / Nano Banana Pro / GPT Image-2). Interaktywnie pyta o prompt i parametry, zapisuje do Marketing/media/ lub wskazanej lokalizacji. |
| allowed-tools | ["Bash","Read","Write","Glob"] |
Kie Generate
Skill do generowania grafik AI przez API Kie.ai.
Wybór modelu
Domyślnie używaj GPT Image-2 — skrypt automatycznie wybiera wariant text-to-image lub image-to-image w zależności od tego czy podano --image.
Przełączaj się tylko gdy user wprost o to poprosi:
| User mówi | Przekaż --model |
|---|
| (nic, default) | gpt-image-2 |
| "Nano", "Nano Banana", "banana" | nano-banana-2 |
| "pro", "wyższa jakość", "lepiej" | nano-banana-pro |
GPT Image-2 ograniczenia: brak --resolution i --format (skrypt je ignoruje), krótsza lista ratio (bez 1:4, 1:8, 4:1, 8:1). Jeśli user potrzebuje rozdzielczości lub formatu innego niż domyślne — przełącz na nano-banana-2.
Wymagania
W .env workspace'u:
| Zmienna | Opis | Tryby |
|---|
KIE_API_KEY | Klucz API Kie.ai (kie.ai) | wszystkie |
IMGBB_API_KEY | Klucz API ImgBB (imgbb.com/api) — temporary hosting reference images | edit, compose, remove-bg |
Biblioteki Python: requests.
Pierwsza konfiguracja: jeśli user prosi o "setup", "konfigurację", "onboarding kie-generate" — przeprowadź go przez checklistę z ONBOARDING.md.
Tryby pracy
| Tryb | Opis | Kiedy użyć |
|---|
generate | text → image | Nowa grafika od zera |
edit | image + instruction → image | Modyfikacja istniejącej grafiki |
compose | multiple images + instruction → image | Łączenie elementów z kilku obrazków |
remove-bg | image → image (transparent) | Usunięcie tła z grafiki |
Workflow
-
Rozpoznaj tryb na podstawie inputu użytkownika:
- Brak obrazków →
generate
- 1 obrazek + instrukcja edycji →
edit
- 2+ obrazków + instrukcja →
compose
- Użytkownik prosi o usunięcie tła →
remove-bg
-
Zapytaj o szczegóły (jeśli nie podane):
- Co ma być na grafice? (prompt)
- Proporcje? (domyślnie 1:1, dla social media często 16:9)
- Rozdzielczość? (1K/2K/4K, domyślnie 1K)
- Gdzie zapisać? (domyślnie
Marketing/media/)
-
Zbuduj prompt według zasad z prompting-guide.md:
- 7-elementowa struktura (styl, scena, subject, kamera, światło, tekstury, negacje)
- Wagi
(element:1.3) dla kluczowych cech
- Blok
TEXT CONTENT TO DISPLAY jeśli są konkretne teksty
-
Zastosuj brand jeśli dotyczy Akademii Automatyzacji → brand-rules.md
-
Wywołaj skrypt i poinformuj o wyniku
Użycie skryptu
python3 {baseDir}/scripts/kie_image.py generate "prompt" output.png
python3 {baseDir}/scripts/kie_image.py generate "prompt" output.png --ratio 16:9 --resolution 2K
python3 {baseDir}/scripts/kie_image.py generate "prompt" output.png --model nano-banana-pro
python3 {baseDir}/scripts/kie_image.py generate "prompt" output.png --model gpt-image-2 --ratio 16:9
python3 {baseDir}/scripts/kie_image.py edit "instruction" output.png --image input.png --model gpt-image-2
python3 {baseDir}/scripts/kie_image.py edit "instruction" output.png --image input.png
python3 {baseDir}/scripts/kie_image.py compose "instruction" output.png --image img1.png --image img2.png
python3 {baseDir}/scripts/kie_image.py remove-bg input.png output.png
Parametry
| Parametr | Opcje | Domyślnie |
|---|
--model | nano-banana-2, nano-banana-pro, gpt-image-2 | nano-banana-2 |
--ratio | 1:1, 1:4*, 1:8*, 2:3, 3:2, 3:4, 4:1*, 4:3, 4:5, 5:4, 8:1*, 9:16, 16:9, 21:9, auto | 1:1 |
--resolution | 1K, 2K, 4K | 1K |
--format | png, jpg | png |
* Proporcje 1:4, 1:8, 4:1, 8:1 — dostępne tylko w Nano Banana 2
* GPT Image-2 ignoruje --resolution i --format; ratio musi być z listy: auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4, 2:3
Proporcje - kiedy które
| Proporcja | Użycie |
|---|
1:1 | Instagram post, avatar |
16:9 | YouTube thumbnail, banner, X post |
9:16 | Instagram/TikTok story, reel |
4:3 | Prezentacja |
Domyślna lokalizacja
Zapisuj do Marketing/media/ z opisową nazwą:
Marketing/media/post-automatyzacja-2026-01-23.pngMarketing/media/infografika-korzysci-ai.png
Jak działa upload reference images
Dla trybów edit, compose, remove-bg Kie.ai wymaga publicznego URL-a dla inputowych obrazków. Skrypt uploaduje plik do ImgBB (TTL 1h, auto-delete), dostaje publiczny URL i przekazuje go do API. Limit: 32 MB na plik. Retry 3× z exponential backoff przy błędach 5xx/sieci.
Obsługa błędów
Kie.ai:
| Kod | Znaczenie |
|---|
| 401 | Sprawdź KIE_API_KEY |
| 402 | Brak środków na koncie Kie.ai |
| 429 | Rate limit — poczekaj |
ImgBB:
| Sytuacja | Rozwiązanie |
|---|
IMGBB_API_KEY not configured | Dodaj klucz do .env (imgbb.com/api) |
File too large: X MB (limit 32 MB) | Skompresuj lub zmniejsz rozdzielczość przed uploadem |
ImgBB upload failed after 3 attempts | Problem sieci/API ImgBB — spróbuj ponownie za chwilę |
Referencje
