Dokumentation

Dokumentation

Schlüsselgruppen

Geben Sie jedem Ihrer Kunden eigene API-Schlüssel, fassen Sie sie in einer Gruppe zusammen, lesen Sie für jeden Zeitraum ab, was jeder Kunde und jeder Schlüssel ausgegeben hat, und begrenzen Sie, was jeder Kunde im Monat ausgeben kann. Ein Konto, ein Guthaben.

Eine Gruppe ist ein Ordner für API-Schlüssel in Ihrem Konto, zum Beispiel einer pro Kunde: CID000001, CID000002. Ein Schlüssel in einer Gruppe ruft die API genauso auf wie jeder andere, und eine Gruppe hat kein eigenes Guthaben, keine eigenen Aufladungen und keine eigene Anmeldung; sie kann ein monatliches Ausgabenlimit für alle ihre Schlüssel zusammen haben. Ein Schlüssel gehört zu einer Gruppe oder zu keiner.

Gruppen in drei Schritten einrichten

  • Gruppe anlegen. Wählen Sie auf der Seite API-Schlüssel „Neue Gruppe“ und benennen Sie sie nach dem Kunden.
  • Schlüssel hineinlegen. Wählen Sie in der Überschrift der Gruppe „Neuer Schlüssel“, um darin einen Schlüssel zu erstellen. Um einen vorhandenen Schlüssel einzuordnen, öffnen Sie sein Menü und wählen Sie „In Gruppe verschieben“.
  • Zahlen ablesen. Die Seite API-Schlüssel zeigt, was jeder Schlüssel in diesem Kalendermonat ausgegeben hat, und die Summe jeder Gruppe. Die Seite Nutzung zeigt dieselben Schlüssel unter ihren Gruppen für heute, die letzten 7 oder 30 Tage, diesen Monat, den letzten Monat oder selbst gewählte Tage, bis zu 90.

Einen Monat ablesen und exportieren

Wählen Sie oben auf der Seite Nutzung „Letzter Monat“ (oder „Dieser Monat“, oder „Benutzerdefiniert“ für selbst gewählte Tage). Unter „Nach API-Schlüssel“ zeigt die Überschrift jeder Gruppe deren Kosten und Aufrufe. Mit dem Gruppenmenü oben beschränken Sie die ganze Seite auf eine Gruppe: ihre Zahlen, ihr Diagramm, ihre Modelle und ihre Aufrufe. „CSV exportieren“ lädt herunter, was die Seite zeigt, mit demselben Zeitraum und derselben Gruppe, nach Schlüssel oder nach Tag.

Nach Schlüssel hat die Datei eine Zeile pro Schlüssel und Gruppe und heißt etwa kunavo-cost-by-key_2026-10-01_2026-10-31.csv. Sie enthält jeden Schlüssel mit Aufrufen im Zeitraum, auch widerrufene, unter der Gruppe, in der jeder Aufruf erfolgte, und jeden aktiven Schlüssel ohne Aufrufe in seiner jetzigen Gruppe mit 0, sodass die Schlüsselliste jedes Kunden vollständig ist. Die Gruppen stehen in der Reihenfolge des Dashboards, die Schlüssel jeder Gruppe vom teuersten zum günstigsten, Schlüssel ohne Gruppe zuletzt. Nach Tag hat die Datei zuerst eine Spalte date und eine Zeile für jeden Tag, an dem ein Schlüssel in einer Gruppe Aufrufe getätigt hat.

SpalteInhalt
groupDie Gruppe, in der die Aufrufe erfolgten; leer bei Aufrufen ohne Gruppe. Eine seither gelöschte Gruppe hat (deleted) hinter ihrem Namen.
key_nameDer Name des Schlüssels.
key_prefixDer Anfang des Schlüssels, wie ihn das Dashboard zeigt. Nie der ganze Schlüssel.
key_statusactive oder revoked.
callsAufrufe mit dem Schlüssel im Zeitraum.
errorsDie davon fehlgeschlagenen Aufrufe. Ein fehlgeschlagener Aufruf kostet nichts.
input_tokensEingabe-Tokens, einschließlich Cache-Lese- und Cache-Schreibvorgängen.
output_tokensAusgabe-Tokens.
cached_input_tokensDer Teil der Eingabe-Tokens, der aus dem Prompt-Cache gelesen wurde.
cache_write_tokensDer Teil der Eingabe-Tokens, der in den Prompt-Cache geschrieben wurde.
cost_usdWas für die Aufrufe berechnet wurde, in US-Dollar, auf acht Nachkommastellen.
Namen, die wie Formeln aussehen. Ein Gruppen- oder Schlüsselname, der mit =, +, - oder @ beginnt, wird mit einem vorangestellten Apostroph geschrieben, damit eine Tabellenkalkulation ihn als Text anzeigt, statt ihn als Formel auszuführen.

Begrenzen, was jede Gruppe im Monat ausgibt

