Overzicht
U kunt het API-gebruik op twee manieren bekijken:
Gebruik het gebruiksdashboard om activiteit in de huidige en eerdere factureringsperioden te bekijken.
Bekijk de gebruiksgegevens in een API-reactie om een afzonderlijk verzoek te controleren.
Playground gebruikt dezelfde API-aanroepen als uw applicaties. De tokens ervan tellen mee voor het API-gebruik van uw 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 het gebruiksdashboard, selecteer de organisatie die u wilt bekijken en kies de relevante rapportageperiode.
Dashboardgegevens worden weergegeven in UTC. Houd rekening met deze tijdzone wanneer u de activiteit op het dashboard vergelijkt met uw applicatielogboeken.
Projecten selecteren
Het dashboard heeft een eigen projectkiezer. Deze werkt onafhankelijk van het project dat elders op het API-platform is geselecteerd.
Gebruik de kiezer van het dashboard om één, meerdere of alle projecten te bekijken. Wis de geselecteerde projecten om de algemene organisatiegegevens te bekijken. Als er geen projecten zijn geselecteerd, toont het dashboard de gegevens van alle projecten.
Het gebruik van een afzonderlijke gebruiker bekijken
Zo bekijkt u het gebruik van Responses en Chat Completions door één gebruiker:
Ga in het gebruiksdashboard naar API-mogelijkheden > Responses en Chat Completions.
Selecteer Filteren op.
Selecteer onder Gebruikers de gebruiker en selecteer vervolgens Filters toepassen.
Tokens per minuut bekijken
Op pagina's met gebruiksdetails kunt u een interval selecteren. Selecteer een interval van 1 minuut om het aantal tokens per minuut (TPM) te bekijken.
Dit interval geldt voor gebruiksgegevens, niet voor factureringsgegevens.
Gebruiksgegevens exporteren
Er geldt geen limiet voor het datumbereik van de export. Exports over een lange periode kunnen over meerdere bestanden worden verdeeld.
Zie voor de maandelijkse factuurafstemming en export van afzonderlijke posten: Maandelijkse gebruiksgegevens exporteren.
Toegekende credits bekijken
Details over toegekende credits vindt u op de factureringspagina van uw organisatie.
Toegekende credits en API-gebruik beantwoorden verschillende vragen: toegekende credits tonen de credits van uw organisatie, terwijl het gebruik de API-activiteit 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 hoger dan nul, maar de projectuitgaven zijn nul
Controleer of het gebruik van het model onder uw toewijzing voor het schaalniveau valt. Als al het gebruik van dat model binnen de TPM-toewijzing van het schaalniveau valt, kan het project gebruik tonen zonder aanvullende modelkosten.
De abonnementskosten van het schaalniveau blijven op organisatieniveau. Zo bekijkt u deze:
Wis het projectfilter in het gebruiksdashboard.
Selecteer Uitgavencategorieën.
Meerdere organisaties bekijken
Het gebruiksdashboard combineert geen kosten- of gebruiksgegevens van verschillende organisaties. Elke organisatie, waaronder een suborganisatie, wordt afzonderlijk behandeld.
Selecteer een suborganisatie in de organisatiekiezer om deze te bekijken.
Als u gecombineerde rapportage nodig hebt, kunt u projecten binnen één organisatie gebruiken in plaats van afzonderlijke suborganisaties. U kunt ook de Usage-API gebruiken voor een aangepaste analyse.
Tokengebruik in een API-reactie controleren
De veldnamen voor tokengebruik verschillen per 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 |
Een reactie van Chat Completions kan bijvoorbeeld het volgende bevatten:
| { "usage": { "prompt_tokens": 13, "completion_tokens": 7, "total_tokens": 20 }} |
Afhankelijk van het endpoint en model kunnen de gebruiksdetails ook aantallen tokens voor gecachte invoer en redenering bevatten. Deze helpen verklaren waarom de zichtbare lengte van een reactie niet het volledige tokengebruik weergeeft.
Zie voor uitleg over de verschillende tokencategorieën: Tokens begrijpen en tellen.
Gebruiksgegevens ophalen uit gestreamde Chat Completions
Neem voor een streamingverzoek voor Chat Completions het volgende op:
| { "stream": true, "stream_options": { "include_usage": true }} |
Als include_usage is ingeschakeld, bevat een extra chunk vóór data: [DONE] de gebruiksgegevens voor het volledige verzoek. De choices-array daarvan is leeg. Andere chunks hebben een null-waarde voor usage.
Als de stream wordt onderbroken, ontvangt u die laatste gebruikschunk mogelijk niet. Het ontbreken van een laatste chunk bewijst niet dat het verzoek geen tokens heeft gebruikt.
Deze configuratie geldt specifiek voor Chat Completions. Zie voor meer informatie de API-referentie voor Chat Completions.