Przegląd
Korzystanie z API podlega limitom zapytań. Limity te ograniczają liczbę zapytań, tokenów lub inne miary użycia w określonym czasie.
Odpowiedź 429 może oznaczać tymczasowe osiągnięcie limitu zapytań, wyczerpanie przedpłaconych środków lub osiągnięcie limitu wydatków bądź użycia. Zanim ponowisz zapytanie lub zmienisz ustawienia rozliczeń, sprawdź szczegóły błędu.
Ustal przyczynę
Przeczytaj komunikat o błędzie i sprawdź wartość error.code, jeśli jest podana. Błędy związane z rozliczeniami również mogą mieć ogólną wartość insufficient_quota w polu error.type.
| Błąd lub kod | Co oznacza | Co zrobić |
| Osiągnięto limit zapytań lub tokenów w danym czasie | Zapytania przekraczają obowiązujący limit zapytań. | Rozłóż zapytania w czasie i postępuj zgodnie z poniższymi wskazówkami dotyczącymi ponawiania. |
| credit_balance_exhausted | Organizacja nie ma już przedpłaconych środków. | Dodaj środki w ustawieniach rozliczeń API. |
| organization_usage_limit_exceeded | Organizacja osiągnęła limit użycia przyznany przez OpenAI. | Poproś o zatwierdzenie wyższego limitu użycia. |
| organization_spend_limit_exceeded | Organizacja osiągnęła egzekwowany limit wydatków. | Zwiększ lub usuń limit albo poczekaj na jego comiesięczne odnowienie. |
| project_spend_limit_exceeded | Projekt osiągnął egzekwowany limit wydatków. | Zwiększ lub usuń limit projektu albo poczekaj na jego comiesięczne odnowienie. |
Ponawianie zapytań po błędzie dotyczącym rozliczeń, wydatków lub przyznanego limitu nie przywróci dostępu. Najpierw rozwiąż wskazany problem z saldem lub limitem. Zastosowanie zmian egzekwowanych limitów wydatków może zająć trochę czasu.
Zmiana limitu wydatków wymaga uprawnień do zarządzania ustawieniami danej organizacji lub projektu. Jeśli nie masz dostępu, poproś o pomoc osobę zarządzającą tymi ustawieniami.
Informacje o zakupie przedpłaconych środków znajdziesz w artykule: Konfigurowanie rozliczeń API w systemie przedpłat i zarządzanie nimi.
Informacje o różnych sposobach kontrolowania wydatków znajdziesz w przewodniku po limitach wydatków na API.
Sprawdź obowiązujące limity zapytań
Otwórz stronę limitów swojej organizacji, aby sprawdzić jej bieżący poziom użycia i limity.
Limity zapytań mogą obowiązywać na poziomie organizacji i projektu. Nie są to limity przyznawane poszczególnym użytkownikom. Limity różnią się też w zależności od modelu, a niektóre rodziny modeli mają wspólny limit.
Sprawdź, który limit wskazuje komunikat o błędzie. Na przykład liczba zapytań na minutę i liczba tokenów na minutę to oddzielne limity. Możesz osiągnąć jeden z nich, nie przekraczając drugiego.
Sprawdź limity API do generowania obrazu
Limity zapytań API do generowania obrazu zależą od modelu i Twojego poziomu użycia. Wybierz swój model na stronie modeli, aby zobaczyć jego limity.
Instrukcje konfiguracji znajdziesz w przewodniku po generowaniu obrazu dla programistów. Więcej informacji o poziomach użycia znajdziesz w przewodniku po limitach zapytań API.
Sprawdź, z której organizacji korzysta zapytanie
Jeśli należysz do wielu organizacji, upewnij się, że Twoje zapytania korzystają z właściwej organizacji i projektu.
Jeśli Twój klucz API korzysta z domyślnej organizacji, sprawdź ustawienie domyślnej organizacji. Poszczególne organizacje mogą mieć różne warunki rozliczeń i poziomy użycia.
Ogranicz tymczasowe błędy związane z limitami zapytań
Rozłóż zapytania w czasie i unikaj nagłych serii
Rozłóż zapytania w czasie, zamiast wysyłać ich wiele naraz.
Limity zapytań mogą być egzekwowane w okresach krótszych niż podany przedział czasu. Na przykład limit 60 zapytań na minutę może być również egzekwowany w okresach 1-sekundowych. Krótka seria zapytań może więc wywołać błąd, nawet jeśli średnie użycie wydaje się niższe od limitu na minutę.
Długie polecenia i niepotrzebnie wysokie limity tokenów wyjściowych również mogą powodować błędy związane z limitem tokenów w danym czasie.
Odczekaj przed ponowieniem zapytania
W przypadku tymczasowych błędów związanych z limitami zapytań:
Sprawdź, czy odpowiedź zawiera nagłówek Retry-After.
Jeśli nagłówek zawiera prawidłowy czas oczekiwania, odczekaj co najmniej tyle przed ponowieniem zapytania.
Jeśli nagłówka brakuje lub jest nieprawidłowy, zastosuj wykładnicze wydłużanie czasu oczekiwania z losowym odchyleniem: po każdej nieudanej próbie zwiększaj opóźnienie i dodawaj niewielkie losowe opóźnienie.
Ogranicz zarówno liczbę ponowień, jak i łączny czas przeznaczony na ponawianie.
Oficjalne biblioteki SDK OpenAI już ponawiają zapytania przy odpowiednich błędach limitu zapytań i uwzględniają nagłówek Retry-After, jeśli jest obecny. Uwzględnij te ponowienia, zanim dodasz kolejną pętlę ponawiania.
Nieudane zapytania wliczają się do limitów na minutę. Ciągłe wysyłanie tego samego zapytania może przedłużyć problem.
Wskazówki dotyczące implementacji i przykłady znajdziesz w przewodniku po limitach zapytań API. Zanim użyjesz w swojej aplikacji zewnętrznej biblioteki do ponawiania zapytań, sprawdź jej działanie.
Sprawdź długość poleceń i odpowiedzi
Usuń z poleceń zbędne instrukcje, powtarzający się kontekst i przykłady. Przetestuj zmienione polecenie, aby upewnić się, że nadal daje oczekiwany wynik.
Użyj parametru tokenów wyjściowych obsługiwanego przez Twój punkt końcowy i model:
Chat Completions używa parametru max_completion_tokens.
Responses używa parametru max_output_tokens.
Unikaj ustawiania limitu znacznie wyższego, niż wymaga zapytanie. Te parametry obejmują zarówno tokeny rozumowania, jak i widoczną odpowiedź, więc podczas korzystania z modelu rozumującego uwzględnij oba te elementy.
Sprawdź swój poziom użycia
Jeśli błędy nadal występują po ograniczeniu nagłych serii zapytań i sprawdzeniu zużycia tokenów, otwórz stronę limitów, aby poznać dostępne sposoby ich zwiększenia.
Płatny poziom użycia Twojej organizacji wzrasta automatycznie, gdy łączna wartość zakupionych środków osiąga progi Build, Launch i Grow. Wyższe poziomy zazwyczaj zapewniają wyższe limity zapytań. Wymagania dotyczące poziomów znajdziesz w przewodniku po limitach zapytań API.
Zatwierdzony miesięczny limit użycia jest niezależny od limitów liczby zapytań i tokenów w danym czasie. Zwiększenie jednego limitu nie oznacza, że drugi również się zmienił.
Jeśli problem nadal występuje
Zanim zgłosisz problem
Przygotuj dokładną treść komunikatu o błędzie, kod błędu, jeśli występuje, identyfikatory powiązanych zapytań, czas wystąpienia błędu wraz ze strefą czasową oraz wartość odpowiedniego limitu widoczną na Twoim koncie. Zanotuj podjęte już kroki.
Skontaktuj się z pomocą techniczną OpenAI
Jeśli po sprawdzeniu wskazanego limitu nie możesz rozwiązać problemu, skontaktuj się z pomocą techniczną OpenAI za pośrednictwem Centrum pomocy. Nie dołączaj kluczy API ani innych poufnych danych uwierzytelniających.