Öffnen Sie auf der Seite API-Schlüssel das Menü einer Gruppe und wählen Sie „Monatslimit festlegen“. Das Limit zählt, was alle Schlüssel der Gruppe zusammen in einem Kalendermonat (UTC) ausgeben: die Aufrufe, die jeder Schlüssel getätigt hat, während er in der Gruppe war. Eine Anfrage, die die Gruppe darüber bringen würde, wird mit 402 abgelehnt und nicht berechnet. Lassen Sie das Feld für kein Limit leer, oder setzen Sie 0, um alle Schlüssel der Gruppe zu pausieren, ohne einen zu widerrufen.

Das eigene Monatslimit eines Schlüssels gilt weiterhin, und das zuerst erreichte Limit lehnt die Anfrage ab. Die Überschrift der Gruppe zeigt ihren Monat im Verhältnis zum Limit, mit „Limit erreicht“, sobald Anfragen abgelehnt werden, und „Pausiert“, wenn das Limit 0 ist.

Kunavo schreibt an die Adresse Ihres Kontos, wenn eine Gruppe oder ein Schlüssel mit eigenem Limit 80 % seines Monatslimits verbraucht hat, und noch einmal, wenn deswegen Anfragen abgelehnt werden: höchstens eine E-Mail jeder Art pro Limit und Monat.

Wie die Beträge gezählt werden

  • Kosten sind der berechnete Betrag. Die Kosten eines Aufrufs sind der Betrag, der bei seinem Abschluss von Ihrem Guthaben abgezogen wurde. Ein fehlgeschlagener Aufruf kostet nichts.
  • Monate und Tage sind UTC. Dieser Monat beginnt am 1. um 00:00 UTC. In Yangon (UTC+6:30) zum Beispiel endet der Oktober am 1. November um 06:30 Ortszeit. Die Seite Nutzung zeigt die Daten des angezeigten Zeitraums an.
  • Ein Aufruf zählt in der Gruppe, in der sein Schlüssel beim Aufruf war. Verschieben Sie einen Schlüssel in eine andere Gruppe, zählen dort nur seine Aufrufe von da an; seine früheren Aufrufe bleiben, wo sie waren. Daher kann der Monat einer Gruppe auf der Seite API-Schlüssel von der Summe der Schlüssel abweichen, die jetzt darunter stehen.
  • Ein widerrufener Schlüssel bleibt in seiner Gruppe. Was er vor dem Widerruf ausgegeben hat, zählt weiter in den Summen dieser Gruppe und erscheint im Export.
  • Eine gelöschte Gruppe behält ihre Aufrufe. Sie bleiben auf der Seite Nutzung und im Export unter ihrem Namen, als gelöscht markiert, und der Name kann für eine neue Gruppe wieder verwendet werden.
  • Drei Stellen, ein Betrag. Für einen Kalendermonat sind die Summe einer Gruppe auf der Seite API-Schlüssel, ihre Summe unter „Dieser Monat“ auf der Seite Nutzung und die Summe ihrer Zeilen in der CSV-Datei auf den Cent gleich.

Fragen

  • Hat jede Gruppe ein eigenes Guthaben? Nein. Alle Gruppen nutzen das eine Guthaben Ihres Kontos. Um zu begrenzen, was ein Kunde ausgeben kann, legen Sie ein monatliches Limit für seine Gruppe oder für jeden seiner Schlüssel fest.
  • Können sich meine Kunden anmelden, um ihre Nutzung zu sehen? Nein. Gruppen sind nur für Sie sichtbar. Ein Schlüssel kann seine eigene Nutzung mit GET /v1/usage abrufen; seine Gruppe steht dort nicht. Hat seine Gruppe ein Monatslimit, zeigt GET /v1/balance dem Schlüssel dieses Limit und was die ganze Gruppe in diesem Monat ausgegeben hat, aber nicht den Namen der Gruppe.
  • Was passiert, wenn ich eine Gruppe lösche? Sie wählen: Ihre Schlüssel funktionieren weiter und sind von da an ohne Gruppe, oder sie werden mit der Gruppe widerrufen. In beiden Fällen bleiben ihre Aufrufe unter dem Namen der Gruppe.
  • Was, wenn ein Schlüssel von einem Kunden zu einem anderen wechselt? Verschieben Sie ihn in die Gruppe des anderen Kunden: Seine Aufrufe zählen von da an dort, und seine früheren Aufrufe bleiben beim ersten Kunden.
  • Kann ich andere Zeiträume ablesen? Ja: Wählen Sie auf der Seite Nutzung „Benutzerdefiniert“ und bis zu 90 Tage. Für ein Programm liefert GET /v1/usage die Kosten eines Schlüssels pro Tag über denselben Zeitraum.

Um die Schlüssel eines Kunden mit Ihren eigenen Tools statt von Hand zu erstellen, zu gruppieren, zu begrenzen und zu widerrufen, verwenden Sie die Verwaltungs-API. Ihre Schlüssel sind eigene Zugangsdaten und funktionieren nur dort.