Шолу
API пайдалануға сұраныс шектеулері қолданылады. Бұл шектеулер белгілі бір уақыт аралығындағы сұраныстар, токендер санын немесе басқа пайдалану көлемін шектейді.
429 жауабы уақытша сұраныс шектеуін, алдын ала төленген қаражаттың таусылғанын немесе шығын не пайдалану шегіне жеткеніңізді білдіруі мүмкін. Қайталап көруден немесе төлем баптауларын өзгертуден бұрын қате мәліметтерін тексеріңіз.
Себебін анықтаңыз
Қате хабарын және берілген болса, error.code мәнін оқыңыз. Төлемге қатысты қателерде де error.type өрісінің жалпылама insufficient_quota мәні қолданылуы мүмкін.
| Қате немесе код | Мағынасы | Не істеу керек |
| Сұраныстар немесе токендер бойынша сұраныс шектеуіне жеттіңіз | Сұраныстар қолданыстағы сұраныс шектеуінен асып жатыр. | Сұраныстарды аралықпен жіберіп, төмендегі қайталау нұсқауларын орындаңыз. |
| credit_balance_exhausted | Ұйымның алдын ала төленген кредиттері таусылды. | API төлем баптауларында кредиттер қосыңыз. |
| organization_usage_limit_exceeded | Ұйым OpenAI белгілеген пайдалану шегіне жетті. | Бекітілген пайдалану шегін арттыруды сұраңыз. |
| organization_spend_limit_exceeded | Ұйым міндетті түрде қолданылатын шығын шегіне жетті. | Шекті арттырыңыз не алып тастаңыз немесе айлық есептегіштің нөлденуін күтіңіз. |
| project_spend_limit_exceeded | Жоба міндетті түрде қолданылатын шығын шегіне жетті. | Жоба шегін арттырыңыз не алып тастаңыз немесе айлық есептегіштің нөлденуін күтіңіз. |
Төлем, шығын немесе квота қатесі туындағанда сұранысты қайталау қолжетімділікті қалпына келтірмейді. Алдымен хабарда көрсетілген баланс немесе шектеу мәселесін шешіңіз. Міндетті түрде қолданылатын шығын шектеріне енгізілген өзгерістер күшіне енуі үшін уақыт қажет болуы мүмкін.
Шығын шегін өзгерту үшін тиісті ұйым немесе жоба баптауларын басқаруға рұқсат қажет. Рұқсатыңыз болмаса, сол баптауларды басқаратын адамға жүгініңіз.
Алдын ала төленетін кредиттерді сатып алу туралы API үшін алдын ала төлемді баптау және басқару мақаласын қараңыз.
Шығынды бақылаудың әртүрлі тәсілдерін API шығын шектері жөніндегі нұсқаулықтан қараңыз.
Қолданыстағы сұраныс шектеулерін тексеріңіз
Ұйымыңыздың ағымдағы пайдалану деңгейі мен шектеулерін көру үшін оның Шектеулер бетіне өтіңіз.
Сұраныс шектеулері ұйым және жоба деңгейінде қолданылуы мүмкін. Олар әр пайдаланушыға жеке бөлінген көлем емес. Шектеулер модельге қарай да өзгереді, ал кейбір модель топтарына ортақ шектеу қолданылады.
Қате хабарында қай шектеу көрсетілгенін тексеріңіз. Мысалы, минутына жіберілетін сұраныстар саны мен токендер саны бөлек шектеледі. Бір шекке жеткенде, екіншісінен әлі төмен болуыңыз мүмкін.
Суретті генерациялау API шектеулерін тексеріңіз
Суретті генерациялау API сұраныс шектеулері модельге және пайдалану деңгейіңізге байланысты. Модель шектеулерін көру үшін оны модельдер бетінен таңдаңыз.
Баптау нұсқауларын әзірлеушілерге арналған суретті генерациялау нұсқаулығынан қараңыз. Пайдалану деңгейлері туралы толығырақ API сұраныс шектеулері жөніндегі нұсқаулықтан қараңыз.
Сұранысыңыз қай ұйымды пайдаланатынын тексеріңіз
Бірнеше ұйымға мүше болсаңыз, сұраныстарыңыз қажетті ұйым мен жобаны пайдаланып жатқанына көз жеткізіңіз.
API кілтіңіз әдепкі ұйымды пайдаланса, әдепкі ұйым баптауын тексеріңіз. Әр ұйымның төлем шарттары мен пайдалану деңгейлері әртүрлі болуы мүмкін.
Сұраныс шектеуіне байланысты уақытша қателерді азайтыңыз
Сұраныстарды аралықпен жіберіп, бір мезетте көп жібермеңіз
Көп сұранысты бірден жібермей, уақыт аралықтарына бөліп жіберіңіз.
Сұраныс шектеулері көрсетілген аралықтан қысқа кезеңдерге де қолданылуы мүмкін. Мысалы, минутына 60 сұраныс шектеуі 1 секундтық кезеңдерге де қолданылуы мүмкін. Сондықтан орташа пайдалану көлеміңіз минуттық шектен төмен көрінсе де, қысқа уақытта көп сұраныс жіберу қатеге әкелуі мүмкін.
Ұзын көмексөздер мен шығыс токендеріне қажеттен артық көлем бөлу де токендер жиілігіне қатысты қателерге себеп болуы мүмкін.
Кідірістен кейін қайталап көріңіз
Сұраныс шектеуіне байланысты уақытша қателер туындаса:
Жауапта Retry-After тақырыбы бар-жоғын тексеріңіз.
Тақырыпта жарамды кідіріс мәні көрсетілсе, қайталап көруден бұрын кемінде сонша уақыт күтіңіз.
Тақырып жоқ немесе жарамсыз болса, кездейсоқ ауытқуы бар экспоненциалды кідірісті қолданыңыз: әр сәтсіз әрекеттен кейін кідірісті ұзартып, оған шағын кездейсоқ кідіріс қосыңыз.
Қайталау санын да, қайталауға жұмсалатын жалпы уақытты да шектеңіз.
Ресми OpenAI SDK құралдары сұраныс шектеуіне байланысты қайталауға болатын қателер туындағанда сұранысты автоматты түрде қайталайды және Retry-After бар болса, оны ескереді. Тағы бір қайталау циклін қоспас бұрын осы қайталауларды ескеріңіз.
Сәтсіз сұраныстар да минуттық шектеулерге есептеледі. Бір сұранысты үздіксіз қайта жіберу мәселенің ұзаққа созылуына әкелуі мүмкін.
Іске асыру нұсқаулары мен мысалдарын API сұраныс шектеулері жөніндегі нұсқаулықтан қараңыз. Үшінші тараптың қайталау кітапханасын қолданбаңызда пайдаланбас бұрын оны тексеріп алыңыз.
Көмексөз бен жауап көлемін тексеріңіз
Көмексөздерден қажетсіз нұсқауларды, қайталанатын контексті және мысалдарды алып тастаңыз. Өзгертілген көмексөзді сынап, оның әлі де қажетті нәтижені беретінін тексеріңіз.
Соңғы нүктеңіз бен моделіңіз қолдайтын шығыс токендері параметрін пайдаланыңыз:
Chat Completions үшін max_completion_tokens қолданылады.
Responses үшін max_output_tokens қолданылады.
Сұранысқа қажет мөлшерден әлдеқайда көп көлем бөлмеңіз. Бұл параметрлер көрінетін жауаппен қатар ой қорыту токендерін де қамтиды, сондықтан ойлайтын модельді пайдаланғанда екеуіне де орын қалдырыңыз.
Пайдалану деңгейіңізді тексеріңіз
Бір мезетте жіберілетін сұраныстарды азайтып, токендердің пайдаланылуын тексергеннен кейін де қателер қайталанса, шектеулерді арттыру жолдарын Шектеулер бетінен қараңыз.
Ұйымыңыздың кредиттер сатып алуға жұмсаған жалпы сомасы Build, Launch және Grow межелеріне жеткенде, оның ақылы пайдалану деңгейі автоматты түрде жоғарылайды. Жоғары деңгейлерде сұраныс шектеулері әдетте жоғарырақ болады. Деңгей талаптарын API сұраныс шектеулері жөніндегі нұсқаулықтан қараңыз.
Бекітілген айлық пайдалану шегіңіз сұраныстар мен токендер жиілігіне қойылатын шектеулерден бөлек. Бірінің артуы екіншісінің де өзгергенін білдірмейді.
Мәселе шешілмесе
Қолдау қызметіне жүгінбес бұрын
Қате хабарының дәл мәтінін, бар болса қате кодын, тиісті сұраныс идентификаторларын, қате болған уақытты уақыт белдеуімен бірге және аккаунтыңызда көрсетілген тиісті шектеуді дайындап қойыңыз. Қандай қадамдарды орындап көргеніңізді жазып алыңыз.
OpenAI қолдау қызметіне хабарласыңыз
Хабарда көрсетілген шектеуді тексергеннен кейін мәселені шеше алмасаңыз, Көмек көрсету орталығы арқылы OpenAI қолдау қызметіне хабарласыңыз. API кілттерін немесе аутентификацияға арналған басқа құпия деректерді жібермеңіз.