Skip to main content
GET
Rufen Sie das verbleibende und verbrauchte Guthaben des aktuellen API-Keys (Tokens) ab. Dieser Endpunkt dient zur Überwachung der Nutzung eines einzelnen Tokens.

Autorisierung

string
erforderlich
Alle API-Endpunkte erfordern eine Authentifizierung per Bearer TokenSo erhalten Sie Ihren API-Key:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API-Key zu erhaltenFügen Sie ihn dem Request-Header hinzu:

Endpunkte

Beide Endpunkte haben dieselbe Funktionalität — Sie können einen davon nach Belieben verwenden.

Antwort

boolean
Gibt an, ob die Anfrage erfolgreich war
string
Fehlermeldung (wird nur im Fehlerfall zurückgegeben)
float
Verbleibendes Guthaben des Tokens (wird bei Erfolg zurückgegeben). Gibt -1 zurück, wenn unlimited_quota true ist
integer
Verbleibende Credits des Tokens (wird bei Erfolg zurückgegeben). Gibt -1 zurück, wenn unlimited_quota true ist
float
Verbrauchtes Guthaben des Tokens (wird bei Erfolg zurückgegeben)
integer
Verbrauchte Credits des Tokens (wird bei Erfolg zurückgegeben)
boolean
Gibt an, ob der Token über ein unbegrenztes Kontingent verfügt. true bedeutet unbegrenzt, false bedeutet begrenzt

Anwendungsfälle

  • Verbrauch eines einzelnen API-Keys überwachen
  • Aktuellen Token-Kontostand in Ihrer Anwendung anzeigen
  • Guthabenwarnungen einrichten, wenn der Kontostand unter einen Schwellenwert fällt
Hinweise zur GuthabeneinheitDie Einheit des Guthabenwerts hängt von der Systemkonfiguration ab:
  • USD – US-Dollar
  • Credits – Guthaben
Token mit unbegrenztem KontingentWenn für einen Token ein unbegrenztes Kontingent festgelegt ist:
  • Das Feld unlimited_quota gibt true zurück
  • Das Feld remain_balance gibt -1 zurück
  • Das Feld remain_credits gibt -1 zurück
  • Der Token unterliegt keinen Kontingentbeschränkungen und kann ohne Limits verwendet werden

Häufige Fehler

SicherheitshinweisIhr API-Key ist wie ein Passwort. Bewahren Sie ihn sicher auf und geben Sie ihn nicht an andere weiter. Verwenden Sie in Produktivumgebungen stets HTTPS.