OpenAI
Diese Seite wurde maschinell übersetzt. Den Originalartikel auf Englisch ansehen.

API-Nutzung und Kosten prüfen

Prüfe API-Aktivitäten in Analysen und die Tokenanzahl in API-Antworten. Erfahre mehr über Projektfilter, Exporte und Scale Tier-Kosten.

Aktualisiert: yesterday

Übersicht

Du kannst die API-Nutzung auf zwei Arten prüfen:

  • Nutze Analysen > Nutzung, um API-Aktivitäten für aktuelle und vergangene Berichtszeiträume zu 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 Token zählen zur API-Nutzung deines Kontos. Für sie gelten dieselben Nutzungsregeln und Preise.

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 in der API-Plattform Analysen und wähle Nutzung, um das aktuelle Projekt zu prüfen. Für organisationsweite Berichte wähle Organisationsanalysen. Wähle den Berichtszeitraum aus, den du prüfen möchtest. Prüfe ihn erneut, nachdem du zwischen Projekt- und Organisationsanalysen gewechselt hast.

Dashboard-Daten werden in UTC angezeigt. Berücksichtige diese Zeitzone, wenn du Aktivitäten im Dashboard mit deinen Anwendungsprotokollen vergleichst.

Es kann etwas dauern, bis die neueste Nutzung im Dashboard erscheint. Wenn die neuesten Aktivitäten fehlen, prüfe die Anzeige später erneut.

Nutzung filtern

In den Analysen eines Projekts ist die Nutzung auf das ausgewählte Projekt beschränkt. Wähle in Organisationsanalysen unter Projekt die Projekte aus, die du prüfen möchtest. Alle Projekte umfasst sämtliche Projekte der Organisation unter Berücksichtigung aller weiteren ausgewählten Filter.

Grenze die Nutzung über Filter nach API-Quellen, API-Schlüsseln, Modellen, Personen oder Verarbeitungsstufe ein. Unter API-Quellen kannst du Alle API-Quellen, Agents API oder Direct API auswählen.

Entferne einzelne Auswahlen oder wähle Filter löschen, um den Bereich Filter zurückzusetzen. Beim Löschen der Filter wird nicht zwischen Projekt- und Organisationsanalysen gewechselt.

Nutze Filter im Diagramm Nutzung, um nach Batch zu filtern. Wähle Diagrammfilter zurücksetzen, um die Filter dieses Diagramms zurückzusetzen.

Wenn eine Funktion die ausgewählten Filter nicht unterstützt, sind ihre Werte möglicherweise nicht verfügbar. Nicht verfügbare Werte bedeuten nicht, dass keine Nutzung stattgefunden hat.

Wenn ein Filter einen Berechtigungsfehler anzeigt, hast du möglicherweise keinen Zugriff auf seine Optionen. Das bedeutet nicht, dass keine Nutzung erfasst wurde.

Nutzung einer einzelnen Person prüfen

  1. Öffne Nutzung in der Ansicht Analysen des Projekts oder der Organisation, die du prüfen möchtest. Wähle in der Tabelle API-Funktionen bei Responses und Chat Completions die Option Anzeigen.

  2. Wähle unter Filter die Option Personen und dann die gewünschte Person aus. Die Ergebnisse werden sofort aktualisiert.

  3. Prüfe das Diagramm und die Tabelle für diese Person.

Um die Nutzung einer Person über alle Funktionen hinweg zu prüfen, wende den Filter Personen in der Übersicht Nutzung an. Um Personen zu vergleichen, lösche diesen Filter und wähle den Tabellenreiter Personen.

Token pro Tag, Stunde oder Minute anzeigen

Wenn unter Nutzung eine Intervallauswahl verfügbar ist, wähle 1d oder 1h, um Token pro Tag oder Stunde anzuzeigen, oder 1m, um Token pro Minute (TPM) zu untersuchen. Wähle Automatisch, damit das Dashboard das Zeitintervall für deinen Berichtszeitraum festlegt. Diese Intervalle gelten für Nutzungsdaten, nicht für Abrechnungsdaten.

Wenn 1m deaktiviert ist, wähle einen kürzeren Berichtszeitraum oder nutze Zum Zoomen auswählen und ziehe mit gedrückter Maustaste über das Diagramm, um den Bereich einzugrenzen. Wähle anschließend 1m. Drücke Esc, um eine Zoomauswahl abzubrechen. Wähle den aktuellen Datumsbereich in der Symbolleiste von Analysen aus, um einen anderen Berichtszeitraum festzulegen.

Nutzungsdiagramme und -tabellen prüfen

Wähle unter Messwerte eine oder mehrere Datenreihen aus, die gemeinsam angezeigt werden sollen, darunter Eingabetoken, Nicht zwischengespeicherte Eingabetoken, Zwischengespeicherte Eingabetoken, In den Cache geschriebene Eingabetoken, Audio-Eingabetoken, Ausgabetoken und Audio-Ausgabetoken. Die verfügbaren Messwerte hängen von der Funktion ab. Anhand der Legende kannst du die einzelnen Datenreihen zuordnen.

