Шолу
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 тақырыбының бар-жоғын тексеріңіз.
Тақырыпта жарамды кідіріс көрсетілсе, қайта әрекеттенбес бұрын кемінде сонша уақыт күтіңіз.
Тақырып жоқ немесе жарамсыз болса, кездейсоқ кідірісі бар экспоненциалды шегінуді қолданыңыз: әр сәтсіз әрекеттен кейін кідірісті ұлғайтып, шағын кездейсоқ кідіріс қосыңыз.
Қайталау санын да, оған жұмсалатын жалпы уақытты да шектеңіз.
Ресми OpenAI SDK жинақтары жарамды сұраныс шектеуі қателері кезінде әрекетті автоматты түрде қайталайды және бар болса, Retry-After талабын сақтайды. Басқа қайталау циклін қоспас бұрын, сол қайталауларды ескеріңіз.
Сәтсіз сұраныстар минуттық шектеулерге есептеледі. Бір сұранысты үздіксіз қайта жіберу мәселені ұзарта алады.
Іске асыру нұсқаулары мен мысалдарды API сұраныс шектеулері нұсқаулығынан қараңыз. Қолданбаңызда пайдаланбас бұрын, кез келген үшінші тараптың қайталау кітапханасын тексеріңіз.
Көмексөз бен шығыс көлемін тексеріңіз
Көмексөздерден қажетсіз нұсқауларды, қайталанатын контекст пен мысалдарды алып тастаңыз. Өзгертілген көмексөздің қажетті нәтижені әлі де беретінін тексеріңіз.
Соңғы нүкте мен модель қолдайтын шығыс токендері параметрін пайдаланыңыз:
Chat Completions қызметі max_completion_tokens параметрін пайдаланады.
Responses қызметі max_output_tokens параметрін пайдаланады.
Сұранысқа қажет мөлшерден әлдеқайда жоғары лимит орнатпаңыз. Бұл параметрлерге ой қорыту токендері де, көрінетін шығыс та кіреді, сондықтан ойлайтын модельді пайдаланғанда екеуін де ескеріңіз.
Пайдалану деңгейіңізді тексеріңіз
Сұраныстардың күрт көбеюін азайтып, токендердің пайдаланылуын тексергеннен кейін де қателер жалғасса, лимиттерді арттырудың қолжетімді жолдарын Лимиттер бетінен қараңыз.
API шығындары өскен сайын, OpenAI ұйымды автоматты түрде жоғарырақ пайдалану деңгейіне өткізе алады. Бұл әдетте көптеген модельдердің сұраныс шектеулерін арттырады.
Бекітілген айлық пайдалану лимиті сұраныстар мен токендердің сұраныс шектеулерінен бөлек. Бірінің артуын екіншісінің де өзгергенінің растауы деп есептемеу керек.
Мәселе шешілмесе
Қолдау қызметіне жүгінбес бұрын
Қате хабарының дәл мәтінін, қате кодын, тиісті сұраныс идентификаторларын, уақыт белдеуіңізбен бірге қате уақытын және есептік жазбаңызда көрсетілген тиісті лимитті дайындап қойыңыз. Бұған дейін қолданып көрген қадамдарыңызды жазып қойыңыз.
OpenAI қолдау қызметіне хабарласыңыз
Көрсетілген лимитті тексергеннен кейін де мәселені шеше алмасаңыз, Көмек көрсету орталығы арқылы OpenAI қолдау қызметіне хабарласыңыз. API кілттерін немесе басқа аутентификация құпияларын қоспаңыз.