Zum Hauptinhalt springen
Die Registerkarte Nutzung zeigt, wie Ihre Organisation die DeepMask API nutzt. Hier sehen Sie, was Sie in diesem Monat ausgegeben haben und welche Limits für alle Ihre Schlüssel gelten. Im Anfrageprotokoll schlagen Sie einzelne Anfragen nach. Sie können das Protokoll auch als CSV-Datei für Ihre eigenen Auswertungen exportieren. Um die Registerkarte zu öffnen, klicken Sie unten in der Chat-Seitenleiste auf Ihren Namen, wählen Sie Benutzereinstellungen, klicken Sie in der Seitenleiste der Einstellungen auf API und wählen Sie dann die Registerkarte Nutzung. Nur Administratoren der Organisation sehen die Einstellungsseite API. Wer die API nutzen kann, erfahren Sie in der API-Übersicht.
Registerkarte „Nutzung“ mit der Karte „Monatliche API-Kosten“, der Karte „Gateway-Ausgabenlimit“ mit Datum der Rücksetzung und der Schaltfläche „Limit verwalten“, der Karte „API-Limits“ und der Tabelle „Anfrageprotokoll“ mit Zeitraumauswahl und der Schaltfläche „CSV exportieren“.

Die Registerkarte „Nutzung“ zeigt die monatlichen API-Kosten, Ihr Gateway-Ausgabenlimit, die API-Limits und das Anfrageprotokoll.

Die Karten Gateway-Ausgabenlimit und API-Limits erscheinen, nachdem Sie zum ersten Mal auf API-Abrechnung aktivieren geklickt haben. Siehe Abrechnung.

Monatliche API-Kosten

Die Karte Monatliche API-Kosten zeigt, was Ihrer Organisation im aktuellen Abrechnungszeitraum bisher berechnet wurde. Auf der Karte sehen Sie:
  • Den Abrechnungszeitraum neben dem Titel. Ein Zeitraum ist ein Kalendermonat in UTC, von 00:00 UTC am 1. bis zum Monatsende.
  • Den in diesem Zeitraum bisher berechneten Betrag. Er enthält die Gebühr von 3 % und keine Steuern, wie der Hinweis „Monatliche Abrechnung. Inklusive 3 % Gebühr, vor Steuern.“ angibt. Auf Ihrer Rechnung kommt gegebenenfalls die Umsatzsteuer hinzu.
  • Die Zahl der in diesem Zeitraum abgerechneten Anfragen, zum Beispiel „1 abgerechnete Anfrage“ oder „248 abgerechnete Anfragen“.
Eine Anfrage zählt zu dem Monat, in dem sie begonnen hat. Anfragen, die ein Ausgabenlimit blockiert hat, werden nicht berechnet und daher auch nicht gezählt. Anfragen, die noch nicht berechnet wurden, sind in der Zahl ebenfalls nicht enthalten. Auch eine Anfrage mit unklarem Ergebnis wird weder berechnet noch gezählt, etwa nach einem Serverfehler oder Timeout beim Modellanbieter oder wenn ein Stream auf Seiten von DeepMask oder des Anbieters während der Übertragung abbricht. Trifft die Nutzung dafür später doch noch ein, rechnet DeepMask sie wie jede andere Nutzung ab. Unklare Ergebnisse pausieren die Anfragen Ihrer Organisation erst, wenn innerhalb von 24 Stunden mehr als 20 davon auftreten. Siehe Unklare Ergebnisse. Es kann einige Minuten dauern, bis neue Kosten erscheinen. Die Seite aktualisiert sich nicht von selbst. Klicken Sie daher oben auf der Seite auf Aktualisieren, um die aktuellen Werte zu sehen.

Anfragen in Prüfung

