Muhtasari
Matumizi ya API yana vikomo vya maombi. Vikomo hivi huzuia idadi ya maombi, tokeni au matumizi mengine ndani ya muda maalumu.
Jibu la 429 linaweza kuashiria kikomo cha muda cha maombi, salio lililolipiwa mapema ambalo limekwisha, au kikomo cha matumizi au gharama. Kagua maelezo ya hitilafu kabla ya kujaribu tena au kubadilisha mipangilio ya malipo.
Tambua chanzo
Soma ujumbe wa hitilafu na error.code, ikiwa imetolewa. Hitilafu zinazohusiana na malipo bado zinaweza kutumia thamani pana ya error.type ya insufficient_quota.
| Hitilafu au msimbo | Maana yake | Hatua ya kuchukua |
| Kikomo cha maombi au tokeni kimefikiwa | Maombi yanazidi kikomo cha maombi kinachotumika. | Panga kasi ya maombi na ufuate mwongozo wa kujaribu tena ulio hapa chini. |
| credit_balance_exhausted | Shirika halina salio lolote lililolipiwa mapema. | Ongeza salio katika mipangilio yako ya malipo ya API. |
| organization_usage_limit_exceeded | Shirika limefikia kikomo cha matumizi kilichowekwa na OpenAI. | Omba kikomo cha juu zaidi cha matumizi kiidhinishwe. |
| organization_spend_limit_exceeded | Shirika limefikia kikomo chake kinachotekelezwa cha gharama. | Ongeza au uondoe kikomo, au usubiri kiwekwe upya kila mwezi. |
| project_spend_limit_exceeded | Mradi umefikia kikomo chake kinachotekelezwa cha gharama. | Ongeza au uondoe kikomo cha mradi, au usubiri kiwekwe upya kila mwezi. |
Kujaribu tena baada ya hitilafu ya malipo, gharama au kiwango hakutarejesha ufikiaji. Kwanza, shughulikia salio au kikomo kilichoripotiwa. Huenda mabadiliko ya vikomo vinavyotekelezwa vya gharama yakachukua muda kuanza kutumika.
Kubadilisha kikomo cha gharama kunahitaji ruhusa ya kudhibiti mipangilio ya shirika au mradi husika. Ikiwa huna ufikiaji, mwombe mtu anayedhibiti mipangilio hiyo.
Kwa ununuzi wa salio linalolipiwa mapema, angalia: Kuweka na kudhibiti malipo ya API yanayolipiwa mapema.
Kwa vidhibiti tofauti vya gharama, angalia mwongozo wa vikomo vya gharama za API.
Kagua vikomo vya maombi vinavyotumika
Nenda kwenye ukurasa wa Vikomo wa shirika lako ili ukague kiwango chake cha sasa cha matumizi na vikomo.
Vikomo vya maombi vinaweza kutumika katika viwango vya shirika na mradi. Si viwango vinavyotengewa watumiaji binafsi. Vikomo pia hutofautiana kulingana na muundo, na baadhi ya familia za miundo hutumia kikomo kimoja.
Kagua kikomo kinachotambuliwa na hitilafu. Kwa mfano, idadi ya maombi kwa dakika na tokeni kwa dakika ni vikomo tofauti. Unaweza kufikia kikomo kimoja huku ukisalia chini ya kingine.
Thibitisha shirika linalotumiwa na ombi lako
Ikiwa wewe ni mwanachama wa mashirika mengi, thibitisha kwamba maombi yako yanatumia shirika na mradi uliokusudiwa.
Ikiwa ufunguo wako wa API unatumia shirika chaguomsingi, kagua mpangilio wako wa shirika chaguomsingi. Mashirika tofauti yanaweza kuwa na mipango tofauti ya malipo na viwango vya matumizi.
Punguza hitilafu za muda za kikomo cha maombi
Panga kasi ya maombi na uepuke kuyatuma kwa wingi ghafla
Sambaza maombi kwa muda badala ya kutuma mengi kwa wakati mmoja.
Vikomo vya maombi vinaweza kutekelezwa katika vipindi vifupi kuliko muda unaoonyeshwa. Kwa mfano, kikomo cha maombi 60 kwa dakika kinaweza pia kutekelezwa katika vipindi vya sekunde 1. Kwa hivyo, kutuma maombi mengi kwa muda mfupi kunaweza kusababisha hitilafu hata ikiwa wastani wa matumizi yako unaonekana kuwa chini ya kikomo cha kila dakika.
Vidokezo virefu na viwango vikubwa visivyohitajika vya tokeni za matokeo vinaweza pia kuchangia hitilafu za kasi ya tokeni.
Jaribu tena baada ya kusubiri
Kwa hitilafu za muda za kikomo cha maombi:
Angalia kama jibu lina kichwa cha Retry-After.
Ikiwa kichwa kina muda halali wa kusubiri, subiri angalau muda huo kabla ya kujaribu tena.
Ikiwa kichwa hakipo au si halali, tumia muda wa kusubiri unaoongezeka kwa kielelezo pamoja na tofauti nasibu: ongeza muda wa kusubiri baada ya kila jaribio lisilofaulu, kisha uongeze muda mfupi wa nasibu.
Weka kikomo kwa idadi ya majaribio na jumla ya muda wa kujaribu tena.
SDK rasmi za OpenAI tayari hujaribu tena hitilafu zinazostahiki za kikomo cha maombi na hufuata Retry-After inapopatikana. Zingatia majaribio hayo kabla ya kuongeza mzunguko mwingine wa kujaribu tena.
Maombi yasiyofaulu huhesabiwa katika vikomo vya kila dakika. Kutuma ombi lilelile tena bila kukoma kunaweza kurefusha tatizo.
Kwa mwongozo na mifano ya utekelezaji, angalia mwongozo wa vikomo vya maombi ya API. Kagua maktaba yoyote ya wahusika wengine ya kujaribu tena kabla ya kuitumia katika programu yako.
Kagua ukubwa wa dokezo na matokeo
Ondoa maagizo yasiyohitajika, muktadha unaorudiwa na mifano katika vidokezo vyako. Jaribu dokezo lililorekebishwa ili kuthibitisha kwamba bado linatoa matokeo unayohitaji.
Tumia kigezo cha tokeni za matokeo kinachotumika katika mwisho na muundo wako:
Chat Completions hutumia max_completion_tokens.
Responses hutumia max_output_tokens.
Epuka kuweka kiwango kikubwa zaidi kuliko kinachohitajika na ombi. Vigezo hivi vinajumuisha tokeni za uwazaji pamoja na matokeo yanayoonekana, kwa hivyo zingatia vyote viwili unapotumia muundo wa uwazaji.
Kagua kiwango chako cha matumizi
Ikiwa hitilafu zitaendelea baada ya kupunguza kutuma maombi mengi ghafla na kukagua matumizi ya tokeni, angalia njia zilizopo za kuongeza vikomo vyako kwenye ukurasa wa Vikomo.
Gharama za API zinapoongezeka, OpenAI inaweza kulipandisha shirika kiotomatiki hadi kiwango cha juu zaidi cha matumizi. Kwa kawaida, hii huongeza vikomo vya maombi katika miundo mingi.
Kikomo chako cha matumizi ya kila mwezi kilichoidhinishwa ni tofauti na vikomo vya kasi ya maombi na tokeni. Kuongeza kimoja hakumaanishi kwamba kingine pia kimebadilika.
Tatizo likiendelea
Kabla ya kuomba usaidizi zaidi
Hifadhi ujumbe kamili wa hitilafu, msimbo wowote wa hitilafu, vitambulisho husika vya maombi, muda hitilafu ilipotokea pamoja na saa za eneo lako, na kikomo husika kinachoonyeshwa katika akaunti yako. Andika hatua ambazo tayari umejaribu.
Wasiliana na Usaidizi wa OpenAI
Wasiliana na Usaidizi wa OpenAI kupitia Kituo cha Usaidizi ikiwa huwezi kutatua tatizo baada ya kukagua kikomo kilichoripotiwa. Usijumuishe funguo za API au siri nyingine za uthibitishaji.