Mit Gruppieren nach kannst du die Nutzung nach Kategorien wie Projekt, Person oder Modell gliedern, sofern verfügbar. Filter bestimmen, welche Nutzung einbezogen wird; die Gruppierung bestimmt, wie sie dargestellt wird. Wechsle zwischen Linien- und Balkendiagrammen, um Trends zu untersuchen oder Kategorien zu vergleichen.

Über die Tabellenreiter unter Nutzung kannst du die verfügbaren Aufschlüsselungen prüfen. Die Tabellen zeigen für jede Zeile die relevanten Messwerte, etwa Anfragen, Eingabe- und Ausgabetoken oder funktionsspezifische Einheiten.

Wähle unter API-Funktionen bei einer Funktion Anzeigen, um die zugehörigen detaillierten Diagramme und Aufschlüsselungen zu öffnen. Responses und Chat Completions enthält separate Diagramme für Token und Anfragen sowie den Messwert Modellanfragen. Die Reiter zur Aufschlüsselung verwenden dieselben Dimensionen wie die Übersicht, jedoch ohne den Reiter API-Funktionen. Klicke in der Pfadnavigation auf Nutzung, um zur Übersicht zurückzukehren.

Nachdem du eine Option unter Gruppieren nach ausgewählt hast, fasst das Diagramm zusätzliche Kategorien möglicherweise unter Sonstige zusammen. Wenn Sonstige in der Diagrammlegende erscheint, wähle die Bezeichnung aus, um die enthaltenen Kategorien und ihre Nutzungswerte anzuzeigen.

Wähle Dashboards vergleichen, um Nutzung neben einem anderen Dashboard für denselben Berichtszeitraum anzuzeigen. Wähle die Ansichten über Linkes Dashboard und Rechtes Dashboard aus. Wenn das gewählte Zeitintervall für die Dashboard-Kombination nicht verfügbar ist, wechselt die Ansicht zu Automatisch. Wähle Vergleich beenden, um zum Dashboard zurückzukehren.

Unbekannte Nutzung untersuchen

Wenn unter Nutzung Aktivitäten angezeigt werden, die du keinen Anfragen in deinen Anwendungsprotokollen zuordnen kannst, prüfe Folgendes:

  1. Vergewissere dich, dass Organisation, Projektauswahl und Berichtszeitraum stimmen. Verwende UTC, wenn du Zeitstempel im Dashboard mit deinen Anwendungsprotokollen vergleichst.

  2. Nutze die Projektansicht für das betroffene Projekt oder wähle es unter Projekt in Organisationsanalysen aus. Grenze die Nutzung anschließend über Filter nach API-Schlüssel und Modell ein und wähle einen kürzeren Berichtszeitraum.

  3. Vergleiche die Aktivitäten mit Protokollen für denselben Zeitraum, dasselbe Projekt und denselben API-Schlüssel. Prüfe, ob deine Protokolle alle Anwendungen oder Integrationen abdecken, die diesen Schlüssel verwenden.

  4. Wenn mehrere Anwendungen oder Integrationen dasselbe Projekt oder denselben API-Schlüssel nutzen, lässt sich aus dem Gesamtwert allein möglicherweise nicht erkennen, welche davon eine Anfrage gesendet hat. Vergleiche das Dashboard mit den Aufzeichnungen jeder Anwendung für denselben UTC-Zeitraum.

  5. Wenn du die Nutzung weiterhin nicht zuordnen kannst, kontaktiere den OpenAI-Support. Gib dabei den betroffenen UTC-Zeitraum, die Organisations- und Projekt-IDs, die Kennung des API-Schlüssels sowie relevante Screenshots oder Protokolle an. Gib, falls verfügbar, auch die Anfrage-IDs an. Gib keine geheimen API-Schlüssel weiter.

Nutzungsdaten exportieren

Um Nutzungsdaten zu exportieren, wähle in der Symbolleiste von Analysen das Symbol CSV exportieren und anschließend Aktivitätsdaten.

  1. Wähle die API-Funktion und unter Gruppieren nach eine oder mehrere Dimensionen aus.

  2. Prüfe API-Quelle, Projekte, Personen, API-Schlüssel und Modelle. Die Vorauswahl für Projekte und API-Quelle wird aus Analysen übernommen. Wähle die übrigen Exportfilter im Dialog aus.

  3. Wähle Dateiformat, Startzeit, Endzeit und Zeitintervall und anschließend Herunterladen. Datumsangaben umfassen vollständige UTC-Tage.

Aktivitäts- und Kostendaten lassen sich ab 00:00 Uhr UTC des Datums vor einem Kalenderjahr bis heute anzeigen und exportieren. Für ältere Daten kontaktiere den OpenAI-Support. Tagesdaten werden in Dateien exportiert, die jeweils einen Zeitraum von 31 Tagen abdecken.

Informationen zum monatlichen Rechnungsabgleich und zum Export einzelner Positionen findest du im Artikel Monatliche Nutzungsdetails exportieren.

Wenn ein Export von Aktivitätsdaten Zeilen mit negativen Werten enthält, vergleiche Zeilen mit derselben Einheit, Gruppierung und denselben Datumsangaben. Die in Rechnung gestellten Beträge findest du unter Kostendaten. Eine Aktivitätszeile mit einem negativen Wert allein belegt nicht, dass deiner Rechnung eine Gutschrift zugeordnet wurde.

