Question 1

Jak zacząć korzystać z aplikacji?

Accepted Answer

Załóż konto, a następnie w zakładce Ustawienia podaj Webflow API Token oraz Site ID swojej witryny. Następnie kliknij „Scan CMS Collections” na stronie Dashboard. W ciągu kilku minut zobaczysz wszystkie zdjęcia z Twojego Webflow CMS.

Question 2

Ile kosztuje jeden kredyt i do czego służy?

Accepted Answer

Jeden kredyt kosztuje $0.15 USD. Kredyty są zużywane przy odblokowaniu szczegółów zdjęcia (rozmiar pliku, wymiary) oraz przy wykonaniu pełnej optymalizacji. Każde nowe konto otrzymuje 10 darmowych kredytów startowych do przetestowania aplikacji.

Question 3

Gdzie znajdę swój Webflow API Token?

Accepted Answer

Zaloguj się do panelu Webflow i przejdź do Settings → Apps & Integrations → API Access → Generate API Token. Upewnij się, że token ma uprawnienia do odczytu i zapisu kolekcji CMS. Skopiuj go i wklej w zakładce Ustawienia aplikacji.

Question 4

Jakie formaty zdjęć są obsługiwane?

Accepted Answer

Aplikacja obsługuje pliki JPG, JPEG i PNG. Wszystkie są automatycznie konwertowane do nowoczesnego formatu WebP lub AVIF, który przy tej samej jakości wizualnej zajmuje nawet 60–80% mniej miejsca niż oryginał.

Question 5

Co to jest alt-text i dlaczego jest ważny?

Accepted Answer

Tekst alternatywny (alt-text) to opis zdjęcia widoczny dla wyszukiwarek i czytników ekranowych. Poprawia widoczność strony w Google oraz dostępność dla osób niedowidzących. Aplikacja generuje je automatycznie za pomocą AI Gemini Vision w języku wybranym w ustawieniach.

Question 6

Czy moje zdjęcia są bezpiecznie przechowywane?

Accepted Answer

Aplikacja nie przechowuje trwale Twoich plików graficznych. Zdjęcia są pobierane z Webflow, przetwarzane w pamięci serwera i natychmiast publikowane z powrotem do CMS. Twój Webflow API Token jest szyfrowany w bazie danych i nigdy nie jest ujawniany osobom trzecim.

Question 7

Jak działa tryb kompresji Lossy i nearLossless?

Accepted Answer

Lossy (domyślny) to kompresja stratna — bezpowrotnie usuwa drobne detale niewidoczne gołym okiem, dzięki czemu pliki są mniejsze o 60–80% przy zachowaniu bardzo dobrej jakości. Poziom jakości regulujesz suwakiem (domyślnie 80%).

NearLossless („prawie bezstratny”) niczego nie wyrzuca — zapisuje te same detale w sprytniejszy, bardziej oszczędny sposób (podobnie jak archiwum ZIP pakuje pliki bez utraty zawartości). Obraz pozostaje praktycznie identyczny z oryginałem, ale pliki są mniejsze tylko o 20–40%.

Do większości zastosowań — zdjęć na stronę, blog czy sklep — rekomendujemy tryb Lossy: daje znacznie mniejsze pliki przy jakości nieodróżnialnej dla oka. NearLossless wybieraj, gdy zależy Ci na maksymalnej wierności, np. przy grafikach z ostrymi krawędziami, tekstem lub logotypach.

Question 8

Czy aplikacja obsługuje wiele witryn Webflow?

Accepted Answer

Tak! Możesz dodać kilka witryn Webflow do jednego konta. Przełączaj się między nimi używając selektora witryn widocznego u góry strony (np. „DTC”). Każda witryna ma oddzielne ustawienia, historię transakcji i osobne dane CMS.

Question 9

Co zrobić, gdy pojawia się błąd podczas skanowania CMS?

Accepted Answer

Najczęstszą przyczyną jest nieprawidłowy API Token lub Site ID — sprawdź je w zakładce Ustawienia. Upewnij się, że token ma uprawnienia do odczytu kolekcji CMS. Jeśli problem nadal występuje, skontaktuj się z nami przez formularz poniżej lub WhatsApp, podając komunikat błędu.

Question 10

Jak sprawdzić historię transakcji i pobrać faktury?

Accepted Answer

Całą historię zakupów i zużycia kredytów znajdziesz w zakładce Konto. Widoczne są wszystkie operacje z datą, typem (zakup / zużycie / darmowe) i liczbą kredytów. Faktury do zakupów przez Stripe są wysyłane automatycznie na adres e-mail podany przy rejestracji.

