Endpunkte

Guthaben und Schlüsselinfo

Mit GET /credits und GET /key lesen Sie Ihr USD-Guthaben, die Gesamtausgaben und das Rate Limit des aufrufenden API-Schlüssels aus.

Lesen Sie das USD-Guthaben Ihres Kontos, die Gesamtausgaben und das Rate Limit des aufrufenden Schlüssels aus. Zwei Pfade liefern denselben Body: /credits und /key, ein kürzerer Alias.

GET https://api14.com/api/v1/credits
GET https://api14.com/api/v1/key

Alle Beträge sind in US-Dollar.

Anfrage

Keine Parameter. Authentifizieren Sie sich mit Ihrem API-Schlüssel:

curl https://api14.com/api/v1/credits \
  -H "Authorization: Bearer sk-api14-..."

Antwort

{
  "data": {
    "total_credits": 145.0,
    "total_usage": 102.82,
    "balance_usd": 42.18,
    "key_id": "ckey_01JABCDEF",
    "rate_limit": { "requests": 120, "interval": "1m" }
  }
}

Feld	Beschreibung
`total_credits`	Gesamte USD, die dem Konto jemals gutgeschrieben wurden: Aufladungen, in Abos enthaltene Nutzung, Boni und Promo-Codes.
`total_usage`	Gesamte USD, die für Anfragen ausgegeben wurden.
`balance_usd`	Aktuell verfügbares Guthaben in USD.
`key_id`	Die ID des API-Schlüssels, der für diese Anfrage verwendet wurde.
`rate_limit.requests`	Das eigene Limit des Schlüssels in Anfragen pro Minute, oder `null`, wenn der Schlüssel das Limit Ihres Plans verwendet.
`rate_limit.interval`	Immer `1m`.

total_credits - total_usage kann wegen Erstattungen und manueller Anpassungen leicht von balance_usd abweichen; maßgeblich ist balance_usd.

Beispiel: Anhalten, bevor das Guthaben aufgebraucht ist

import os, requests

r = requests.get(
    "https://api14.com/api/v1/credits",
    headers={"Authorization": f"Bearer {os.environ['API14_API_KEY']}"},
)
balance = r.json()["data"]["balance_usd"]
if balance < 1:
    raise SystemExit(f"Balance low: ${balance:.2f}. Add funds at /dashboard/billing")

curl -s https://api14.com/api/v1/key \
  -H "Authorization: Bearer $API14_API_KEY" | jq '.data.balance_usd'

Wenn das Guthaben 0 $ erreicht

Kostenpflichtige Anfragen liefern 402 insufficient_balance, bis Sie Guthaben aufladen, es sei denn, die automatische Aufladung ist unter Abrechnung aktiviert. Das Lesen von /credits, /key und /models funktioniert weiterhin. Siehe Preise & Abrechnung.

Fehler

Status	Code	Wann
401	`invalid_api_key`	Schlüssel fehlt oder ist ungültig.

Siehe Fehler.