Limity zapytań
Ile zapytań możesz wysłać, co się dzieje, gdy wyślesz więcej, i jakie jeszcze ograniczenia warto znać.
Limity chronią wszystkich, którzy korzystają z usługi. Wartości domyślne są hojne przy normalnym użyciu; jeśli jednak trafisz na limit, odpowiedź powie dokładnie, ile odczekać.
W skrócie
| Limit | Domyślnie | Gdy go osiągniesz |
|---|---|---|
Zapisy na konto (createTask, retry, przesyłanie …) | 1000 na 10 sekund | 429 z Retry-After |
Odczyty na konto (recordInfo, models, jobs, quote …) | 1000 na 10 sekund | 429 z Retry-After |
| Bilety przesyłania | 1000 na 10 sekund, dodatkowo do zapisów | 429 z Retry-After |
Raport zużycia (/api/v1/usage) | 30 na minutę na konto | 429 z Retry-After |
| Biblioteka zasobów | 60 odczytów i 30 zapisów na minutę oraz dzienny limit nowych zasobów | 429 z Retry-After |
| Każde zapytanie przed sprawdzeniem klucza | 6000 na minutę na sieć | 429 |
| Treść zapytania | 2 MiB JSON | 413 |
| Saldo | Tyle, ile masz na koncie | 40201 |
| Limity wydatków klucza | Brak, chyba że je ustawisz | 40202 |
Limity liczą się na konto, nie na klucz — tworzenie kolejnych kluczy ich nie podnosi.
Nagłówki odpowiedzi
| Nagłówek | Znaczenie |
|---|---|
X-RateLimit-Limit | Twój przydział w bieżącym oknie |
X-RateLimit-Remaining | Ile zostało — przychodzi też w udanych odpowiedziach, żebyś mógł zwolnić zawczasu |
Retry-After | Przy 429: ile sekund odczekać przed ponowieniem |
Powyższe liczby to wartości domyślne i mogą się zmienić; ufaj nagłówkom zamiast wpisywać je na sztywno w kodzie.
Jak wygląda limit
{ "code": 429, "msg": "Too many requests. Retry in a moment", "request_id": "req_…" }Zapytanie ponad limit jest odrzucane od razu — nie trafia do kolejki — i nic nie kosztuje.
Jak sobie z tym radzić
- Odczekaj co najmniej
Retry-Aftersekund i spróbuj ponownie. Dodaj trochę losowości, żeby grupa klientów nie wróciła w tej samej chwili. - Ponawiając
createTask, wysyłaj ten samIdempotency-Key(Idempotencja). - Odpytuj spokojnie: co kilka sekund dla obrazów, co 10–15 sekund dla wideo. Jeszcze lepiej użyj webhooków — nie zużywają żadnych zapytań.
Wiele zadań naraz
Limity zapytań ograniczają tempo wysyłania zapytań, a nie liczbę zadań działających jednocześnie. Możesz mieć wiele zadań w toku; długie wideo po prostu trwa dłużej. Jeśli musisz uruchomić tysiące zadań, rozłóż wysyłkę w czasie i odbieraj wyniki webhookami.
Potrzebujesz wyższego przydziału na premierę albo dużą partię? Napisz do nas, podając spodziewany wolumen.