Oversikt
API-bruk er underlagt bruksgrenser. Disse grensene begrenser forespørsler, token eller annen bruk i løpet av et bestemt tidsrom.
Et 429-svar kan tyde på en midlertidig bruksgrense, en oppbrukt forhåndsbetalt saldo eller en utgifts- eller bruksgrense. Sjekk feildetaljene før du prøver på nytt eller endrer faktureringsinnstillingene.
Finn årsaken
Les feilmeldingen og error.code, hvis den er oppgitt. Faktureringsrelaterte feil kan fortsatt ha insufficient_quota som den mer generelle error.type-verdien.
| Feil eller kode | Hva det betyr | Hva du bør gjøre |
| Bruksgrensen for forespørsler eller token er nådd | Forespørslene overskrider en gjeldende bruksgrense. | Fordel forespørslene over tid, og følg veiledningen nedenfor om nye forsøk. |
| credit_balance_exhausted | Organisasjonen har ingen forhåndsbetalte kreditter igjen. | Fyll på kreditter i faktureringsinnstillingene for API-et. |
| organization_usage_limit_exceeded | Organisasjonen har nådd bruksgrensen som OpenAI har fastsatt. | Be om å få godkjent en høyere bruksgrense. |
| organization_spend_limit_exceeded | Organisasjonen har nådd sin bindende utgiftsgrense. | Øk eller fjern grensen, eller vent på den månedlige nullstillingen. |
| project_spend_limit_exceeded | Prosjektet har nådd sin bindende utgiftsgrense. | Øk eller fjern prosjektgrensen, eller vent på den månedlige nullstillingen. |
Nye forsøk etter en fakturerings-, utgifts- eller kvotefeil gjenoppretter ikke tilgangen. Løs først problemet med saldoen eller grensen som er oppgitt. Det kan ta tid før endringer i bindende utgiftsgrenser trer i kraft.
For å endre en utgiftsgrense må du ha tillatelse til å administrere de aktuelle organisasjons- eller prosjektinnstillingene. Hvis du ikke har tilgang, spør personen som administrerer disse innstillingene.
For kjøp av forhåndsbetalte kreditter, se: Oppsett og administrasjon av forhåndsbetalt API-fakturering.
Se veiledningen om API-utgiftsgrenser for de ulike alternativene for utgiftskontroll.
Sjekk de gjeldende bruksgrensene
Gå til organisasjonens side for grenser for å se gjeldende bruksnivå og grenser.
Bruksgrenser kan gjelde på organisasjons- og prosjektnivå. De er ikke kvoter for enkeltbrukere. Grensene varierer også etter modell, og noen modellfamilier deler en grense.
Sjekk hvilken grense feilmeldingen viser til. For eksempel er forespørsler per minutt og token per minutt separate grenser. Du kan nå den ene mens du fortsatt er under den andre.
Sjekk API-grensene for bildegenerering
API-bruksgrensene for bildegenerering avhenger av modellen og bruksnivået ditt. Velg modellen din på modellsiden for å se grensene for den.
Se utviklerveiledningen for bildegenerering for oppsettsinstruksjoner. Se veiledningen om API-bruksgrenser for mer informasjon om bruksnivåer.
Bekreft hvilken organisasjon forespørselen bruker
Hvis du tilhører flere organisasjoner, må du bekrefte at forespørslene bruker riktig organisasjon og prosjekt.
Når API-nøkkelen din bruker en standardorganisasjon, bør du sjekke innstillingen for standardorganisasjon. Ulike organisasjoner kan ha ulike faktureringsordninger og bruksnivåer.
Reduser midlertidige feil knyttet til bruksgrenser
Fordel forespørslene jevnt og unngå trafikktopper
Fordel forespørslene over tid i stedet for å sende mange på én gang.
Bruksgrenser kan håndheves over kortere tidsrom enn intervallet som vises. For eksempel kan en grense på 60 forespørsler per minutt også håndheves over perioder på ett sekund. En kort trafikktopp kan derfor utløse en feil selv om den gjennomsnittlige bruken ser ut til å være under grensen per minutt.
Lange prompter og unødvendig høye grenser for antall utdatatoken kan også bidra til feil knyttet til bruksgrenser for token.
Vent før du prøver på nytt
Ved midlertidige feil knyttet til bruksgrenser:
Sjekk om svaret inneholder et Retry-After-headerfelt.
Hvis headerfeltet angir en gyldig ventetid, må du vente minst så lenge før du prøver på nytt.
Hvis headerfeltet mangler eller er ugyldig, bruk eksponentielt økende ventetid med tilfeldig variasjon: Øk ventetiden etter hvert mislykkede forsøk, og legg til en liten, tilfeldig forsinkelse.
Begrens både antall nye forsøk og den samlede tiden som brukes på dem.
De offisielle SDK-ene fra OpenAI prøver allerede på nytt ved egnede bruksgrensefeil og følger Retry-After når feltet er til stede. Ta hensyn til disse forsøkene før du legger til enda en løkke for nye forsøk.
Mislykkede forespørsler teller med i grensene per minutt. Hvis du stadig sender den samme forespørselen på nytt, kan problemet vare lenger.
Se veiledningen om API-bruksgrenser for implementeringsveiledning og eksempler. Vurder eventuelle tredjepartsbiblioteker for nye forsøk før du bruker dem i applikasjonen din.
Vurder størrelsen på prompter og utdata
Fjern unødvendige instruksjoner, gjentatt kontekst og eksempler fra promptene dine. Test den reviderte prompten for å bekrefte at den fortsatt gir resultatet du trenger.
Bruk parameteren for utdatatoken som støttes av endepunktet og modellen din:
Chat Completions bruker max_completion_tokens.
Responses bruker max_output_tokens.
Unngå å sette grensen mye høyere enn forespørselen krever. Disse parameterne omfatter både token til resonnering og synlige utdata, så ta høyde for begge deler når du bruker en resonneringsmodell.
Sjekk bruksnivået ditt
Hvis feilene vedvarer etter at du har redusert trafikktopper og gått gjennom tokenbruken, kan du sjekke siden for grenser for å se hvilke muligheter du har til å øke grensene.
Organisasjonens betalte bruksnivå oppgraderes automatisk når de samlede kjøpene av kreditter når tersklene for Build, Launch og Grow. Høyere nivåer gir som regel høyere bruksgrenser. Se veiledningen om API-bruksgrenser for kravene til hvert nivå.
Den godkjente månedlige bruksgrensen din er atskilt fra bruksgrensene for forespørsler og token. At én grense økes, betyr ikke nødvendigvis at en annen også er endret.
Hvis problemet vedvarer
Før du tar saken videre
Ha den nøyaktige feilmeldingen, eventuell feilkode, relevante forespørsels-ID-er, tidspunktet for feilen med tidssone og den aktuelle grensen som vises på kontoen din, tilgjengelig. Noter hva du allerede har prøvd.
Kontakt OpenAI-kundestøtte
Kontakt OpenAI-kundestøtte via hjelpesenteret hvis du ikke klarer å løse problemet etter å ha sjekket den oppgitte grensen. Ikke ta med API-nøkler eller andre hemmelige autentiseringsopplysninger.