Oversigt
Brug af API'et er underlagt brugsgrænser. Disse grænser begrænser antallet af anmodninger, tokens eller anden brug inden for en bestemt periode.
Et 429-svar kan skyldes en midlertidig brugsgrænse, en opbrugt forudbetalt saldo eller en udgifts- eller forbrugsgrænse. Tjek fejloplysningerne, før du prøver igen eller ændrer dine faktureringsindstillinger.
Find årsagen
Læs fejlmeddelelsen og error.code, hvis den er angivet. Faktureringsrelaterede fejl kan stadig have den mere generelle værdi insufficient_quota i error.type.
| Fejl eller kode | Hvad det betyder | Hvad du skal gøre |
| Brugsgrænsen for anmodninger eller tokens er nået | Anmodningerne overskrider en gældende brugsgrænse. | Fordel anmodningerne over tid, og følg vejledningen til genforsøg nedenfor. |
| credit_balance_exhausted | Organisationen har ikke flere forudbetalte kreditter. | Tilføj kreditter i dine API-faktureringsindstillinger. |
| organization_usage_limit_exceeded | Organisationen har nået den forbrugsgrænse, som OpenAI har tildelt den. | Anmod om at få godkendt en højere forbrugsgrænse. |
| organization_spend_limit_exceeded | Organisationen har nået sin håndhævede udgiftsgrænse. | Hæv eller fjern grænsen, eller vent på den månedlige nulstilling. |
| project_spend_limit_exceeded | Projektet har nået sin håndhævede udgiftsgrænse. | Hæv eller fjern projektets grænse, eller vent på den månedlige nulstilling. |
Genforsøg ved en fakturerings-, udgifts- eller kvotefejl genopretter ikke adgangen. Løs først problemet med den angivne saldo eller grænse. Det kan tage tid, før ændringer af håndhævede udgiftsgrænser træder i kraft.
For at ændre en udgiftsgrænse skal du have tilladelse til at administrere indstillingerne for den relevante organisation eller det relevante projekt. Hvis du ikke har adgang, skal du bede den person, der administrerer indstillingerne, om hjælp.
Læs om køb af forudbetalte kreditter her: Opsætning og administration af forudbetalt API-fakturering.
Læs om de forskellige muligheder for udgiftsstyring i vejledningen til API-udgiftsgrænser.
Tjek de gældende brugsgrænser
Gå til din organisations side med grænser for at se dens aktuelle brugsniveau og grænser.
Brugsgrænser kan gælde på både organisations- og projektniveau. De er ikke individuelle kvoter for hver bruger. Grænserne varierer også efter model, og nogle modelfamilier deler en grænse.
Tjek, hvilken grænse fejlen henviser til. For eksempel er der separate grænser for anmodninger pr. minut og tokens pr. minut. Du kan nå den ene, mens du stadig ligger under den anden.
Tjek API-grænser for billedgenerering
API-brugsgrænserne for billedgenerering afhænger af modellen og dit brugsniveau. Vælg din model på modelsiden for at se dens grænser.
Du finder opsætningsvejledningen i udviklervejledningen til billedgenerering. Læs mere om brugsniveauer i vejledningen til API-brugsgrænser.
Kontrollér, hvilken organisation din anmodning bruger
Hvis du tilhører flere organisationer, skal du kontrollere, at dine anmodninger bruger den tilsigtede organisation og det tilsigtede projekt.
Hvis din API-nøgle bruger en standardorganisation, skal du tjekke din indstilling for standardorganisation. Organisationer kan have forskellige faktureringsaftaler og brugsniveauer.
Reducér midlertidige fejl på grund af brugsgrænser
Fordel anmodningerne over tid, og undgå spidsbelastninger
Fordel anmodningerne over tid i stedet for at sende mange på én gang.
Brugsgrænser kan håndhæves over kortere perioder end det viste interval. For eksempel kan en grænse på 60 anmodninger pr. minut også håndhæves over perioder på 1 sekund. En kort spidsbelastning kan derfor udløse en fejl, selvom dit gennemsnitlige forbrug ser ud til at ligge under grænsen pr. minut.
Lange prompts og unødvendigt høje grænser for outputtokens kan også bidrage til fejl på grund af tokenbrugsgrænser.
Vent, før du prøver igen
Ved midlertidige fejl på grund af brugsgrænser:
Tjek, om svaret indeholder en Retry-After-header.
Hvis headeren angiver en gyldig ventetid, skal du vente mindst så længe, før du prøver igen.
Hvis headeren mangler eller er ugyldig, skal du bruge eksponentiel backoff med jitter: Øg ventetiden efter hvert mislykket forsøg, og tilføj en kort, tilfældig forsinkelse.
Begræns både antallet af genforsøg og den samlede tid, der bruges på dem.
De officielle OpenAI-SDK'er forsøger allerede igen ved relevante fejl på grund af brugsgrænser og følger Retry-After, når headeren er til stede. Tag højde for disse genforsøg, før du tilføjer endnu en løkke til genforsøg.
Mislykkede anmodninger tæller med i grænserne pr. minut. Hvis du bliver ved med at sende den samme anmodning, kan det forlænge problemet.
Du finder implementeringsvejledning og eksempler i vejledningen til API-brugsgrænser. Gennemgå eventuelle tredjepartsbiblioteker til genforsøg, før du bruger dem i din applikation.
Gennemgå størrelsen på prompts og output
Fjern unødvendige instruktioner, gentagen kontekst og eksempler fra dine prompts. Test den reviderede prompt for at sikre, at den stadig giver det ønskede resultat.
Brug den parameter for outputtokens, som dit endepunkt og din model understøtter:
Chat Completions bruger max_completion_tokens.
Responses bruger max_output_tokens.
Undgå at sætte grænsen meget højere, end anmodningen kræver. Disse parametre omfatter både ræsonneringstokens og synligt output, så tag højde for begge dele, når du bruger en ræsonneringsmodel.
Tjek dit brugsniveau
Hvis fejlene fortsætter, efter at du har reduceret spidsbelastninger og gennemgået tokenforbruget, kan du se mulighederne for at hæve dine grænser på din side med grænser.
Din organisations betalte brugsniveau opgraderes automatisk, når dens samlede køb af kreditter når tærsklerne for Build, Launch og Grow. Højere niveauer giver generelt højere brugsgrænser. Se kravene til niveauerne i vejledningen til API-brugsgrænser.
Din godkendte månedlige forbrugsgrænse er adskilt fra brugsgrænserne for anmodninger og tokens. At den ene grænse hæves, er ikke en bekræftelse på, at den anden er ændret.
Hvis problemet fortsætter
Før du går videre med sagen
Hav den præcise fejlmeddelelse, eventuelle fejlkoder, relevante anmodnings-id'er, tidspunktet for fejlen med tidszone og den relevante grænse, der vises på din konto, klar. Notér, hvad du allerede har prøvet.
Kontakt OpenAI Support
Kontakt OpenAI Support via Hjælp, hvis du ikke kan løse problemet efter at have tjekket den angivne grænse. Medtag ikke API-nøgler eller andre hemmelige godkendelsesoplysninger.