Prezentare generală
Utilizarea API-ului este supusă unor limite de rată. Aceste limite restricționează numărul de cereri, numărul de tokenuri sau alte forme de utilizare într-o anumită perioadă.
Un răspuns 429 poate indica atingerea temporară a unei limite de rată, epuizarea soldului preplătit sau atingerea unei limite de cheltuieli ori de utilizare. Verifică detaliile erorii înainte de a reîncerca sau de a modifica setările de facturare.
Identifică cauza
Citește mesajul de eroare și valoarea error.code, dacă este furnizată. Erorile de facturare pot folosi în continuare valoarea mai generală insufficient_quota pentru error.type.
| Eroare sau cod | Ce înseamnă | Ce trebuie să faci |
| Limita de rată pentru cereri sau tokenuri a fost atinsă | Cererile depășesc o limită de rată aplicabilă. | Distanțează cererile în timp și urmează instrucțiunile de reîncercare de mai jos. |
| credit_balance_exhausted | Organizația nu mai are credite preplătite. | Adaugă credite din setările de facturare API. |
| organization_usage_limit_exceeded | Organizația a atins limita de utilizare stabilită de OpenAI. | Solicită aprobarea unei limite de utilizare mai mari. |
| organization_spend_limit_exceeded | Organizația a atins limita de cheltuieli impusă. | Mărește sau elimină limita ori așteaptă resetarea lunară. |
| project_spend_limit_exceeded | Proiectul a atins limita de cheltuieli impusă. | Mărește sau elimină limita proiectului ori așteaptă resetarea lunară. |
Reîncercarea unei cereri după o eroare de facturare, de cheltuieli sau de cotă nu restabilește accesul. Rezolvă mai întâi problema legată de soldul sau limita indicată. Aplicarea modificărilor la limitele de cheltuieli impuse poate dura un timp.
Pentru a modifica o limită de cheltuieli, ai nevoie de permisiunea de a gestiona setările organizației sau ale proiectului respectiv. Dacă nu ai acces, cere ajutorul persoanei care gestionează aceste setări.
Pentru achiziții de credite preplătite, consultă: Configurarea și gestionarea facturării preplătite pentru API.
Pentru diferitele opțiuni de control al cheltuielilor, consultă ghidul limitelor de cheltuieli pentru API.
Verifică limitele de rată aplicabile
Accesează pagina Limite a organizației tale pentru a verifica nivelul de utilizare și limitele actuale.
Limitele de rată se pot aplica la nivel de organizație și de proiect. Acestea nu sunt cote alocate fiecărui utilizator în parte. Limitele variază și în funcție de model, iar unele familii de modele au o limită comună.
Verifică ce limită este indicată în eroare. De exemplu, numărul de cereri pe minut și numărul de tokenuri pe minut au limite separate. Poți atinge una dintre limite fără să o atingi pe cealaltă.
Verifică limitele API-ului de generare de imagini
Limitele de rată ale API-ului de generare de imagini depind de model și de nivelul tău de utilizare. Selectează modelul pe pagina cu modele pentru a-i vedea limitele.
Pentru instrucțiuni de configurare, consultă ghidul de generare de imagini pentru dezvoltatori. Pentru mai multe informații despre nivelurile de utilizare, consultă ghidul limitelor de rată ale API-ului.
Confirmă organizația folosită de cererea ta
Dacă faci parte din mai multe organizații, confirmă că cererile tale folosesc organizația și proiectul dorite.
Când cheia ta API folosește o organizație implicită, verifică setarea organizației implicite. Organizațiile pot avea condiții de facturare și niveluri de utilizare diferite.
Redu erorile temporare legate de limitele de rată
Distanțează cererile în timp și evită rafalele
Distribuie cererile în timp în loc să trimiți un număr mare deodată.
Limitele de rată pot fi aplicate pe perioade mai scurte decât intervalul afișat. De exemplu, o limită de 60 de cereri pe minut poate fi aplicată și pe intervale de o secundă. Prin urmare, o rafală scurtă de cereri poate declanșa o eroare chiar dacă utilizarea medie pare să fie sub limita pe minut.
Solicitările lungi și alocările inutil de mari de tokenuri de ieșire pot contribui, de asemenea, la apariția erorilor legate de rata de tokenuri.
Așteaptă înainte de a reîncerca
Pentru erorile temporare legate de limitele de rată:
Verifică dacă răspunsul conține un antet Retry-After.
Dacă antetul conține un timp de așteptare valid, așteaptă cel puțin atât înainte de a reîncerca.
Dacă antetul lipsește sau nu este valid, folosește o temporizare exponențială cu variație aleatorie: mărește timpul de așteptare după fiecare încercare nereușită și adaugă o mică întârziere aleatorie.
Limitează atât numărul de reîncercări, cât și timpul total alocat acestora.
SDK-urile oficiale OpenAI reîncearcă deja cererile în cazul erorilor legate de limitele de rată care permit acest lucru și respectă Retry-After când acesta este prezent. Ține cont de aceste reîncercări înainte de a adăuga o altă buclă de reîncercare.
Cererile nereușite sunt luate în calcul la limitele pe minut. Retrimiterea continuă a aceleiași cereri poate prelungi problema.
Pentru îndrumări de implementare și exemple, consultă ghidul limitelor de rată ale API-ului. Evaluează orice bibliotecă de reîncercare de la terți înainte de a o folosi în aplicația ta.
Verifică dimensiunea solicitărilor și a răspunsurilor
Elimină din solicitări instrucțiunile și exemplele inutile, precum și contextul repetat. Testează solicitarea revizuită pentru a confirma că produce în continuare rezultatul de care ai nevoie.
Folosește parametrul pentru tokenuri de ieșire acceptat de punctul final și de modelul tău:
Chat Completions folosește max_completion_tokens.
Responses folosește max_output_tokens.
Evită să aloci mult mai multe tokenuri decât are nevoie cererea. Acești parametri includ atât tokenurile de raţionament, cât și răspunsul vizibil, așa că alocă tokenuri pentru ambele când folosești un model de raţionament.
Verifică nivelul de utilizare
Dacă erorile persistă după ce reduci rafalele de cereri și verifici utilizarea tokenurilor, consultă pagina Limite pentru a vedea opțiunile disponibile de mărire a limitelor.
Organizația ta trece automat la un nivel superior de utilizare cu plată pe măsură ce valoarea totală a achizițiilor de credite atinge pragurile Build, Launch și Grow. Nivelurile superioare oferă, în general, limite de rată mai mari. Consultă ghidul limitelor de rată ale API-ului pentru cerințele fiecărui nivel.
Limita ta lunară de utilizare aprobată este separată de limitele de rată pentru cereri și tokenuri. Mărirea uneia nu trebuie considerată o confirmare că și cealaltă s-a modificat.
Dacă problema persistă
Înainte de a solicita asistență
Păstrează la îndemână mesajul exact de eroare, orice cod de eroare, ID-urile cererilor relevante, ora erorii și fusul tău orar, precum și limita relevantă afișată în contul tău. Notează pașii pe care i-ai încercat deja.
Contactează echipa de asistență OpenAI
Contactează echipa de asistență OpenAI prin Centrul de asistență dacă nu poți rezolva problema după ce verifici limita indicată. Nu include chei API sau alte date secrete de autentificare.