Zum Inhalt springen
Kostenlos registrieren
API-Referenz

Kontingent eines API Key abfragen

Fragen Sie das verbrauchte und verbleibende Kontingent eines BetterToken API Key mit Bearer-Authentifizierung ab. Rechnen Sie die Einheiten mit Währung und Umrechnungsfaktor in Geld um.

Mit GET https://bettertoken.ai/api/usage/token/ fragen Sie das verbrauchte und verbleibende Kontingent eines BetterToken API Key ab.

Anfrage senden

Verwenden Sie denselben BetterToken API Key mit dem Präfix sk-... wie für Modellaufrufe. Setzen Sie ihn vor dem Ausführen dieses Befehls als lokale Umgebungsvariable BETTERTOKEN_API_KEY.

Authentifizieren Sie sich mit Authorization: Bearer <API_KEY>. Die Anfrage hat weder Parameter noch einen Body. Behalten Sie den abschließenden Schrägstrich bei; die vollständige URL enthält kein /v1.

Terminal-Fenster
curl -sS 'https://bettertoken.ai/api/usage/token/' \
-H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"

Erfolgreiche Antwort

code: true bedeutet, dass die Abfrage erfolgreich war. Dieser Antwortauszug enthält nur Beispielwerte.

{
"code": true,
"message": "ok",
"data": {
"object": "token_usage",
"name": "example-key",
"total_granted": 1000000,
"total_used": 250000,
"total_available": 750000,
"unlimited_quota": false,
"quota_currency": "USD"
}
}

Kontingent ablesen

FeldBedeutung
data.total_availableVerbleibendes Kontingent dieses Key in internen Kontingenteinheiten.
data.total_usedKumuliertes verbrauchtes Kontingent dieses Key in denselben Einheiten.
data.total_grantedSumme aus verbrauchtem und verbleibendem Kontingent in denselben Einheiten.
data.quota_currencyWährung des Kontingents, zum Beispiel USD.
data.unlimited_quotaBei true hat dieser Key kein eigenes Kontingentlimit. Das Wallet-Guthaben begrenzt weiterhin die Ausgaben.

In Geld umrechnen

Lesen Sie data.quota_per_unit aus der Antwort auf GET https://bettertoken.ai/api/status. Teilen Sie das Kontingent durch diesen Faktor, um den Betrag in der Währung data.quota_currency zu erhalten.

Verbleibender Betrag = data.total_available / data.quota_per_unit

Bei einem Faktor von 500000 ergeben die Beispielwerte 750000 / 500000 = 1.50 USD. Rechnen Sie das verbrauchte Kontingent genauso um.

Das Wallet-Guthaben Ihres Kontos finden Sie im BetterToken Workspace. Dieser Endpunkt liefert nur das Kontingent des API Key, mit dem Sie die Anfrage authentifizieren.

Die letzten Anfragen dieses Key finden Sie unter Anfrageprotokolle eines API Key.