Najczęściej zadawane pytania
Wszystko, co musisz wiedzieć o Pexafy. Nie znajdujesz odpowiedzi? Skontaktuj się z nami.
Pierwsze kroki
Czym jest Pexafy?
Pexafy to oparta na sztucznej inteligencji wyszukiwarka obrazów, która agreguje miliony darmowych zdjęć z 9 źródeł — Unsplash, Pexels, Pixabay, Kaboompics, Burst i innych — w jednym API. Jedno żądanie Pexafy = jedno wyszukiwanie semantyczne obejmujące wszystkie 9 źródła. Korzystając z własnych API dostawców, to samo wyszukiwanie wymaga 3–5 wywołań, a do tego logiki łączenia i normalizacji JSON — kodu, który sam piszesz, utrzymujesz i za który płacisz.
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 5K żądań API miesięcznie.
Czy muszę ubiegać się o zatwierdzenie aplikacji?
Nie. Twój klucz działa od pierwszego wywołania: bez weryfikacji aplikacji, bez okresu oczekiwania i bez obowiązkowego wywołania śledzącego pobieranie przy każdym pobraniu. Unsplash ogranicza niezatwierdzone aplikacje do 50 żądań/godzinę do czasu weryfikacji; Pexels zezwala na 200/godzinę.
Czy Pexafy jest bezpłatne?
Tak! Nasz plan Free daje 5K zapytań API miesięcznie — bez karty kredytowej — i przeszukuje wszystkie źródła indeksowane przez Pexafy, tak jak każdy inny plan. Potrzebujesz więcej zapytań? Płatne plany, od Starter do Enterprise, podnoszą limity: zajrzyj na naszą stronę z cennikiem.
Jakie źródła obrazów przeszukuje Pexafy?
Pexafy agreguje obecnie 9 źródeł, z czego największe to Unsplash, Pexels, Pixabay, Kaboompics, Burst. Stale dodajemy kolejne. 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, zmieniaj plan w dowolnym momencie w Panel → Rozliczenia. Zmiana działa od razu, a Creem, nasz odsprzedawca, rozlicza ją proporcjonalnie: przejście na wyższy plan obciąża Cię różnicą ceny za resztę bieżącego okresu, przejście na niższy plan zwraca tę różnicę.
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ń. Creem, nasz odsprzedawca, zwraca pieniądze na pierwotną metodę płatności. Szczegóły w naszej polityce zwrotów: pexafy.com/legal/refund/
Jakie metody płatności akceptujecie?
Płatności obsługuje Creem, nasz odsprzedawca i Merchant of Record. Możesz zapłacić kartą kredytową lub debetową albo innymi metodami płatności, które Creem oferuje przy kasie w Twoim kraju. Nigdy nie widzimy ani nie przechowujemy danych Twojej karty.
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ć do 18%: Pro kosztuje $199/rok ($17/miesiąc) zamiast $19/miesiąc. Business kosztuje $2599/rok ($217/miesiąc) zamiast $249/miesiąc. Przejdź na rozliczenie roczne w Panelu → Rozliczenia.
Czy oferujecie niestandardowe plany enterprise?
Tak! Jeśli Twoje potrzeby przekraczają plan Enterprise — 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 podane są w USD, a Creem, nasz odsprzedawca, pobiera je w USD. W zależności od kraju przy płatności mogą zostać doliczone podatki, takie jak VAT. Jeśli Twoja karta jest w innej walucie, bank przeliczy kwotę i może pobrać niewielką opłatę za przewalutowanie.
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?
Zależy to od licencji danego źródła. Unsplash, Pexels i Pixabay oferują bezpłatne licencje do użytku komercyjnego dla większości swoich zdjęć, a mniejsze źródła, które indeksujemy, działają według tego samego modelu. Zawsze sprawdzaj pole licencji w odpowiedzi API i weryfikuj warunki pod adresem URL źródła przed komercyjnym wykorzystaniem obrazu.
Czy płacę za obrazy?
Nie. Pexafy nie sprzedaje obrazów. Każdy wynik pochodzi z biblioteki do swobodnego użytku — Unsplash, Pexels, Pixabay, Kaboompics, Burst i innych — i prowadzi do niej, na licencji tej biblioteki. Twój plan opłaca wyłącznie usługę wyszukiwania: zapytania API, limity zapytań, klucze API i wsparcie. Przed użyciem obrazu sprawdź jego licencję u źródła.
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. 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 9M+ 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