Ընդհանուր ակնարկ
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 բանալին օգտագործում է լռելյայն կազմակերպություն, ստուգեք լռելյայն կազմակերպության կարգավորումը։ Տարբեր կազմակերպություններ կարող են ունենալ վճարման տարբեր պայմաններ և օգտագործման տարբեր մակարդակներ։
Նվազեցրեք սահմանաչափի ժամանակավոր սխալները
Կարգավորեք հարցումների հաճախականությունը և խուսափեք կտրուկ հոսքերից
Մեծ քանակով միանգամից ուղարկելու փոխարեն հարցումները բաշխեք ժամանակի ընթացքում։
Սահմանաչափերը կարող են կիրառվել ցուցադրված միջակայքից ավելի կարճ ժամանակահատվածներում։ Օրինակ՝ րոպեում 60 հարցման սահմանաչափը կարող է կիրառվել նաև 1 վայրկյանանոց ժամանակահատվածներում։ Ուստի հարցումների կարճատև կտրուկ հոսքը կարող է սխալ առաջացնել, նույնիսկ եթե ձեր միջին օգտագործումը րոպեական սահմանաչափից ցածր է թվում։
Երկար հարցումները և ելքային թոքենների անհարկի մեծ թույլատրելի քանակը նույնպես կարող են թոքենների սահմանաչափի սխալներ առաջացնել։
Կրկին փորձեք որոշ ժամանակ անց
Սահմանաչափի ժամանակավոր սխալների դեպքում՝
Ստուգեք՝ արդյոք պատասխանում կա Retry-After վերնագիր։
Եթե վերնագիրը պարունակում է սպասման վավեր ժամանակ, կրկին փորձելուց առաջ սպասեք առնվազն այդքան։
Եթե վերնագիրը բացակայում է կամ անվավեր է, կիրառեք պատահական շեղմամբ էքսպոնենցիալ հետաձգում․ յուրաքանչյուր անհաջող փորձից հետո ավելացրեք սպասման ժամանակը և դրան գումարեք փոքր պատահական ուշացում։
Սահմանափակեք թե՛ կրկնափորձերի քանակը, թե՛ դրանց վրա ծախսվող ընդհանուր ժամանակը։
OpenAI-ի պաշտոնական SDK-ներն արդեն կրկին փորձում են սահմանաչափի համապատասխան սխալների դեպքում և առկայության դեպքում հետևում են Retry-After-ին։ Կրկնափորձերի ևս մեկ ցիկլ ավելացնելուց առաջ հաշվի առեք այդ կրկնափորձերը։
Անհաջող հարցումները հաշվարկվում են րոպեական սահմանաչափերում։ Նույն հարցումն անընդհատ կրկին ուղարկելը կարող է երկարաձգել խնդիրը։
Իրականացման ցուցումների և օրինակների համար տե՛ս API-ի սահմանաչափերի ուղեցույցը։ Նախքան ձեր հավելվածում որևէ երրորդ կողմի կրկնափորձերի գրադարան օգտագործելը՝ ուսումնասիրեք այն։
Վերանայեք հարցման և ելքի չափը
Ձեր հարցումներից հեռացրեք ավելորդ հրահանգները, կրկնվող համատեքստը և օրինակները։ Փորձարկեք վերանայված հարցումը՝ համոզվելու, որ այն դեռ տալիս է ձեզ անհրաժեշտ արդյունքը։
Օգտագործեք ձեր վերջնակետի և մոդելի աջակցած ելքային թոքենների պարամետրը՝
Chat Completions-ն օգտագործում է max_completion_tokens։
Responses-ն օգտագործում է max_output_tokens։
Մի սահմանեք հարցման համար անհրաժեշտից շատ ավելի մեծ թույլատրելի քանակ։ Այս պարամետրերը ներառում են ինչպես դատողության թոքենները, այնպես էլ տեսանելի ելքը, ուստի հիմնավորման մոդել օգտագործելիս հաշվի առեք երկուսն էլ։
Վերանայեք օգտագործման ձեր մակարդակը
Եթե հարցումների կտրուկ հոսքերը նվազեցնելուց և թոքենների օգտագործումը վերանայելուց հետո սխալները շարունակվում են, սահմանաչափերն ավելացնելու հասանելի եղանակները տեսնելու համար բացեք ձեր Սահմանաչափեր էջը։
API-ի ծախսերի ավելացմանը զուգընթաց OpenAI-ը կարող է կազմակերպությունն ավտոմատ կերպով տեղափոխել օգտագործման ավելի բարձր մակարդակ։ Սա սովորաբար մեծացնում է սահմանաչափերը մոդելների մեծ մասի համար։
Ձեր հաստատված ամսական օգտագործման սահմանափակումը առանձին է հարցումների և թոքենների սահմանաչափերից։ Մեկի ավելացումը չի նշանակում, որ մյուսը նույնպես փոխվել է։
Եթե խնդիրը չի վերանում
Նախքան խնդիրը վերադասավորելը
Պահեք սխալի ճշգրիտ հաղորդագրությունը, սխալի կոդը, համապատասխան հարցումների ID-ները, սխալի ժամը և ձեր ժամային գոտին, ինչպես նաև ձեր հաշվում ցուցադրված համապատասխան սահմանափակումը։ Նշեք արդեն փորձած քայլերը։
Կապվեք OpenAI-ի աջակցման ծառայության հետ
Եթե նշված սահմանափակումը ստուգելուց հետո չեք կարողանում լուծել խնդիրը, Օգնության կենտրոնի միջոցով կապվեք OpenAI-ի աջակցման ծառայության հետ։ Մի՛ ներառեք API բանալիներ կամ նույնականացման այլ գաղտնի տվյալներ։