Question 11

Co zrobić, gdy pojawia się błąd podczas optymalizacji pliku?

Accepted Answer

Najczęstsza przyczyna to witryna w Webflow, która nigdy nie została opublikowana — Webflow nie pozwala wtedy zapisać zmian w CMS i publikacja kończy się błędem. Opublikuj witrynę raz w Webflow Designer (przycisk Publish) i ponów optymalizację.

Inne możliwe przyczyny:
• API Token z niewystarczającymi uprawnieniami
• przejściowe przeciążenie usługi AI — spróbuj ponownie za chwilę
• problem z pobraniem pliku

Token API powinien mieć uprawnienia:
• Sites — Read
• CMS — Read and write
• Assets — Read and write

Jeśli błąd się powtarza, napisz do nas, podając treść komunikatu.

Question 12

Czy mogę samodzielnie dodawać i edytować alt-texty bez kredytów?

Accepted Answer

Tak. W zakładce Obrazy możesz ręcznie wpisać własny alt-text dla dowolnego zdjęcia i zapisać go bezpośrednio do Webflow — bez zużywania kredytów i bez limitu liczby zdjęć. Wszystko odbywa się w jednym wygodnym, centralnym miejscu: edytujesz tekst przy zdjęciu i klikasz „Opublikuj w Webflow”. Nie używając kredytów, teksty Alt wymyślasz samodzielnie.

Question 13

Kiedy potrzebuję kredytów?

Accepted Answer

Gdy chcesz, aby aplikacja wykonała za Ciebie poszczególne operacje. Zaliczają się do nich:
• stworzenie świetnego alt-textu,
• stworzenie świetnej nazwy pliku zgodnej z SEO,
• skonwertowanie formatu pliku do WebP lub AVIF,
• skompresowanie zdjęcia,
• redukcja wymiarów zdjęcia,
• usunięcie zdjęcia w Webflow CMS i wgranie nowego,
• opublikowanie zdjęcia w Webflow.

Question 14

Co się dzieje, gdy skończą mi się kredyty?

Accepted Answer

Gdy zabraknie kredytów, operacje płatne (generowanie alt-textów i nazw plików, konwersja, kompresja oraz publikacja) zostaną wstrzymane. Konto możesz doładować w każdej chwili w zakładce Konto. Ręczne wpisywanie i zapisywanie alt-textów pozostaje bezpłatne.

Question 15

Czy mogę zoptymalizować wiele zdjęć naraz?

Accepted Answer

Tak. W zakładce Obrazy zaznacz wybrane zdjęcia (lub wszystkie) i uruchom optymalizację przyciskiem „Optymalizuj i zastąp pliki” — aplikacja przetworzy całą partię jednym kliknięciem.

Question 16

Czy mogę edytować nazwy plików lub alt-texty przed publikacją?

Accepted Answer

Jeśli chcesz zweryfikować alt-texty i nazwy plików przed publikacją, użyj przycisku „Rekomenduj teksty alt i nazwy plików”. Po ich wygenerowaniu przejrzyj propozycje, w razie potrzeby popraw je ręcznie, a gdy będziesz gotowy — opublikuj je w Webflow przyciskiem „Optymalizuj i zastąp pliki”.

Question 17

Co mogę zrobić, jeśli nazwy plików lub alt-texty mi się nie podobają?

Accepted Answer

Użyj opcji „Rekomenduj teksty alt i nazwy plików”. Po wygenerowaniu propozycji przejrzyj je, w razie potrzeby popraw ręcznie, a gdy będziesz gotowy — opublikuj je w Webflow przyciskiem „Optymalizuj i zastąp pliki”.

Question 18

Jak mogę znaleźć zdjęcia, na które zużyłem kredyty?

Accepted Answer

W zakładce Obrazy, w górnej części strony, znajdź sekcję „Filtry obrazów”, a w niej opcję „Przydzielone kredyty”. Wyfiltruje ona zdjęcia, do których przydzielono kredyty.

Question 19

Czy mogę zmienić poziom kompresji lub maksymalną szerokość zdjęć?

Accepted Answer

Tak. W zakładce Ustawienia wybierzesz tryb kompresji (Lossy lub nearLossless) oraz poziom jakości suwakiem, a także ustawisz maksymalną szerokość zdjęć — większe zdjęcia zostaną proporcjonalnie zmniejszone podczas optymalizacji.

Question 20

