Overzicht
Je kunt API-gebruik op twee manieren bekijken:
Gebruik Analyses > Gebruik om API-activiteit in huidige en eerdere rapportageperioden te bekijken.
Lees de gebruiksinformatie in een API-respons om een afzonderlijk verzoek te controleren.
Playground gebruikt dezelfde API-aanroepen als je applicaties. De tokens ervan tellen mee voor het API-gebruik van je account en vallen onder dezelfde gebruiksregels en tarieven.
Toegang tot het dashboard
U moet eigenaar van de organisatie zijn of de machtiging Gebruiksdashboard hebben om toegang te krijgen tot het gebruiksdashboard.
Gebruik bekijken in het dashboard
Open in het API-platform Analyses en selecteer Gebruik om het huidige project te bekijken. Selecteer Organisatieanalyses voor rapportages over de hele organisatie. Selecteer de rapportageperiode die je wilt bekijken en controleer deze opnieuw nadat je tussen project- en organisatieanalyses hebt gewisseld.
Dashboardgegevens worden weergegeven in UTC. Houd rekening met die tijdzone wanneer je activiteit op het dashboard vergelijkt met je applicatielogs.
Het kan even duren voordat recent gebruik in het dashboard verschijnt. Als recente activiteit ontbreekt, kijk dan later nog eens.
Gebruik filteren
In Analyses op projectniveau is het gebruik beperkt tot het geselecteerde project. Gebruik in Organisatieanalyses de optie Project om de projecten te selecteren die je wilt bekijken. Alle projecten omvat elk project in de organisatie, rekening houdend met eventuele andere geselecteerde filters.
Gebruik Filters om het gebruik te filteren op API-bronnen, API-sleutels, Modellen, Gebruikers of Verwerkingsniveau. Met API-bronnen kun je Alle API-bronnen, Agents API of Directe API selecteren.
Verwijder afzonderlijke selecties of selecteer Filters wissen om het paneel Filters te resetten. Door filters te wissen, schakel je niet tussen project- en organisatieanalyses.
Gebruik Filter in de grafiek Gebruik om te filteren op Batch. Selecteer Grafiekfilters resetten om de filters van die grafiek te resetten.
Als een functie de geselecteerde filters niet ondersteunt, zijn de waarden ervan mogelijk niet beschikbaar. Niet-beschikbare waarden betekenen niet dat er geen gebruik is.
Als een filter een machtigingsfout weergeeft, heb je mogelijk geen toegang tot de opties ervan. Dit betekent niet dat er geen gebruik is geregistreerd.
Het gebruik van een afzonderlijke gebruiker bekijken
Open Gebruik in de weergave Analyses van het project of de organisatie die je wilt bekijken. Selecteer in de tabel API-functies de optie Bekijken bij Responses en Chat Completions.
Selecteer in Filters de optie Gebruikers en selecteer de gebruiker. De resultaten worden direct bijgewerkt.
Bekijk de grafiek en tabel voor die gebruiker.
Om het gebruik van een gebruiker voor meerdere functies te bekijken, pas je het filter Gebruikers toe in het overzicht Gebruik. Om gebruikers te vergelijken, wis je dat filter en selecteer je het tabblad Gebruikers in de tabel.
Tokens per dag, uur of minuut bekijken
Als intervalinstellingen beschikbaar zijn in Gebruik, selecteer je 1d of 1u om tokens per dag of uur te bekijken, of 1m om tokens per minuut (TPM) te bekijken. Selecteer Automatisch om het dashboard het tijdsinterval voor je rapportageperiode te laten kiezen. Deze intervallen gelden voor gebruiksgegevens, niet voor factureringsgegevens.
Als 1m is uitgeschakeld, selecteer je een kortere rapportageperiode of gebruik je Selecteren om in te zoomen en sleep je over de grafiek om het bereik te verkleinen. Selecteer vervolgens 1m. Druk op Esc om een zoomselectie te annuleren. Selecteer het huidige datumbereik in de werkbalk van Analyses om een andere rapportageperiode te kiezen.
Gebruiksgrafieken en -tabellen bekijken
Gebruik Statistieken om een of meer reeksen tegelijk weer te geven, waaronder Invoertokens, Invoertokens buiten de cache, Invoertokens uit de cache, Naar de cache geschreven invoertokens, Audio-invoertokens, Uitvoertokens en Audio-uitvoertokens. Welke statistieken beschikbaar zijn, hangt af van de functie. Gebruik de legenda om te zien waar elke reeks voor staat.
Gebruik Groeperen op om het gebruik in te delen in categorieën zoals Project, Gebruiker of Model, waar beschikbaar. Filters bepalen welk gebruik wordt meegenomen; de groepering bepaalt hoe het wordt weergegeven. Wissel tussen lijn- en staafdiagrammen om trends te bekijken of categorieën te vergelijken.
Gebruik de tabbladen van de tabel Gebruik om de beschikbare uitsplitsingen te bekijken. Tabellen tonen de relevante meetwaarden per rij, zoals verzoeken, invoer- en uitvoertokens of functiespecifieke eenheden.
Selecteer in API-functies de optie Bekijken bij een functie om de gedetailleerde grafieken en uitsplitsingen ervan te openen. Responses en Chat Completions bevat afzonderlijke grafieken voor Tokens en Verzoeken en de statistiek Modelverzoeken. De tabbladen met uitsplitsingen gebruiken dezelfde dimensies als het overzicht, maar bevatten niet het tabblad API-functies. Gebruik Gebruik in het kruimelpad om terug te gaan naar het overzicht.
Nadat je een optie voor Groeperen op hebt geselecteerd, kan de grafiek extra categorieën samenvoegen onder Overig. Als Overig in de legenda van de grafiek staat, selecteer je dat label om de bijbehorende categorieën en hun gebruikswaarden te bekijken.
Selecteer Dashboards vergelijken om Gebruik naast een ander dashboard voor dezelfde rapportageperiode te bekijken. Gebruik Linkerdashboard en Rechterdashboard om de weergaven te selecteren. Als het geselecteerde tijdsinterval niet beschikbaar is voor deze combinatie van dashboards, schakelt de weergave over op Automatisch. Selecteer Vergelijking sluiten om terug te gaan naar het dashboard.
Gebruik onderzoeken dat je niet herkent
Als Gebruik activiteit toont die je niet kunt koppelen aan verzoeken in je applicatielogs, voer dan deze controles uit:
Controleer de organisatie, de geselecteerde projecten en de rapportageperiode. Gebruik UTC wanneer je tijdstempels op het dashboard vergelijkt met je applicatielogs.
Gebruik de projectweergave voor het betreffende project, of selecteer het onder Project in Organisatieanalyses. Gebruik vervolgens Filters om het gebruik te beperken tot een API-sleutel en model, en selecteer een kortere rapportageperiode.
Vergelijk de activiteit met logs voor dezelfde periode, hetzelfde project en dezelfde API-sleutel. Controleer of je logs alle applicaties of integraties omvatten die die sleutel gebruiken.
Als meerdere applicaties of integraties hetzelfde project of dezelfde API-sleutel delen, kun je op basis van alleen het totaal mogelijk niet bepalen welke een verzoek heeft verstuurd. Vergelijk het dashboard met de gegevens van elke applicatie voor dezelfde UTC-periode.
Als je het gebruik nog steeds niet kunt verklaren, neem dan contact op met OpenAI Support en vermeld de betreffende UTC-periode, de organisatie- en project-ID's, de identificatiecode van de API-sleutel en relevante schermafbeeldingen of logs. Voeg verzoek-ID's toe als die beschikbaar zijn. Deel geen geheime API-sleutels.
Gebruiksgegevens exporteren
Om gebruiksgegevens te exporteren, selecteer je het pictogram CSV exporteren in de werkbalk van Analyses en vervolgens Activiteitsgegevens.
Selecteer de API-functie en een of meer dimensies onder Groeperen op.
Controleer API-bron, Projecten, Gebruikers, API-sleutels en Modellen. Projecten en API-bron zijn vooraf geselecteerd op basis van Analyses; selecteer de overige exportfilters in het dialoogvenster.
Selecteer Bestandsindeling, Begintijd, Eindtijd en Tijdsinterval, en selecteer vervolgens Downloaden. Datums omvatten volledige UTC-dagen.
Je kunt activiteits- en kostengegevens bekijken en exporteren vanaf 00:00 UTC één kalenderjaar geleden tot en met vandaag. Voor oudere gegevens neem je contact op met OpenAI Support. Daggegevens worden geëxporteerd in bestanden die elk een periode van 31 dagen beslaan.
Voor het controleren van maandelijkse facturen en het exporteren van factuurregels, zie: Maandelijkse gebruiksdetails exporteren.
Als een export van activiteitsgegevens negatieve rijen bevat, vergelijk dan rijen met dezelfde eenheid, groepering en datums. Gebruik Kostengegevens voor gefactureerde bedragen. Een negatieve activiteitsrij op zichzelf bewijst niet dat er een bedrag op je factuur is gecrediteerd.
Uitgaven bekijken
Open Analyses en selecteer Uitgaven om de kosten voor het huidige project te bekijken. Voor de kosten van de hele organisatie selecteer je Organisatieanalyses en vervolgens Uitgaven.
Controleer het huidige datumbereik en de filters voordat je kosten met gebruik vergelijkt. Gebruik en Uitgaven bieden verschillende filters; een filter dat in het ene dashboard beschikbaar is, is mogelijk niet van toepassing op het andere.
Gebruik API-bronnen, API-sleutels, Modellen en Factuurregels om uitgaven te filteren. Gebruik in organisatieanalyses de optie Project om de projecten op te nemen die je wilt bekijken. Gebruik de tabbladen Factuurregels, API-sleutels, Gebruikers, Projecten en Modellen in de tabel om de beschikbare uitsplitsingen te bekijken.
Als de waarde voor de uitgavenlimiet niet beschikbaar is, betekent dat niet dat je limiet nul is of dat er een nieuwe limiet is ingesteld. Toegangsrechten, een niet-ingestelde limiet of een mislukt verzoek kunnen ervoor zorgen dat het dashboard geen waarde weergeeft.
Servicestatus bekijken
Als je organisatie toegang heeft tot Servicestatus, open je dat dashboard in Analyses om de API-prestaties te bekijken. Voor toegangsvoorwaarden en definities van statistieken, zie: Problemen met API-fouten en latentie oplossen.
Toegekende credits bekijken
Details over toegekende credits vind je op de factureringspagina van je organisatie.
Toegekende credits en API-gebruik geven verschillende informatie: toegekende credits tonen de credits die aan je organisatie zijn gekoppeld, terwijl gebruik de API-activiteit van de organisatie toont.
Gebruik en kosten van het schaalniveau bekijken
Als het schaalniveau voor uw organisatie is ingeschakeld en u de vereiste toegang hebt, opent u de gebruikspagina van het schaalniveau voor gedetailleerde gebruiksgegevens.
De kosten van schaalniveaubundels worden aan de organisatie toegerekend, niet aan afzonderlijke projecten.
Het gebruik is groter dan nul, maar de projectuitgaven zijn nul
Controleer of het gebruik van het model onder je toegewezen capaciteit voor het schaalniveau valt. Als al het gebruik van dat model binnen de toegewezen TPM-capaciteit van het schaalniveau valt, kan het project gebruik tonen zonder extra modelkosten.
De abonnementskosten voor het schaalniveau blijven op organisatieniveau. Bekijk de uitgaven voor de hele organisatie in plaats van alleen de uitgaven van een afzonderlijk project.
Meerdere organisaties bekijken
Het gebruiksdashboard combineert geen kosten- of gebruiksgegevens van verschillende organisaties. Elke organisatie, ook een suborganisatie, wordt afzonderlijk behandeld.
Om een suborganisatie te bekijken, selecteer je deze in de organisatiekiezer.
Als je gecombineerde rapportages nodig hebt, overweeg dan projecten binnen één organisatie te gebruiken in plaats van afzonderlijke suborganisaties, of gebruik de Usage API voor analyses op maat.
Tokengebruik in een API-respons controleren
De veldnamen voor tokengebruik hangen af van het endpoint.
| Aantal tokens | Chat Completions | Responses |
|---|---|---|
| Invoertokens | usage.prompt_tokens | usage.input_tokens |
| Uitvoertokens | usage.completion_tokens | usage.output_tokens |
| Totaal aantal tokens | usage.total_tokens | usage.total_tokens |
Responsen van Chat Completions kunnen informatie over tokengebruik bevatten. Voorbeelden zijn:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Afhankelijk van het endpoint en het model kunnen de gebruiksgegevens ook aantallen gecachete invoertokens en redeneringstokens bevatten. Deze helpen verklaren waarom de zichtbare lengte van een antwoord niet het volledige tokengebruik weergeeft.
Zie Tokens begrijpen en tellen voor uitleg over de verschillende tokencategorieën.
Bij een transcriptierespons die tokengebruik vermeldt, zijn invoertokens voor audio en tekst al opgenomen in input_tokens. Tel die onderdelen niet nogmaals bij het invoertotaal op. Vergelijk output_tokens afzonderlijk.
Tokengebruik ophalen bij gestreamde Chat Completions
Voeg bij een streamingaanvraag voor Chat Completions het volgende toe:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Als include_usage is ingeschakeld, bevat een extra chunk vóór data: [DONE] het tokengebruik voor de volledige aanvraag. De choices-array van deze chunk is leeg. In de andere chunks heeft usage de waarde null.
Als de stream wordt onderbroken, ontvang je die laatste chunk met gebruiksgegevens mogelijk niet. Het ontbreken van de laatste chunk bewijst niet dat er voor de aanvraag geen tokens zijn gebruikt.
Deze configuratie geldt alleen voor Chat Completions. Zie voor meer informatie de referentiedocumentatie voor de Chat Completions-API.
