Forbhreathnú
Tá úsáid an API faoi réir teorainneacha ráta. Cuireann na teorainneacha seo srian le hiarratais, téacschomharthaí nó úsáid eile thar thréimhse shonraithe.
D’fhéadfadh freagra 429 teorainn ráta shealadach, iarmhéid réamhíoctha ídithe, nó teorainn chaiteachais nó úsáide a léiriú. Seiceáil sonraí na hearráide sula ndéanfaidh tú iarracht eile nó sula n-athróidh tú do shocruithe billeála.
Aithin an chúis
Léigh an teachtaireacht earráide agus error.code, má chuirtear ar fáil é. Féadfaidh earráidí a bhaineann le billeáil an luach níos ginearálta insufficient_quota a úsáid fós le haghaidh error.type.
| Earráid nó cód | An bhrí atá leis | Cad ba cheart a dhéanamh |
| Teorainn ráta bainte amach d’iarratais nó do théacschomharthaí | Tá na hiarratais ag dul thar theorainn ráta is infheidhme. | Cuir spás ama idir iarratais agus lean an treoir thíos maidir le hiarrachtaí eile a dhéanamh. |
| credit_balance_exhausted | Níl aon chreidmheasanna réamhíoctha fágtha ag an eagraíocht. | Cuir creidmheasanna leis i do shocruithe billeála API. |
| organization_usage_limit_exceeded | Tá an teorainn úsáide a shann OpenAI di bainte amach ag an eagraíocht. | Iarr go gceadófar teorainn úsáide níos airde. |
| organization_spend_limit_exceeded | Tá an teorainn chaiteachais a fhorfheidhmítear uirthi bainte amach ag an eagraíocht. | Ardaigh nó bain an teorainn, nó fan go dtí an t-athshocrú míosúil. |
| project_spend_limit_exceeded | Tá an teorainn chaiteachais a fhorfheidhmítear air bainte amach ag an tionscadal. | Ardaigh nó bain teorainn an tionscadail, nó fan go dtí an t-athshocrú míosúil. |
Ní chuirfear rochtain ar ais trí iarracht eile a dhéanamh tar éis earráid billeála, caiteachais nó cuóta. Réitigh an fhadhb leis an iarmhéid nó leis an teorainn a tuairiscíodh ar dtús. D’fhéadfadh sé tamall a thógáil sula dtiocfaidh athruithe ar theorainneacha caiteachais forfheidhmithe i bhfeidhm.
Chun teorainn chaiteachais a athrú, teastaíonn cead uait chun socruithe na heagraíochta nó an tionscadail lena mbaineann a bhainistiú. Mura bhfuil rochtain agat, iarr ar an duine a bhainistíonn na socruithe sin é a dhéanamh.
Maidir le ceannach creidmheasanna réamhíoctha, féach: Billeáil réamhíoctha API a shocrú agus a bhainistiú.
Maidir leis na rialuithe caiteachais éagsúla, féach an treoir maidir le teorainneacha caiteachais an API.
Seiceáil na teorainneacha ráta is infheidhme
Téigh chuig leathanach Teorainneacha d’eagraíochta chun a leibhéal úsáide reatha agus a teorainneacha a sheiceáil.
Is féidir teorainneacha ráta a chur i bhfeidhm ar leibhéal na heagraíochta agus ar leibhéal an tionscadail. Ní liúntais d’úsáideoirí aonair iad. Bíonn teorainneacha éagsúil ó shamhail go samhail freisin, agus roinneann roinnt teaghlach samhlacha teorainn.
Seiceáil cén teorainn a shonraítear san earráid. Mar shampla, is teorainneacha ar leith iad líon na n-iarratas in aghaidh an nóiméid agus líon na dtéacschomharthaí in aghaidh an nóiméid. Is féidir leat ceann amháin a bhaint amach agus fanacht faoi bhun an chinn eile.
Seiceáil teorainneacha an API le haghaidh giniúint íomhá
Braitheann teorainneacha ráta an API le haghaidh giniúint íomhá ar an tsamhail agus ar do leibhéal úsáide. Roghnaigh do shamhail ar leathanach na samhlacha chun a teorainneacha a fheiceáil.
Le treoracha socraithe a fháil, féach an treoir d’fhorbróirí maidir le giniúint íomhá. Le tuilleadh eolais a fháil faoi leibhéil úsáide, féach an treoir maidir le teorainneacha ráta an API.
Deimhnigh cén eagraíocht a úsáideann d’iarratas
Má tá tú i do bhall de roinnt eagraíochtaí, deimhnigh go n-úsáideann d’iarratais an eagraíocht agus an tionscadal atá beartaithe agat.
Nuair a úsáideann d’eochair API eagraíocht réamhshocraithe, seiceáil do shocrú don eagraíocht réamhshocraithe. D’fhéadfadh socruithe billeála agus leibhéil úsáide éagsúla a bheith ag eagraíochtaí éagsúla.
Laghdaigh earráidí sealadacha a bhaineann le teorainneacha ráta
Cuir spás ama idir iarratais agus seachain rabhartaí
Scaip iarratais thar thréimhse ama seachas líon mór a sheoladh ag an am céanna.
Is féidir teorainneacha ráta a fhorfheidhmiú thar thréimhsí níos giorra ná an t-eatramh a thaispeántar. Mar shampla, d’fhéadfaí teorainn de 60 iarratas in aghaidh an nóiméid a fhorfheidhmiú thar thréimhsí 1 soicind freisin. Dá bhrí sin, d’fhéadfadh rabharta gearr earráid a spreagadh fiú más cosúil go bhfuil do mheánúsáid faoi bhun na teorann in aghaidh an nóiméid.
Is féidir le leideanna fada agus liúntais téacschomharthaí aschuir atá níos mó ná mar is gá cur le hearráidí ráta téacschomharthaí freisin.
Fan tamall sula ndéanfaidh tú iarracht eile
I gcás earráidí sealadacha a bhaineann le teorainneacha ráta:
Seiceáil an bhfuil ceanntásc Retry-After sa fhreagra.
Má tá moill bhailí sonraithe sa cheanntásc, fan chomh fada sin ar a laghad sula ndéanfaidh tú iarracht eile.
Má tá an ceanntásc ar iarraidh nó neamhbhailí, bain úsáid as moill easpónantúil le luaineacht randamach: méadaigh an mhoill tar éis gach iarrachta nár éirigh léi agus cuir moill bheag randamach léi.
Cuir teorainn le líon na n-iarrachtaí eile agus leis an am iomlán a chaitear orthu.
Déanann SDKanna oifigiúla OpenAI iarrachtaí eile cheana féin i gcás earráidí teorann ráta atá incháilithe, agus cloíonn siad le Retry-After nuair atá sé ann. Cuir na hiarrachtaí sin san áireamh sula gcuirfidh tú lúb atrialach eile leis.
Áirítear iarratais nár éirigh leo i dtreo na dteorainneacha in aghaidh an nóiméid. Má sheolann tú an t-iarratas céanna arís agus arís eile, d’fhéadfadh an fhadhb maireachtáil níos faide.
Le treoir agus samplaí cur chun feidhme a fháil, féach an treoir maidir le teorainneacha ráta an API. Déan athbhreithniú ar aon leabharlann atrialach tríú páirtí sula n-úsáidfidh tú i d’fheidhmchlár í.
Seiceáil méid na leide agus an aschuir
Bain treoracha nach bhfuil gá leo, comhthéacs athráite agus samplaí de do leideanna. Déan tástáil ar an leid leasaithe chun a dheimhniú go dtugann sí an toradh atá uait fós.
Úsáid an paraiméadar téacschomharthaí aschuir a dtacaíonn do dheireadhphointe agus do shamhail leis:
Úsáideann Chat Completions max_completion_tokens.
Úsáideann Responses max_output_tokens.
Seachain liúntas a shocrú atá i bhfad níos mó ná mar a theastaíonn ón iarratas. Áirítear téacschomharthaí réasúnaíochta chomh maith le haschur infheicthe sna paraiméadair seo, mar sin déan soláthar don dá rud agus samhail réasúnaíochta á húsáid agat.
Seiceáil do leibhéal úsáide
Má leanann na hearráidí ar aghaidh tar éis duit rabhartaí iarratas a laghdú agus úsáid téacschomharthaí a sheiceáil, féach ar do leathanach Teorainneacha chun na bealaí atá ar fáil chun do theorainneacha a ardú a fheiceáil.
Ardaítear leibhéal úsáide íoctha d’eagraíochta go huathoibríoch de réir mar a shroicheann iomlán a ceannachán creidmheasanna na tairseacha Build, Launch agus Grow. Go ginearálta, bíonn teorainneacha ráta níos airde ag leibhéil níos airde. Féach an treoir maidir le teorainneacha ráta an API chun riachtanais na leibhéal a fháil.
Tá do theorainn úsáide mhíosúil cheadaithe ar leithligh ó theorainneacha ráta na n-iarratas agus na dtéacschomharthaí. Níor cheart glacadh leis go bhfuil ceann amháin athraithe toisc gur ardaíodh an ceann eile.
Má leanann an fhadhb ar aghaidh
Sula n-iarrfaidh tú tuilleadh cabhrach
Bíodh na nithe seo ar fáil agat: an teachtaireacht earráide bheacht, aon chód earráide, aitheantóirí ábhartha na n-iarratas, am na hearráide agus do chrios ama, agus an teorainn ábhartha a thaispeántar i do chuntas. Breac síos na céimeanna ar bhain tú triail astu cheana.
Déan teagmháil le Tacaíocht OpenAI
Déan teagmháil le Tacaíocht OpenAI tríd an Lárionad Cabhrach mura féidir leat an fhadhb a réiteach tar éis duit an teorainn a tuairiscíodh a sheiceáil. Ná cuir eochracha API ná sonraí rúnda fíordheimhnithe eile san áireamh.