W jakim języku powstają alt-texty i jak to zmienić?

Accepted Answer

Alt-texty są generowane w języku wybranym w zakładce Ustawienia. Zmiana języka w ustawieniach sprawi, że kolejne generowane opisy powstaną w nowym języku.

Question 21

Czy optymalizacja jest odwracalna i czy warto zrobić kopię zapasową?

Accepted Answer

Optymalizacja zastępuje zdjęcie w Webflow CMS nowym plikiem WebP lub AVIF — w aplikacji nie ma przycisku cofania. Dlatego przed masową optymalizacją zalecamy zduplikowanie witryny w Webflow (Designer → menu witryny → Duplicate), aby zachować kopię zapasową.

Question 22

Czy aplikacja optymalizuje także zdjęcia na podstronach statycznych w Webflow?

Accepted Answer

Nie — i nie wynika to z ograniczeń aplikacji, lecz z samego API Webflow. Przez API (token) Webflow pozwala zarządzać zdjęciami tylko w kolekcjach CMS oraz tekstem stron. Zdjęć osadzonych bezpośrednio na stronach statycznych (np. strona główna czy Kontakt) nie da się przez API podmienić ani zoptymalizować — Webflow wprost zaznacza w swojej dokumentacji, że aktualizacja zdjęć nie jest obsługiwana przez API, a takie grafiki trzeba zmienić ręcznie w Webflow Designer. Nawet szersze uprawnienia tokena (np. „Pages”) dotyczą danych i tekstu stron, nie podmiany grafik. Dlatego aplikacja optymalizuje zdjęcia z CMS, gdzie API daje pełną kontrolę.

Question 23

Ile kredytów zużywa jedno zdjęcie?

Accepted Answer

Jeden kredyt odblokowuje jedno zdjęcie — to jeden kredyt za sztukę. Odblokowanie obejmuje cały zestaw operacji dla tego zdjęcia: podgląd szczegółów (rozmiar, wymiary), wygenerowanie alt-textu i nazwy pliku przez AI oraz pełną optymalizację. Co ważne, płacisz tylko raz: gdy zdjęcie jest już odblokowane, kolejne operacje na nim są bezpłatne. Koszt jednego kredytu to $0.15 USD.

Question 24

Czy odzyskam kredyty, jeśli optymalizacja się nie powiedzie?

Accepted Answer

Kredyt pobierany jest raz — za odblokowanie zdjęcia, a nie za każdą próbę. Jeśli optymalizacja się nie powiedzie, zdjęcie pozostaje odblokowane, więc możesz ponowić ją (lub wygenerowanie tekstów) bez ponownego pobrania kredytu. Nie ma automatycznego zwrotu do salda, ale też nie zapłacisz drugi raz za to samo zdjęcie.

Question 25

Jak długo trwa skan / optymalizacja?

Accepted Answer

Skan CMS zwykle trwa od kilkunastu sekund do kilku minut — zależnie od liczby kolekcji i zdjęć w Twojej witrynie. Optymalizacja to kilka sekund na zdjęcie (pobranie pliku, analiza AI, kompresja do WebP/AVIF, wgranie i publikacja w Webflow), więc czas całej partii zależy od liczby zaznaczonych zdjęć. Postęp widzisz na bieżąco na pasku postępu.

Question 26

Dlaczego WebP/AVIF i czy wszystkie przeglądarki je obsługują?

Accepted Answer

WebP i AVIF to nowoczesne formaty, które przy tej samej jakości wizualnej ważą znacznie mniej niż JPG czy PNG — WebP zwykle o 60–80%, a AVIF jest zwykle jeszcze o 20–50% lżejszy od WebP. Mniejsze pliki to szybsze ładowanie strony, lepsze wyniki Core Web Vitals i wyższa pozycja w Google. Optymalizator domyślnie używa AVIF (w Ustawieniach możesz przełączyć na WebP). Wsparcie jest praktycznie powszechne: WebP obsługują wszystkie nowoczesne przeglądarki, a AVIF — Chrome, Firefox, Edge, Opera oraz Safari (od wersji 16.4), co obejmuje zdecydowaną większość użytkowników. Uwaga: AVIF nie jest zalecany dla obrazów Open Graph (udostępnianie w social media) — tam lepiej użyć WebP.

Jak możemy Ci pomóc?

Poradniki krok po kroku

Konfiguracja aplikacji

Zarządzanie tekstami alt bez kredytów

Często zadawane pytania

Napisz do nas

Formularz kontaktowy

Chat na WhatsApp