Dokumentacja · Rate limity
Rate limity Photta API i jak poprawnie wykonywać polling
W jednym zdaniu
Photta API pozwala na 600 żądań na minutę na klucz API w stałym oknie. Błąd 429 zwraca Retry-After: 30. Wykonuj polling zadania co 3 sekundy; współbieżna praca jest ograniczona planem.
- Limity: 600 requests/min
- Retry-After: Retry-After: 30s
- Przetwarzanie: asynchroniczne, polling
Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono
Opublikowane limity
Limit, okno, ponawianie prób, rozmiar i formaty obrazów — dokładnie tak, jak podano w dokumentacji.
Limity
- 600 żądań na minutę na klucz API (Stałe okno czasowe; limit jest taki sam w każdym planie)
- Odpowiedź 429 zawiera nagłówek Retry-After: 30 s
- Do 10 MB na obraz
- Formaty: JPEG, PNG, WebP
- Jednoczesne zadania wsadowe w zależności od planu: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Tylko polling — API nie wysyła webhooków.
Współbieżna praca według planu
Ile batchy może być przetwarzanych jednocześnie, zanim wysłanie kolejnego zwróci 409.
Przetwarzane batche na plan
Free
Współbieżne: 1
Hobby
Współbieżne: 2
Seller
Współbieżne: 3
Brand
Współbieżne: 4
Studio
Współbieżne: 6
Utrzymanie się w limitach
Stałe okno
Limit jest naliczany na klucz API w stałym oknie i jest taki sam w każdym planie. Dwa klucze oznaczają podwójny budżet.
Wykonuj polling co 3 sekundy
Polling to jedyny sygnał zakończenia — API nie wysyła webhooków. 3 sekundy to udokumentowany interwał; częstsze odpytywanie marnuje budżet na puste odpowiedzi.
Stosuj exponential backoff
Po błędzie 429 odczekaj liczbę sekund wskazaną w Retry-After, a następnie zwiększaj odstęp przy każdym kolejnym niepowodzeniu, zamiast ponawiać próby ze stałą częstotliwością.
Zadania wsadowe mają osobny limit
Rate limit zlicza żądania; limit współbieżności zlicza trwające operacje w toku. Zadanie wsadowe przekraczające limit zwraca 409, a nie 429.
Pytania o rate limity
Jaki jest rate limit?
600 żądań na minutę na klucz API w stałym oknie czasowym. Dokumentacja podaje tę samą wartość dla każdego endpointu.
Jak często odpytywać (polling) o status zadania?
Co 3 sekundy. Brak webhooków sprawia, że polling jest oficjalnie udokumentowanym sposobem na sprawdzenie, czy zadanie zostało ukończone.
Ile zadań może renderować się jednocześnie?
Liczba zadań wsadowych w toku jest ograniczona planem: Free 1, Hobby 2, Seller 3, Brand 4 i Studio 6. Przekroczenie limitu powoduje zwrócenie 409.
Co zrobić w przypadku 429?
Odczytaj nagłówek Retry-After, odczekaj tyle sekund, a następnie ponów próbę z użyciem exponential backoff. Dodaj zadanie do kolejki zamiast je odrzucać.
Endpointy i dokumentacja
Możliwości
API wirtualnego try-on dla odzieży
REST API, które nakłada odzież na manekiny AI. Asynchroniczne, generowanie w 1.5–4 minuty, 5 credits przy 2K, 6 przy 4K. Przykłady dla cURL, Node.js i Python.
CzytajMożliwości
API try-on biżuterii dla naszyjników, pierścionków, bransoletek i kolczyków
Nakładaj naszyjniki, pierścionki, bransoletki i kolczyki na modele AI przez REST. 5 credits w 2K, wbudowane manekiny w zbliżeniu, renderowanie uwzględniające refleksy światła prosto z dokumentacji Photta.
CzytajMożliwości
Ghost mannequin API do zdjęć produktowych typu hollow-man
Endpoint AI ghost mannequin. Usuń manekina ze zdjęcia odzieży i zachowaj detale wnętrza. 3D lub flat-lay, przetwarzanie wsadowe, 4 credits w 2K.
CzytajDokumentacja
Pierwszy obraz z Photta w mniej niż pięć minut.
Zarejestruj się, wygeneruj klucz API, wykonaj pierwsze wywołanie cURL, odpytuj aż do ukończenia, zapisz wynik. Pięć kroków opisanych od początku do końca.
CzytajDokumentacja
Uwierzytelnianie w Photta API
Jak uwierzytelniać się w Photta API: nagłówek Authorization, prefiks klucza, miejsce tworzenia kluczy i bezpieczna rotacja.
CzytajDokumentacja
Cennik Photta API
Informacje o kosztach każdego endpointu Photta API w credits dla rozdzielczości 2K i 4K, zasadach naliczania opłat i zwrotów oraz bezpłatnych endpointach. Brak bezpośredniej ceny pieniężnej za zdjęcie.
CzytajDokumentacja
Błędy Photta API
Pełna lista typów błędów Photta API wraz z ich kodami statusu, strukturą treści błędu oraz informacją, które niepowodzenia warto ponowić.
CzytajDokumentacja
Endpointy zasobów Photta API
Pobieraj listy manekinów, póz, teł, obuwia i metek marek, przesyłaj własne pliki i sprawdzaj stan credits. Wyszukiwanie danych stojących za każdą generacją.
Czytaj
Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono
Wypróbuj API w 5 minut
Wygeneruj klucz Photta API, wklej powyższy snippet cURL, a otrzymasz swoje pierwsze zdjęcie na modelu, zanim zaparzy się kawa.
- 600 requests/min
- Retry-After: 30s
- asynchroniczne, polling