Najczęściej zadawane pytania
Wszystko, co musisz wiedzieć o Pexafy. Nie znajdujesz odpowiedzi? Skontaktuj się z nami.
Pierwsze kroki
Czym jest Pexafy?
Pexafy to oparte na sztucznej inteligencji wyszukiwarki obrazów, które agreguje miliony bezpłatnych i premium zdjęć z wielu źródeł — Unsplash, Pexels, Pixabay, Wikimedia Commons i innych — w jednym API. Zamiast integrować dziesiątki usług graficznych, wysyłasz jedno żądanie do Pexafy i otrzymujesz najlepsze wyniki ze wszystkich źródeł, posortowane według semantycznej trafności AI.
Jak uzyskać klucz API?
Załóż bezpłatne konto na pexafy.com/auth/register/, a następnie przejdź do Dashboard → API Keys → Create Key. Twój pierwszy klucz zostanie utworzony natychmiast — bez podawania karty kredytowej. Plan bezpłatny obejmuje 1K żądań API miesięcznie.
Czy Pexafy jest bezpłatne?
Tak! Nasz plan Free daje Ci 1K żądań API miesięcznie — bez karty kredytowej. Możesz wyszukiwać za pomocą zapytań tekstowych i korzystać ze wszystkich bezpłatnych źródeł obrazów. Potrzebujesz więcej żądań, obrazów premium lub wyszukiwania obraz-do-obrazu? Sprawdź naszą stronę z cennikiem, aby poznać plany Pro i Business.
Jakie źródła obrazów przeszukuje Pexafy?
Pexafy agreguje obecnie obrazy z Unsplash, Pexels, Pixabay, Wikimedia Commons i Openverse. Stale dodajemy nowe źródła. Możesz filtrować wyniki według źródła, używając parametru source w API.
Czym Pexafy różni się od Google Images?
Pexafy to API stworzone z myślą o deweloperach, a nie konsumencka wyszukiwarka. Agregujemy wyłącznie źródła bezpłatne i objęte licencjami Creative Commons, dzięki czemu każdy wynik jest bezpieczny do wykorzystania w Twoim produkcie. Nasz model AI rozumie semantyczne znaczenie — wpisz „cozy autumn vibes
Czy oferujecie SDK lub biblioteki klienckie?
Obecnie udostępniamy REST API z wyczerpującą dokumentacją. Oficjalne SDK dla języków Python, JavaScript/TypeScript i PHP są w planach. W międzyczasie integracja z API jest prosta — wystarczy jedno żądanie HTTPS z nagłówkiem klucza API. Zajrzyj do naszej dokumentacji, aby znaleźć przykłady kodu w kilku językach.
API i kwestie techniczne
Jaki jest limit żądań API?
Limity żądań zależą od Twojego planu: Free — 20 żądań/minutę, Pro — 60 żądań/minutę, Business — 300 żądań/minutę. Po przekroczeniu limitu otrzymasz odpowiedź 429 Too Many Requests z nagłówkiem Retry-After informującym, kiedy możesz ponowić żądanie.
Jakie formaty zwraca API?
Wszystkie odpowiedzi są w formacie JSON ze standardową kopertą: {success, data, meta, pagination, error}. Każdy obiekt zdjęcia zawiera: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors oraz relevance score.
Jak obsługiwać paginację?
Pexafy stosuje paginację opartą na kursorze. Każda odpowiedź zawiera wartość pagination.next_cursor. Przekaż ją jako parametr cursor w kolejnym żądaniu, aby pobrać następną stronę. Gdy next_cursor ma wartość null, oznacza to koniec wyników.
Czy mogę filtrować wyniki wyszukiwania?
Tak! Możesz filtrować według: color_name (red, blue, green…), color_hex (np. #FF5733 z opcjonalnym color_tolerance), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…) oraz score_threshold (minimalna trafność 0.0–1.0). Łącz filtry, aby uzyskać precyzyjne wyniki.
Jak uwierzytelniać żądania API?
Dodaj klucz API jako nagłówek żądania: X-Api-Key: pxfy_your_key_here. Możesz też skorzystać z uwierzytelniania tokenem Bearer: Authorization: Bearer <jwt_token>. Nigdy nie umieszczaj klucza API w kodzie po stronie klienta.
Jaka jest maksymalna liczba wyników na jedno żądanie?
Możesz żądać do 80 wyników na stronę za pomocą parametru per_page (domyślnie 20). W przypadku dużych zestawów wyników użyj paginacji opartej na kursorze, aby pobierać kolejne strony. Nie ma ograniczeń dotyczących łącznej liczby stron, przez które możesz paginować.
Czy Pexafy obsługuje wielojęzyczne zapytania wyszukiwania?
Tak! Nasz model został wytrenowany na wielojęzycznych danych, więc możesz wyszukiwać w języku angielskim, francuskim, hiszpańskim, niemieckim, portugalskim i wielu innych. Rozumienie semantyczne działa najlepiej w języku angielskim, ale większość typowych zapytań w innych językach daje dokładne wyniki. Dla maksymalnej precyzji zalecamy język angielski.
Rozliczenia i plany
Czy mogę zmienić swój plan?
Tak, możesz w dowolnym momencie zmienić plan na wyższy lub niższy w Panelu → Rozliczenia. Ulepszenia wchodzą w życie natychmiast z rozliczeniem proporcjonalnym. Obniżenia planu wchodzą w życie po zakończeniu bieżącego okresu rozliczeniowego. Wszystko jest obsługiwane automatycznie przez Stripe.
Co się stanie, jeśli przekroczę swój limit?
Żądania API są blokowane po osiągnięciu miesięcznego limitu — otrzymasz odpowiedź 429 z informacyjnym komunikatem o błędzie. Aby kontynuować korzystanie z API, zaktualizuj plan do wyższego w Panelu → Rozliczenia.
Czy oferujecie zwroty pieniędzy?
Oferujemy 14-dniową gwarancję zwrotu pieniędzy na wszystkie płatne plany. Jeśli nie jesteś zadowolony w ciągu pierwszych 14 dni od subskrypcji, skontaktuj się z nami pod adresem [email protected], a my wystawimy pełny zwrot — bez żadnych pytań.
Jakie metody płatności akceptujecie?
Akceptujemy wszystkie główne karty kredytowe i debetowe (Visa, Mastercard, American Express), a także Apple Pay i Google Pay — wszystkie przetwarzane bezpiecznie przez Stripe. Nie przechowujemy żadnych danych płatniczych na naszych serwerach.
Czy wymagana jest długoterminowa umowa?
Bez umów, bez zobowiązań. Wszystkie plany są miesięczne (lub roczne z rabatem, jeśli wybierzesz). Anuluj w dowolnym momencie w Panelu → Rozliczenia jednym kliknięciem. Dostęp obowiązuje do końca bieżącego okresu rozliczeniowego.
Czy jest dostępny rabat roczny?
Tak! Płatność roczna pozwala zaoszczędzić około 17%: Pro kosztuje $290/rok ($24/miesiąc) zamiast $29/miesiąc. Business kosztuje $2990/rok ($249/miesiąc) zamiast $299/miesiąc. Przejdź na rozliczenie roczne w Panelu → Rozliczenia.
Czy oferujecie niestandardowe plany enterprise?
Tak! Jeśli Twoje potrzeby przekraczają plan Business — wyższe limity żądań, dedykowana infrastruktura, niestandardowe SLA lub wdrożenie lokalne — skontaktuj się z nami pod adresem [email protected], podając swoje wymagania. Przygotujemy dopasowany plan dla Twojej organizacji.
Jakie waluty obsługujecie przy płatności?
Wszystkie ceny są podane w USD. Stripe, nasz procesor płatności, automatycznie przelicza na Twoją lokalną walutę przy kasie. Twój bank może naliczyć niewielką opłatę za przewalutowanie w zależności od rodzaju karty i kraju.
Zdjęcia i licencje
Czy Pexafy jest właścicielem zdjęć?
Nie. Pexafy jest wyszukiwarką — indeksujemy i przeszukujemy zdjęcia hostowane na platformach zewnętrznych (Unsplash, Pexels, Pixabay itp.). Nie przechowujemy, nie hostujemy ani nie redystrybuujemy faktycznych plików graficznych. Wszystkie zdjęcia pozostają własnością odpowiednich fotografów i platform.
Czy mogę wykorzystywać zdjęcia do celów komercyjnych?
To zależy od licencji źródłowej. Unsplash, Pexels i Pixabay oferują bezpłatne licencje do użytku komercyjnego dla większości swoich zdjęć. Wikimedia Commons i Openverse stosują różne licencje Creative Commons — niektóre zezwalają na użytek komercyjny, inne nie. Zawsze sprawdzaj pole licencji w odpowiedzi API i weryfikuj na źródłowym URL przed komercyjnym wykorzystaniem zdjęcia.
Czym różnią się obrazy premium?
Obrazy premium pojawiają się w wynikach wyszukiwania, ale ich pobranie w pełnej rozdzielczości może wymagać subskrypcji lub zakupu w serwisie źródłowym. API zwraca podglądy/miniatury dla wszystkich obrazów. W planach Free i Pro adres URL źródła zawarty w odpowiedzi wskaże, gdzie uzyskać dostęp do pełnego obrazu.
Czy mogę pobierać obrazy za pośrednictwem API?
Pexafy zwraca adresy URL obrazów hostowanych na ich oryginalnych platformach — nie udostępniamy plików obrazów bezpośrednio przez API. W przypadku darmowych obrazów (Unsplash, Pexels, Pixabay) możesz pobrać obraz w pełnej rozdzielczości z adresu URL źródła podanego w odpowiedzi. Zawsze przestrzegaj warunków korzystania z usługi platformy źródłowej.
Jak często aktualizowany jest indeks obrazów?
Nasz potok indeksowania działa codziennie dla wszystkich głównych źródeł. Nowe obrazy przesłane do Unsplash, Pexels, Pixabay i innych platform są zazwyczaj dostępne do wyszukiwania w Pexafy w ciągu 24–48 godzin. Nasz indeks zawiera obecnie ponad 5 milionów obrazów i każdego dnia się powiększa.
Konto i bezpieczeństwo
Jak usunąć konto?
Przejdź do Pulpit → Ustawienia → Strefa niebezpieczna → Usuń konto. Usunięcie konta jest trwałe i powoduje usunięcie wszystkich kluczy API, historii użytkowania oraz danych osobowych. Możesz również wysłać do nas wiadomość na adres [email protected] z prośbą o usunięcie danych na podstawie RODO/prawa do bycia zapomnianym.
Czy moje dane są bezpieczne?
Tak. Używamy HTTPS wszędzie, bcrypt do hashowania haseł i przechowujemy sesje w Redis z krótkotrwałymi tokenami JWT. Nie sprzedajemy ani nie udostępniamy Twoich danych stronom trzecim. Klucze API są hashowane przed zapisem. Pełne informacje o praktykach dotyczących danych znajdziesz w naszej Polityce prywatności.
Czy mogę mieć wiele kluczy API?
Tak, w zależności od planu: Free (1 klucz), Pro (5 klucze), Business (∞ kluczy). Wiele kluczy pozwala rozdzielić użycie według aplikacji, środowiska (dev/staging/prod) lub członka zespołu, a także unieważniać poszczególne klucze bez wpływu na pozostałe.
Co zrobić, gdy mój klucz API zostanie skompromitowany?
Natychmiast unieważnij skompromitowany klucz w Pulpit → Klucze API i utwórz nowy. Unieważnienie działa natychmiastowo — wszelkie żądania używające starego klucza zostaną odrzucone z błędem 401. Nigdy nie umieszczaj kluczy API w systemie kontroli wersji; zamiast tego używaj zmiennych środowiskowych.
Jaka jest gwarancja dostępności usługi?
Naszym celem jest dostępność API na poziomie 99,9%. Klienci planu Business otrzymują umowę SLA z gwarantowanym poziomem dostępności. Bieżący i historyczny status usługi możesz monitorować na naszej stronie Status, dostępnej z stopki tej witryny.
Czy Pexafy jest zgodny z RODO?
Tak. Zbieramy wyłącznie minimalne dane niezbędne do świadczenia usługi (adres e-mail, hashowane hasło, logi użytkowania). Nie sprzedajemy danych stronom trzecim. W dowolnym momencie możesz zażądać pełnego eksportu lub usunięcia danych z poziomu Pulpit → Ustawienia lub wysyłając wiadomość na adres [email protected]. Szczegóły znajdziesz w naszej Polityce prywatności.
Żadne pytania nie pasują do wyszukiwania. Spróbuj innego hasła.
Zapytaj nas bezpośrednioMasz jeszcze pytania?
Nie znajdujesz tego, czego szukasz? Nasz zespół chętnie pomoże.
Skontaktuj się z pomocą Przeczytaj dokumentację API