Manchmal zeigt die Karte eine Warnung wie „Anfragen in Prüfung: 2. Die Summe dieses Monats kann sich noch ändern.“ Das bedeutet, dass DeepMask die erfasste Nutzung einiger Anfragen dieses Monats noch prüft, bevor feststeht, was berechnet wird. Das passiert, wenn DeepMask diese Nutzung noch nicht verifizieren oder ihren Preis noch nicht bestimmen kann, zum Beispiel während DeepMask den aktuellen Preis eines Modells bestätigt oder wenn Nutzung für eine Anfrage erfasst wird, die fehlgeschlagen ist oder abgelehnt wurde. Die Zahl kann auch unklare Ergebnisse enthalten, die über das Kontingent von 20 innerhalb von 24 Stunden hinausgehen. Der Betrag und die Zahl der abgerechneten Anfragen können sich ändern, sobald die Prüfung abgeschlossen ist.
Solange die Karte diese Warnung zeigt, sind die API-Anfragen Ihrer Organisation pausiert. Anfragen aller Ihrer Schlüssel geben 503 mit API_ADMISSION_UNAVAILABLE zurück, bis die Prüfung abgeschlossen ist. Eine Anfrage, die bereits in Bearbeitung war, gibt 503 mit API_ACCOUNTING_REVIEW zurück. Anfragen können auch ohne diese Warnung pausiert sein, zum Beispiel wenn die Nutzung einer abgeschlossenen Anfrage verspätet eintrifft, wenn Nutzung nicht zu der Anfrage passt, zu der sie gehört, oder wenn die geprüfte Nutzung aus einem früheren Monat stammt. Was Ihre Anwendungen in dieser Zeit erhalten und wann Sie sich an den Support wenden sollten, erfahren Sie unter Wann Anfragen pausiert werden.

Gateway-Ausgabenlimit

Die Karte Gateway-Ausgabenlimit zeigt Ihr organisationsweites Limit. Es gilt gemeinsam für alle Ihre API-Schlüssel. Sobald die Ausgaben Ihrer Organisation es überschreiten, lehnt DeepMask weitere Anfragen ab, bis das Limit zurückgesetzt wird oder Sie es erhöhen. Die Karte zeigt:
  • Den Betrag des Limits in €.
  • Das Datum der Rücksetzung, zum Beispiel „Wird am 1. Dez. 2026 zurückgesetzt“. Das Limit wird jeweils um 00:00 UTC am 1. eines Monats zurückgesetzt. Kann das Datum nicht geladen werden, zeigt die Karte „Datum der Rücksetzung nicht verfügbar“.
  • Den Hinweis „Gilt für Modellkosten vor Gebühren und Steuern.“ Für das Limit zählen nur die Modellkosten, während die Karte Monatliche API-Kosten die Gebühr von 3 % enthält.
Die Karte zeigt nur das Limit selbst, nicht den Betrag, den Ihre Organisation davon bereits verbraucht hat. Wie Sie Ihren Verbrauch im Verhältnis zum Limit abschätzen, erfahren Sie unter Was ein Limit zählt. Um das Limit zu ändern, klicken Sie auf Limit verwalten. Dadurch öffnet sich die Registerkarte Abrechnung, und das Feld für das Limit ist direkt bearbeitbar. Wie das organisationsweite Limit und die Schlüssellimits zusammenwirken, erfahren Sie unter Ausgabenlimits.
Das Datum der Rücksetzung erscheint in der Zeitzone Ihres Browsers. Befinden Sie sich westlich von UTC, kann die Karte für eine Rücksetzung um 00:00 UTC am 1. eines Monats den letzten Tag des Vormonats anzeigen.

API-Limits

Die Karte API-Limits zeigt, wie viel Datenverkehr Ihre Organisation an die API senden kann. Alle Ihre Schlüssel teilen sich diese Limits. Anfragen über einem Limit werden mit dem Fehler 429 abgelehnt. Die Karte zeigt die aktuellen Werte Ihrer Organisation. Auf dieser Seite können Sie sie nicht ändern. Wie Sie höhere Limits anfordern, erfahren Sie unter Höhere Limits anfordern. Unter Limits und faire Nutzung finden Sie die Standardwerte und erfahren, wie jedes Limit gezählt wird. Wie Sie mit einem 429-Fehler umgehen, erfahren Sie unter 429: Raten- und Kapazitätslimits.

Anfrageprotokoll

Das Anfrageprotokoll listet die Anfragen auf, die die API-Schlüssel Ihrer Organisation gesendet haben. Damit prüfen Sie, ob eine Anfrage erfolgreich war, welchen Schlüssel und welches Modell sie verwendet hat und wie viele Tokens sie verbraucht hat.

Zeitraum auswählen

Klicken Sie über der Tabelle auf die Schaltfläche mit dem Zeitraum, um die Auswahl zu öffnen. Wählen Sie einen Eintrag unter Schnellauswahl, um ihn sofort anzuwenden. Alternativ wählen Sie im Kalender einen Start- und einen Endtag aus und klicken auf Anwenden. Ein Zeitraum kann bis zu 62 Tage umfassen. Er muss außerdem innerhalb der letzten 62 Tage liegen und spätestens heute enden. Andernfalls zeigt die Seite „Wählen Sie einen Zeitraum von bis zu 2 Monaten innerhalb der letzten 2 Monate.“ Die gewählten Tage sind Kalendertage in der Zeitzone Ihres Browsers. Ihr gewählter Zeitraum bleibt erhalten, wenn Sie auf Aktualisieren klicken.

