Guthaben abfragen

Name: SRTGen
Rating: 4.9 (10000 reviews)

Fragen Sie Ihr aktuell verfügbares Credit-Guthaben ab, um die Nutzung zu verwalten und Job-Fehler zu vermeiden.

GET/api/v1/balance

Schnelle Implementierung

curl -X GET https://api.srtgen.com/api/v1/balance \
  -H "x-api-key: <YOUR_API_KEY>"

GEThttps://api.srtgen.com/api/v1/balance

Dieser Endpunkt gibt das gesamte nutzbare Guthaben zurück, einschließlich Ihres monatlichen Abonnements und aller zusätzlich gekauften Credits.

Antwortstruktur

Parameter	Typ	Erforderlich
Identität & Kontext
`user`	Objekt	Basisinformationen über den authentifizierten Nutzer.
`user.name`	Typ	Anzeigename des Nutzers.
`user.email`	Typ	Registrierte E-Mail-Adresse.
Detailliertes Guthaben
`credits`	Objekt	Aufschlüsselung des Credit-Guthabens.
`credits.totalBalance`	Number	Summe aller nutzbaren Credits (Abo + Extra).
`credits.extraCredits`	Number	Dauerhafte Top-up-Credits.
`credits.plans`	Array	Liste der aktiven Abonnements.
`plans[].name`	Typ	Name des Plans (z. B. 'Pro Plan').
`plans[].status`	Typ	Status des Abos (active, past_due).
`plans[].balance`	Number	Verbleibende Credits in diesem Zyklus.
Cloud-Speichernutzung
`storage`	Objekt	Statistiken zur Speichernutzung.
`storage.usage`	Number	Aktuelle Speichernutzung in Bytes.
`storage.limit`	Number	Maximales Speicherlimit in Bytes laut Plan.
`storage.formattedUsage`	Typ	Lesbare Nutzung (z. B. '200 MB').
`storage.formattedLimit`	Typ	Lesbares Limit (z. B. '10 GB').

Beispielantwort: 200 OK

{
  "success": true,
  "user": {
    "name": "Alex Rivera",
    "email": "[email protected]"
  },
  "credits": {
    "totalBalance": 1250,
    "totalMonthlyCredits": 1000,
    "extraCredits": 250,
    "plans": [
      {
        "id": "starter",
        "name": "Starter Plan",
        "status": "active",
        "balance": 1000,
        "total": 1000,
        "resetTime": "2026-04-29T17:48:46.000Z"
      }
    ]
  },
  "storage": {
    "usage": 209715200,
    "limit": 10737418240,
    "formattedUsage": "200 MB",
    "formattedLimit": "10 GB"
  },
  "updatedAt": "2026-03-29T17:48:46.000Z"
}

Fehler

Status	Fehlercode	Beschreibung
401	unauthorized	API-Key fehlt oder ist ungültig.
500	server_error	Ein unerwarteter interner Fehler ist aufgetreten.

War diese Seite hilfreich?