Overzicht
Voor API-gebruik gelden volumelimieten. Deze limieten beperken het aantal verzoeken, tokens of ander gebruik binnen een bepaalde periode.
Een 429-respons kan wijzen op een tijdelijke volumelimiet, een opgebruikt prepaidtegoed of een bestedings- of gebruikslimiet. Controleer de foutdetails voordat je het opnieuw probeert of je factureringsinstellingen wijzigt.
Bepaal de oorzaak
Lees de foutmelding en error.code, indien beschikbaar. Factureringsgerelateerde fouten kunnen nog steeds de algemenere waarde insufficient_quota voor error.type gebruiken.
| Fout of code | Betekenis | Wat je kunt doen |
| Volumelimiet voor verzoeken of tokens bereikt | De verzoeken overschrijden een geldende volumelimiet. | Spreid je verzoeken en volg de onderstaande richtlijnen om het opnieuw te proberen. |
| credit_balance_exhausted | De organisatie heeft geen prepaidcredits meer. | Voeg credits toe in je API-factureringsinstellingen. |
| organization_usage_limit_exceeded | De organisatie heeft de door OpenAI toegewezen gebruikslimiet bereikt. | Vraag goedkeuring aan voor een hogere gebruikslimiet. |
| organization_spend_limit_exceeded | De organisatie heeft de afgedwongen bestedingslimiet bereikt. | Verhoog of verwijder de limiet, of wacht tot deze maandelijks wordt gereset. |
| project_spend_limit_exceeded | Het project heeft de afgedwongen bestedingslimiet bereikt. | Verhoog of verwijder de projectlimiet, of wacht tot deze maandelijks wordt gereset. |
Een verzoek opnieuw proberen na een facturerings-, bestedings- of quotafout herstelt de toegang niet. Los eerst het gemelde probleem met het saldo of de limiet op. Het kan even duren voordat wijzigingen in afgedwongen bestedingslimieten van kracht worden.
Om een bestedingslimiet te wijzigen, moet je de betreffende organisatie- of projectinstellingen mogen beheren. Als je geen toegang hebt, vraag het dan aan degene die deze instellingen beheert.
Zie voor het kopen van prepaidcredits: Prepaidfacturering voor de API instellen en beheren.
Zie de handleiding voor API-bestedingslimieten voor de verschillende mogelijkheden om bestedingen te beheren.
Controleer de geldende volumelimieten
Ga naar de pagina Limieten van je organisatie om het huidige gebruiksniveau en de limieten te bekijken.
Volumelimieten kunnen op organisatie- en projectniveau gelden. Ze gelden niet per individuele gebruiker. Limieten verschillen ook per model, en sommige modelfamilies delen een limiet.
Controleer welke limiet in de foutmelding wordt genoemd. Zo zijn het aantal verzoeken per minuut en het aantal tokens per minuut afzonderlijke limieten. Je kunt de ene limiet bereiken terwijl je onder de andere blijft.
Controleer de API-limieten voor beeldgeneratie
De API-volumelimieten voor beeldgeneratie zijn afhankelijk van het model en je gebruiksniveau. Selecteer je model op de modellenpagina om de bijbehorende limieten te bekijken.
Zie de ontwikkelaarshandleiding voor beeldgeneratie voor instructies om dit in te stellen. Zie de handleiding voor API-volumelimieten voor meer informatie over gebruiksniveaus.
Controleer welke organisatie je verzoek gebruikt
Als je lid bent van meerdere organisaties, controleer dan of je verzoeken de bedoelde organisatie en het bedoelde project gebruiken.
Als je API-sleutel een standaardorganisatie gebruikt, controleer dan je instelling voor de standaardorganisatie. Organisaties kunnen verschillende factureringsafspraken en gebruiksniveaus hebben.
Verminder tijdelijke fouten door volumelimieten
Spreid verzoeken en vermijd pieken
Spreid verzoeken over de tijd in plaats van er veel tegelijk te versturen.
Volumelimieten kunnen worden afgedwongen over kortere perioden dan het weergegeven interval. Een limiet van 60 verzoeken per minuut kan bijvoorbeeld ook worden afgedwongen over perioden van 1 seconde. Een korte piek kan dus een fout veroorzaken, zelfs als je gemiddelde gebruik onder de limiet per minuut lijkt te blijven.
Ook lange prompts en onnodig hoge ingestelde maxima voor uitvoertokens kunnen bijdragen aan fouten door volumelimieten voor tokens.
Wacht voordat je het opnieuw probeert
Bij tijdelijke fouten door volumelimieten:
Controleer of er een Retry-After-responsheader aanwezig is.
Als de header een geldige wachttijd bevat, wacht dan minstens zo lang voordat je het opnieuw probeert.
Als de header ontbreekt of ongeldig is, gebruik dan exponentiële back-off met jitter: verleng de wachttijd na elke mislukte poging en voeg een kleine willekeurige wachttijd toe.
Beperk zowel het aantal nieuwe pogingen als de totale tijd die je eraan besteedt.
Officiële OpenAI-SDK's proberen verzoeken na daarvoor in aanmerking komende volumelimietfouten al automatisch opnieuw en houden rekening met Retry-After als die header aanwezig is. Houd rekening met die nieuwe pogingen voordat je zelf nog een herhaallus toevoegt.
Mislukte verzoeken tellen mee voor de limieten per minuut. Steeds hetzelfde verzoek opnieuw versturen kan het probleem verlengen.
Zie de handleiding voor API-volumelimieten voor implementatierichtlijnen en voorbeelden. Beoordeel elke externe bibliotheek voor het opnieuw proberen van verzoeken voordat je die in je applicatie gebruikt.
Controleer de lengte van prompts en uitvoer
Verwijder onnodige instructies, herhaalde context en voorbeelden uit je prompts. Test de aangepaste prompt om te controleren of deze nog steeds het gewenste resultaat oplevert.
Gebruik de parameter voor uitvoertokens die je endpoint en model ondersteunen:
Chat Completions gebruikt max_completion_tokens.
Responses gebruikt max_output_tokens.
Stel geen veel hoger maximum in dan nodig is voor het verzoek. Deze parameters omvatten zowel tokens voor redenering als zichtbare uitvoer. Houd dus rekening met beide wanneer je een redenerend model gebruikt.
Controleer je gebruiksniveau
Als fouten blijven optreden nadat je pieken hebt verminderd en het tokengebruik hebt gecontroleerd, bekijk dan op je pagina Limieten welke mogelijkheden er zijn om je limieten te verhogen.
Het betaalde gebruiksniveau van je organisatie wordt automatisch verhoogd zodra het totaal aan gekochte credits de drempels voor Build, Launch en Grow bereikt. Hogere niveaus bieden doorgaans hogere volumelimieten. Zie de handleiding voor API-volumelimieten voor de vereisten per niveau.
Je goedgekeurde maandelijkse gebruikslimiet staat los van de volumelimieten voor verzoeken en tokens. Een verhoging van de ene limiet betekent niet dat de andere ook is gewijzigd.
Als het probleem aanhoudt
Voordat je hulp inschakelt
Houd de exacte foutmelding, een eventuele foutcode, relevante verzoek-ID's, het tijdstip van de fout inclusief je tijdzone en de betreffende limiet in je account bij de hand. Noteer welke stappen je al hebt geprobeerd.
Neem contact op met OpenAI Support
Neem via het helpcentrum contact op met OpenAI Support als je het probleem niet kunt oplossen nadat je de gemelde limiet hebt gecontroleerd. Deel geen API-sleutels of andere geheime authenticatiegegevens.