Protokoll lesen

Die Tabelle zeigt jeweils 25 Anfragen. Klicken Sie unten auf Weitere laden, um die nächsten 25 zu sehen. Gibt es im gewählten Zeitraum keine Anfragen, zeigt die Tabelle „Keine Anfragen in diesem Zeitraum.“ Eine Anfrage erscheint kurz nach ihrem Abschluss im Protokoll. Laufende Anfragen, etwa ein langer Stream, sind darin noch nicht zu sehen. Das Protokoll aktualisiert sich nicht von selbst. Klicken Sie oben auf der Seite auf Aktualisieren, um neue Einträge zu laden.

Statuswerte

Erfasst DeepMask einen anderen Status, zeigt das Protokoll ihn unverändert an.

Anfragen, die nicht im Protokoll erscheinen

Das Protokoll listet die Anfragen auf, die DeepMask zur Verarbeitung angenommen hat, auch solche, die später mit einem Fehler endeten (Fehlgeschlagen). Außerdem listet es Anfragen auf, die ein Ausgabenlimit blockiert hat (Blockiert: Schlüssellimit oder Blockiert: Gateway-Limit). Anfragen, die DeepMask aus anderen Gründen vor der Verarbeitung ablehnt, erscheinen nie, zum Beispiel:
  • Anfragen mit einem fehlenden, ungültigen oder widerrufenen Schlüssel.
  • Anfragen, die gesendet werden, während Ihre Organisation die API nicht nutzen kann, zum Beispiel wenn die API-Abrechnung nicht aktiv ist, die Zahlung einer API-Rechnung fehlgeschlagen ist oder Anfragen wegen einer Nutzungsprüfung pausiert sind.
  • Einige Anfragen mit einem ungültigen Anfragetext, zum Beispiel mit ungültigem JSON, einem komprimierten Anfragetext, einem Bildlink oder einem Bild für ein Modell ohne Bildeingabe.
  • Anfragen an einen Endpunkt, den DeepMask nicht anbietet.
  • Anfragen für ein Modell, das der Schlüssel nicht verwenden darf.
  • Anfragen, die der Flood Guard eines Schlüssels ablehnt oder die DeepMask ablehnt, weil für den Schlüssel bereits zu viele Anfragen oder zu viele Anfragedaten gleichzeitig in Bearbeitung sind. Siehe 429: Raten- und Kapazitätslimits.
  • Aufrufe von GET /v1/models.
Andere ungültige Anfragen erscheinen dagegen im Protokoll, und zwar als Fehlgeschlagen mit 0 Tokens. Beispiele sind ein Feld, das die API nicht akzeptiert, etwa response_format, und eine Sampling-Option außerhalb ihres zulässigen Bereichs, etwa ein temperature-Wert über 2. Auch ein Bild, das ein Limit für Größe, Anzahl oder Pixel überschreitet oder nicht zu seinem Medientyp passt, erscheint auf diese Weise. Welche Felder und Wertebereiche die API akzeptiert, erfahren Sie unter Sampling-Optionen und Nicht unterstützte Parameter. Um Probleme mit diesen Anfragen zu beheben, prüfen Sie den Fehlercode in der API-Antwort. Siehe Fehler und Wiederholungen.

Anfrageprotokoll exportieren

Klicken Sie auf CSV exportieren, um das Anfrageprotokoll für den in der Tabelle angezeigten Zeitraum herunterzuladen. Die Datei enthält alle Anfragen in diesem Zeitraum, nicht nur die bereits geladenen Zeilen. Umfasst Ihr Zeitraum den heutigen Tag, enthält die Datei Anfragen bis zum Zeitpunkt des Exports. Sie kann daher Anfragen enthalten, die neuer sind als die Zeilen in der Tabelle. Ist die Tabelle leer, ist die Schaltfläche nicht verfügbar. Der Dateiname lautet deepmask-api-requests-<start>_<end>.csv und enthält den ersten und den letzten Tag Ihres Zeitraums, zum Beispiel deepmask-api-requests-2026-11-01_2026-11-07.csv.

CSV-Spalten

