Nutzung & Guthaben

Zuletzt aktualisiert July 20, 2026

Lesen Sie Ihre API-Nutzung im laufenden Monat und Ihr aktuelles Guthaben ab.

TEXT

GET /v1/usage

Erfordert einen gültigen API-Schlüssel und eine aktive Mitgliedschaft. Anders als die Such-Endpunkte ist dieser nicht guthabengebunden — Sie können Ihr Guthaben jederzeit abrufen, auch wenn es leer ist — und er verbraucht kein Guthaben.

Suchparameter

Keine.

Antwort

JSON

{
  "period_start": "2026-06-01T00:00:00Z",
  "requests": 1284,
  "billable_units": 1310,
  "credits": {
    "balance_cents": 4250,
    "balance": 42.50,
    "currency": "usd",
    "included_cents": 0,
    "purchased_cents": 4250,
    "estimated_requests_remaining": 2125,
    "auto_reload_enabled": true
  }
}

Feld	Typ	Beschreibung
`period_start`	string (ISO 8601, UTC)	Beginn des laufenden Nutzungszeitraums (Kalendermonat).
`requests`	integer	Bisher in diesem Zeitraum erfasste API-Anfragen.
`billable_units`	integer	In diesem Zeitraum verbrauchte abrechenbare Einheiten (eine Anfrage kann mehr als eine Einheit abrechnen, wenn sie sich in mehrere vorgelagerte Abrufe auffächert).
`credits.balance_cents`	integer	Gesamtes verbleibendes Guthaben, in kleineren Währungseinheiten.
`credits.balance`	number	Gesamtes verbleibendes Guthaben, in größeren Einheiten.
`credits.currency`	string	ISO-Währungscode (z. B. `USD`, `GBP`).
`credits.included_cents`	integer	Verbleibendes Guthaben aus dem monatlichen Kontingent Ihrer Mitgliedschaft.
`credits.purchased_cents`	integer	Verbleibendes Guthaben aus von Ihnen gekauftem Guthaben.
`credits.estimated_requests_remaining`	integer	Ungefähre Anzahl weiterer Anfragen, die Ihr Guthaben abdeckt.
`credits.auto_reload_enabled`	boolean	Ob die automatische Aufladung für Ihr Konto eingeschaltet ist.

Beispiele

cURL

curl "https://api.suede.io/v1/usage" \
  -H "Authorization: Bearer $SUEDE_API_KEY"

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new("Bearer", Environment.GetEnvironmentVariable("SUEDE_API_KEY"));
var json = await http.GetStringAsync("https://api.suede.io/v1/usage");
Console.WriteLine(json);

JavaScript

const res = await fetch("https://api.suede.io/v1/usage", {
  headers: { Authorization: `Bearer ${process.env.SUEDE_API_KEY}` },
});
const usage = await res.json();
console.log(`Balance: ${usage.credits.balance} ${usage.credits.currency}`);

Dasselbe Guthaben wird bei jeder abrechenbaren Antwort über die Header X-Credits-Balance und X-Credits-Requests-Remaining zurückgegeben; siehe Fehler.