Übersicht
Du kannst die API-Nutzung auf zwei Arten prüfen:
Im Usage Dashboard kannst du Aktivitäten in aktuellen und vergangenen Abrechnungszeiträumen prüfen.
Lies die Nutzungsinformationen in einer API-Antwort, um eine einzelne Anfrage zu prüfen.
Playground verwendet dieselben API-Aufrufe wie deine Anwendungen. Die dabei verwendeten Tokens werden auf die API-Nutzung deines Kontos angerechnet und unterliegen denselben Nutzungsregeln und Preisen.
Zugriff auf das Dashboard
Du musst Eigentümer deiner Organisation sein oder über die Berechtigung Usage Dashboard verfügen, um auf das Usage Dashboard zugreifen zu können.
Nutzung im Dashboard prüfen
Öffne das Usage Dashboard, wähle die zu prüfende Organisation und den relevanten Berichtszeitraum aus.
Die Daten im Dashboard werden in UTC angezeigt. Berücksichtige diese Zeitzone, wenn du die Aktivitäten im Dashboard mit deinen Anwendungsprotokollen vergleichst.
Projekte auswählen
Das Dashboard hat eine eigene Projektauswahl. Sie funktioniert unabhängig von dem Projekt, das an anderer Stelle auf der API-Plattform ausgewählt ist.
Über die Auswahl im Dashboard kannst du ein Projekt, mehrere Projekte oder alle Projekte prüfen. Entferne die ausgewählten Projekte, um die Gesamtdaten der Organisation anzuzeigen. Wenn keine Projekte ausgewählt sind, zeigt das Dashboard die Daten aller Projekte an.
Nutzung einer einzelnen Person prüfen
So prüfst du die Nutzung von Responses und Chat Completions durch eine einzelne Person:
Rufe im Usage Dashboard API-Funktionen > Responses und Chat Completions auf.
Wähle Filtern nach aus.
Wähle unter Nutzer die gewünschte Person und anschließend Filter anwenden aus.
Tokens pro Minute anzeigen
Auf den Detailseiten zur Nutzung kannst du ein Intervall auswählen. Wähle ein einminütiges Intervall aus, um die Tokens pro Minute (TPM) zu prüfen.
Dieses Intervall gilt für Nutzungsdaten, nicht für Abrechnungsdaten.
Nutzungsdaten exportieren
Der Zeitraum für den Export ist nicht begrenzt. Exporte über einen langen Zeitraum können auf mehrere Dateien aufgeteilt werden.
Informationen zum monatlichen Rechnungsabgleich und zum Export einzelner Positionen findest du unter Monatliche Nutzungsdetails exportieren.
Gutgeschriebene Credits anzeigen
Details zu gutgeschriebenen Credits findest du auf der Abrechnungsseite deiner Organisation.
Gutgeschriebene Credits und die API-Nutzung beantworten unterschiedliche Fragen: Die Gutschriften zeigen die deiner Organisation zugeordneten Credits, die Nutzung zeigt ihre API-Aktivitäten.
Nutzung und Kosten des Scale Tier prüfen
Wenn Scale Tier für deine Organisation aktiviert ist und du über den erforderlichen Zugriff verfügst, öffne die Seite zur Scale-Tier-Nutzung, um detaillierte Nutzungsdaten aufzurufen.
Die Kosten für Scale-Tier-Pakete werden der Organisation und nicht einzelnen Projekten zugeordnet.
Nutzung liegt über null, aber die Projektausgaben sind null
Prüfe, ob die Nutzung des Modells durch deine Scale-Tier-Zuteilung abgedeckt ist. Wenn die gesamte Nutzung dieses Modells innerhalb der TPM-Zuteilung des Scale Tier liegt, kann das Projekt eine Nutzung ohne zusätzliche Modellausgaben anzeigen.
Die Abonnementkosten für den Scale Tier verbleiben auf Organisationsebene. So prüfst du sie:
Entferne den Projektfilter im Usage Dashboard.
Wähle Ausgabenkategorien aus.
Mehrere Organisationen prüfen
Das Usage Dashboard führt Kosten- oder Nutzungsdaten verschiedener Organisationen nicht zusammen. Jede Organisation, einschließlich einer Unterorganisation, wird separat behandelt.
Um eine Unterorganisation anzuzeigen, wähle sie in der Organisationsauswahl aus.
Wenn du einen gemeinsamen Bericht benötigst, kannst du statt separater Unterorganisationen Projekte innerhalb einer Organisation verwenden oder mit der Usage API eine individuelle Analyse erstellen.
Token-Nutzung in einer API-Antwort prüfen
Die Feldnamen für die Token-Nutzung hängen vom Endpunkt ab.
| Token-Anzahl | Chat Completions | Responses |
| Eingabe-Tokens | usage.prompt_tokens | usage.input_tokens |
| Ausgabe-Tokens | usage.completion_tokens | usage.output_tokens |
| Tokens insgesamt | usage.total_tokens | usage.total_tokens |
Eine Antwort von Chat Completions kann beispielsweise Folgendes enthalten:
| { "usage": { "prompt_tokens": 13, "completion_tokens": 7, "total_tokens": 20 }} |
Je nach Endpunkt und Modell können die Nutzungsdetails auch die Anzahl der Tokens für zwischengespeicherte Eingaben und für das Reasoning enthalten. Diese Angaben erklären, warum die sichtbare Länge einer Antwort nicht deren gesamte Token-Nutzung widerspiegelt.
Eine Erklärung der verschiedenen Token-Kategorien findest du unter Tokens verstehen und zählen.
Nutzungsdaten aus gestreamten Chat Completions abrufen
Füge bei einer Streaming-Anfrage an Chat Completions Folgendes hinzu:
| { "stream": true, "stream_options": { "include_usage": true }} |
Wenn include_usage aktiviert ist, enthält ein zusätzlicher Chunk vor data: [DONE] die Nutzung für die gesamte Anfrage. Das choices-Array dieses Chunks ist leer. Bei anderen Chunks hat usage den Wert null.
Wenn der Stream unterbrochen wird, erhältst du diesen abschließenden Nutzungs-Chunk möglicherweise nicht. Ein fehlender abschließender Chunk belegt nicht, dass für die Anfrage keine Tokens verwendet wurden.
Diese Konfiguration gilt ausschließlich für Chat Completions. Weitere Informationen findest du in der Referenz zur Chat Completions API.