Ausgaben prüfen

Öffne Analysen und wähle Ausgaben, um die Kosten für das aktuelle Projekt zu prüfen. Für organisationsweite Kosten wähle Organisationsanalysen und anschließend Ausgaben.

Prüfe den aktuellen Datumsbereich und die Filter, bevor du Kosten und Nutzung vergleichst. Nutzung und Ausgaben bieten unterschiedliche Filter. Ein Filter, der in einem Dashboard verfügbar ist, lässt sich möglicherweise nicht auf das andere anwenden.

Grenze die Ausgaben über API-Quellen, API-Schlüssel, Modelle und Einzelpositionen ein. Wähle in den Organisationsanalysen unter Projekt die Projekte aus, die du prüfen möchtest. Die verfügbaren Aufschlüsselungen findest du in den Tabellenreitern Einzelpositionen, API-Schlüssel, Personen, Projekte und Modelle.

Wenn kein Wert für das Ausgabenlimit verfügbar ist, bedeutet das nicht, dass dein Limit null beträgt oder ein neues Limit angewendet wurde. Zugriffsberechtigungen, ein nicht festgelegtes Limit oder eine fehlgeschlagene Anfrage können verhindern, dass das Dashboard einen Wert anzeigt.

Dienststatus prüfen

Wenn deine Organisation Zugriff auf Dienststatus hat, öffne dieses Dashboard unter Analysen, um die API-Leistung zu prüfen. Informationen zu den Zugangsvoraussetzungen und Definitionen der Messwerte findest du im Artikel Fehlerbehebung bei API-Fehlern und Latenz.

Credits-Zuteilungen anzeigen

Details zu Credits-Zuteilungen findest du auf der Abrechnungsseite deiner Organisation.

Credits-Zuteilungen und API-Nutzung beantworten unterschiedliche Fragen: Credits-Zuteilungen zeigen die Credits, die deiner Organisation zugeordnet sind, während die Nutzung die API-Aktivitäten deiner Organisation zeigt.

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.

Die Nutzung ist größer als null, die Projektausgaben liegen jedoch bei null

Prüfe, ob die Nutzung des Modells durch dein Scale Tier-Kontingent abgedeckt ist. Wenn die gesamte Nutzung dieses Modells innerhalb des TPM-Kontingents von Scale Tier liegt, kann das Projekt Nutzung ohne zusätzliche Modellausgaben anzeigen.

Die Abonnementkosten für Scale Tier verbleiben auf Organisationsebene. Prüfe die organisationsweiten Ausgaben, statt dich auf die Ausgaben eines einzelnen Projekts zu verlassen.

Mehrere Organisationen prüfen

Das Nutzungsdashboard führt Kosten- oder Nutzungsdaten verschiedener Organisationen nicht zusammen. Jede Organisation, auch eine Unterorganisation, wird separat behandelt.

Um eine Unterorganisation anzuzeigen, wähle sie in der Organisationsauswahl aus.

Wenn du zusammengefasste Berichte benötigst, kannst du Projekte innerhalb einer Organisation statt separater Unterorganisationen verwenden. Alternativ kannst du die Usage API für eigene Analysen nutzen.

Tokennutzung in einer API-Antwort prüfen

Die Feldnamen für die Tokennutzung hängen vom Endpunkt ab.

TokenanzahlChat CompletionsResponses
Eingabetokenusage.prompt_tokensusage.input_tokens
Ausgabetokenusage.completion_tokensusage.output_tokens
Token insgesamtusage.total_tokensusage.total_tokens

Antworten von Chat Completions können Informationen zur Tokennutzung enthalten. Beispiele hierfür sind:

{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}

Je nach Endpunkt und Modell können die Nutzungsdetails auch die Anzahl zwischengespeicherter Eingabe-Token und Reasoning-Token enthalten. Diese Angaben helfen zu erklären, warum die sichtbare Länge einer Antwort nicht ihren gesamten Token-Verbrauch widerspiegelt.

Eine Erklärung der verschiedenen Token-Kategorien findest du im Artikel Token verstehen und zählen.

Wenn eine Transkriptionsantwort den Token-Verbrauch ausweist, sind Audio- und Texteingabe-Token bereits in input_tokens enthalten. Addiere diese Bestandteile nicht erneut zur Gesamtzahl der Eingabe-Token. Vergleiche output_tokens separat.

Nutzungsdaten aus gestreamten Chat Completions abrufen

Füge 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 Nutzungsdaten für die gesamte Anfrage. Sein choices-Array ist leer. In anderen Chunks hat usage den Wert null.

Wird der Stream unterbrochen, erhältst du diesen letzten Chunk mit den Nutzungsdaten möglicherweise nicht. Ein fehlender letzter Chunk belegt nicht, dass die Anfrage keine Token verbraucht hat.

Diese Konfiguration gilt nur für Chat Completions. Weitere Informationen findest du in der Referenz zur Chat Completions API.

War dieser Artikel hilfreich?