Общ преглед
Използването на API подлежи на лимити на заявките. Тези лимити ограничават заявките, токените или друго използване за определен период.
Отговор 429 може да означава временен лимит на заявките, изчерпан предплатен баланс или достигнат лимит на разходите или използването. Проверете подробностите за грешката, преди да опитате отново или да промените настройките за таксуване.
Установете причината
Прочетете съобщението за грешка и error.code, ако е предоставен. Грешките, свързани с таксуването, все пак може да използват по-общата стойност insufficient_quota за error.type.
| Грешка или код | Какво означава | Какво да направите |
| Достигнат е лимитът на заявките или токените | Заявките надвишават приложим лимит на заявките. | Разпределете заявките във времето и следвайте указанията за повторни опити по-долу. |
| credit_balance_exhausted | Организацията няма останали предплатени кредити. | Добавете кредити от настройките си за таксуване на API. |
| organization_usage_limit_exceeded | Организацията е достигнала определения от OpenAI лимит на използване. | Заявете одобрение на по-висок лимит на използване. |
| organization_spend_limit_exceeded | Организацията е достигнала наложения лимит на разходите. | Увеличете или премахнете лимита или изчакайте месечното нулиране. |
| project_spend_limit_exceeded | Проектът е достигнал наложения лимит на разходите. | Увеличете или премахнете лимита на проекта или изчакайте месечното нулиране. |
Повторният опит при грешка, свързана с таксуване, разходи или квота, не възстановява достъпа. Първо отстранете проблема с посочения баланс или лимит. Прилагането на промените в наложените лимити на разходите може да отнеме време.
За промяна на лимит на разходите е необходимо разрешение за управление на настройките на съответната организация или проект. Ако нямате достъп, обърнете се към човека, който управлява тези настройки.
За покупките на предплатени кредити вижте: Настройване и управление на предплатеното таксуване за API.
За различните средства за контрол на разходите вижте ръководството за API лимитите на разходите.
Проверете приложимите лимити на заявките
Отворете страницата „Лимити“ на организацията си, за да прегледате текущото ѝ ниво на използване и лимитите.
Лимитите на заявките може да се прилагат на ниво организация и проект. Те не са индивидуални квоти за потребителите. Лимитите се различават и според модела, а някои семейства модели споделят общ лимит.
Проверете кой лимит е посочен в грешката. Например заявките в минута и токените в минута са отделни лимити. Може да достигнете единия, без да сте достигнали другия.
Потвърдете организацията, използвана за заявката
Ако членувате в няколко организации, потвърдете, че заявките ви използват желаните организация и проект.
Когато API ключът ви използва организация по подразбиране, проверете настройката за организация по подразбиране. Различните организации може да имат различни условия за таксуване и нива на използване.
Намалете временните грешки за лимит на заявките
Разпределяйте заявките и избягвайте резки пикове
Разпределяйте заявките във времето, вместо да изпращате голям брой наведнъж.
Лимитите на заявките може да се прилагат за периоди, по-кратки от показания интервал. Например лимит от 60 заявки в минута може да се прилага и за периоди от 1 секунда. Затова кратък пик може да предизвика грешка дори ако средното ви използване изглежда под лимита за минута.
Дългите подкани и ненужно големите допустими стойности за изходни токени също могат да допринесат за грешки в лимита на токените.
Опитайте отново след изчакване
При временни грешки за лимит на заявките:
Проверете за заглавка Retry-After в отговора.
Ако заглавката съдържа валиден период за изчакване, изчакайте поне толкова, преди да опитате отново.
Ако заглавката липсва или е невалидна, използвайте експоненциално изчакване с произволно отклонение: увеличавайте изчакването след всеки неуспешен опит и добавяйте кратко произволно забавяне.
Ограничете както броя на повторните опити, така и общото време за тях.
Официалните SDK на OpenAI вече изпълняват повторни опити при подходящи грешки за лимит на заявките и спазват Retry-After, когато е налице. Вземете предвид тези опити, преди да добавите друг цикъл за повторение.
Неуспешните заявки се отчитат в лимитите за минута. Непрекъснатото повторно изпращане на една и съща заявка може да удължи проблема.
За указания и примери за реализация вижте ръководството за API лимитите на заявките. Прегледайте всяка библиотека на трета страна за повторни опити, преди да я използвате в приложението си.
Прегледайте размера на подканата и изхода
Премахнете ненужните инструкции, повтарящия се контекст и примерите от подканите си. Тествайте преработената подкана, за да потвърдите, че тя продължава да дава необходимия резултат.
Използвайте параметъра за изходни токени, поддържан от крайната точка и модела ви:
Chat Completions използва max_completion_tokens.
Responses използва max_output_tokens.
Не задавайте допустима стойност, която е много по-голяма от необходимата за заявката. Тези параметри включват както токените за структурирано анализиране, така и видимия изход, затова предвидете и двата вида, когато използвате модел със структурирано анализиране.
Прегледайте нивото си на използване
Ако грешките продължават, след като ограничите резките пикове и прегледате използването на токени, проверете наличните начини за увеличаване на лимитите на страницата „Лимити“.
С нарастването на разходите за API OpenAI може автоматично да премести дадена организация към по-високо ниво на използване. Обикновено това увеличава лимитите на заявките за повечето модели.
Одобреният ви месечен лимит на използване е отделен от лимитите на заявките и токените. Увеличаването на единия не трябва да се приема като потвърждение, че другият се е променил.
Ако проблемът продължава
Преди да ескалирате проблема
Подгответе точното съобщение за грешка, евентуалния код на грешката, съответните идентификатори на заявки, часа на грешката с часовата ви зона и съответния лимит, показан в профила ви. Запишете стъпките, които вече сте изпробвали.
Свържете се с поддръжката на OpenAI
Свържете се с поддръжката на OpenAI чрез Помощния център, ако не можете да разрешите проблема, след като проверите посочения лимит. Не включвайте API ключове или други тайни за удостоверяване.