Die Tabelle zeigt Zeiten in Ihrer lokalen Zeitzone, die CSV-Datei dagegen in UTC. Die Datei ist UTF-8-codiert mit Byte Order Mark (BOM) und lässt sich direkt in Tabellenkalkulationen öffnen. Damit keine Tabellenformeln ausgeführt werden, setzt DeepMask ein Hochkomma (') vor jede Zelle, die mit =, +, -, @, einem Tabulator oder einem Wagenrücklauf beginnt.

Grenzen für den Export

  • Zeilenlimit: Ein Export kann bis zu 50.000 Anfragen enthalten. Enthält der Zeitraum mehr Anfragen, zeigt die Seite „Zu viele Anfragen in diesem Zeitraum für den Export. Wählen Sie einen kürzeren Zeitraum.“
  • Jeweils nur ein Export: Jede Organisation kann jeweils nur einen Export ausführen. Läuft für Ihre Organisation bereits ein Export, zum Beispiel von einem anderen Administrator oder aus einem anderen Browser-Tab, zeigt die Seite „Für diese Organisation läuft bereits ein Export. Warten Sie, bis er abgeschlossen ist.“
  • Zeitlimit: Ein großer Export kann einige Minuten dauern. Ist er nach 5 Minuten nicht abgeschlossen, zeigt die Seite einen Fehler. Wählen Sie einen kürzeren Zeitraum und versuchen Sie es erneut.
  • Abgebrochene Downloads: Bricht ein Download vorzeitig ab, zeigt die Seite einen Fehler, und es wird keine Datei gespeichert. Sie erhalten nie eine unvollständige Datei, die vollständig aussieht. Starten Sie den Export in diesem Fall erneut.
Während ein Export läuft, können Sie den Rest der Seite weiter nutzen.

Wie lange Anfrageprotokolle gespeichert werden

DeepMask speichert Anfrageprotokolle 60 Tage lang und löscht ältere Einträge automatisch. In der Zeitraumauswahl können Sie bis zu 62 Tage wählen. Die ältesten Tage im Zeitraum Letzte 2 Monate können daher leer sein.
Exportieren Sie Ihr Anfrageprotokoll regelmäßig, wenn Sie einen längeren Verlauf benötigen, zum Beispiel zu Beginn jedes Monats.
Das Löschen alter Protokolleinträge hat keine Auswirkung auf die Abrechnung. DeepMask speichert Abrechnungsdaten separat, sodass Ihre Kosten und Rechnungen vollständig bleiben.

Anfrageprotokoll und Abrechnung

Das Anfrageprotokoll ist ein Betriebsprotokoll. Es zeigt, was mit jeder Anfrage passiert ist, aber nicht, was sie gekostet hat. Die Kosten finden Sie stattdessen hier:
  • Die Karte Monatliche API-Kosten auf der Registerkarte Nutzung zeigt die laufende Summe dieses Monats.
  • Die Liste Rechnungen auf der Registerkarte Abrechnung enthält Ihre API-Rechnungen. Siehe Abrechnung.
Zwischen dem Protokoll, der Monatssumme und Ihrer Rechnung sind einige Abweichungen zu erwarten:
  • Das Protokoll umfasst jede erfasste Anfrage, die Monatssumme zählt dagegen nur berechnete Anfragen.
  • Das Protokoll zeigt Tage in Ihrer Zeitzone, Abrechnungszeiträume folgen dagegen den Kalendermonaten in UTC.
  • Anfragen aus den letzten Minuten eines Monats können auf der nächsten Rechnung erscheinen. Siehe Wann Sie eine Rechnung erhalten.
  • Die Monatssumme enthält keine Steuern, Ihre Rechnung enthält dagegen gegebenenfalls die Umsatzsteuer. Siehe Was Sie bezahlen.
Diese Seite behandelt nur die DeepMask API. Informationen zur Token-Nutzung in DeepMask Chat finden Sie unter Token-Nutzung.

Verwandte Seiten

Ausgabenlimits

Legen Sie das organisationsweite Limit und optionale Limits pro Schlüssel fest.

Abrechnung

Aktivieren Sie die API-Abrechnung, rufen Sie Rechnungen ab und erfahren Sie, wie Kosten berechnet werden.

Limits und faire Nutzung

Erfahren Sie, welche Raten-, Token- und Budgetlimits gelten und wie jedes Limit gezählt wird.

Fehler und Wiederholungen

Schlagen Sie Fehlercodes nach und erfahren Sie, welche Fehler Sie wiederholen sollten.

API-Schlüssel

Erstellen, benennen und widerrufen Sie die Schlüssel, die in Ihrem Anfrageprotokoll erscheinen.