Guthaben- und Nutzungsverlauf

GET /v1/balance – Ihr verbleibendes Prepaid-Guthaben. GET /api/key/usage – Guthaben sowie Ausgaben und Anfrageanzahl pro Schlüssel für heute und diesen Monat. GET /v1/generations – paginierter Nutzungsverlauf. Beispiele in curl und Python.

Selbstbedienung: Prüfen Sie Ihr Guthaben, rufen Sie Preise programmgesteuert ab und sehen Sie den Nutzungsverlauf für Ihren Schlüssel ein.

Guthaben

GEThttps://getvibeapi.com/v1/balance

Gibt Ihr verbleibendes Prepaid-Guthaben zurück.

curl https://getvibeapi.com/v1/balance \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# → {"balance_rub": 1234.56, "currency": "RUB"}

Programmgesteuerte Preise: /v1/pricing

GEThttps://getvibeapi.com/v1/pricing

Die kanonische Preisquelle für Ihr Konto: Modelle und Varianten sowie Medienpreise pro Einheit. Gibt ein Objekt mit data (Textmodelle) und media (Bilder und Videos) zurück. Die Preise sind aktuell und berücksichtigen remote Überschreibungen.

curl https://getvibeapi.com/v1/pricing \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

Jeder Varianteneintrag enthält ein Feld addressAs mit dem exakten Wert für das Feld model in einer Anfrage (z. B. claude-opus-4.8:yellow). Das Feld cacheReadRub gibt es nur für cachefähige Varianten und zeigt den Lesepreis des Prompt-Caches an. Medieneinträge sind mit estimated: true gekennzeichnet. Die genaue Mediengebühr hängt vom tatsächlichen Generierungsvolumen ab und wird im x-pv-cost-rub zurückgegeben; bei Streams erfordert das Body-Feld x-pv-cost: 1.

Zusammenfassung des Schlüssels

GEThttps://getvibeapi.com/api/key/usage

Gibt das Guthaben sowie die Ausgaben von heute und in diesem Monat und die Anzahl der heutigen Anfragen zurück. Autorisiert sich mit demselben Schlüssel sk-pv-… über den Header Authorization: Bearer oder x-api-key.

curl https://getvibeapi.com/api/key/usage \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# the same key is also accepted in the x-api-key header

Nutzungsverlauf

Wenn Sie die Verbindung trennen, während eine Antwort gestreamt wird, zahlen Sie nur für die Tokens, deren Verarbeitung der Anbieter tatsächlich bestätigt hat. Endet der Stream, bevor ein Output-Token ausgegeben wurde, und bestätigt der Anbieter Input-Tokens, wird nur dieser Input berechnet; ohne bestätigte Nutzung beträgt die Gebühr null. Leere Antworten, Anbieterfehler, von uns veranlasste Abbrüche aufgrund des Kostenlimits und fehlgeschlagene Versuche, die durch einen erfolgreichen Wiederholungsversuch ersetzt werden, werden Ihnen nicht berechnet.

GEThttps://getvibeapi.com/v1/generations

Parameter	Typ	Beschreibung
`page`	number	Seitennummer. Standardwert ist 1.
`limit`	number	Seitengröße, bis zu 100. Standardwert ist 20.
`dateFrom`	string (ISO)	Filter: ab diesem Datum.
`dateTo`	string (ISO)	Filter: bis zu diesem Datum.
`request_id`	string	Nur Datensätze für diese Anfrage. Der Wert stammt aus dem Projekt-Header für die Anfrage-ID (x-getvibe-request-id).

curl "https://getvibeapi.com/v1/generations?page=1&limit=20" \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# optional filters: dateFrom, dateTo (ISO 8601), request_id
# request_id is the x-getvibe-request-id header value on getvibeapi.com
# curl "https://getvibeapi.com/v1/generations?request_id=$REQUEST_ID"

Beispielantwort:

{
  "data": [
    {
      "id": "...",
      "request_id": "8d4b6b3a-4f7c-4a4e-9a61-2f0c1d3e5b7a",
      "model": "gpt-6.1-sol",
      "route": "yellow",
      "address_as": "gpt-6.1-sol:yellow",
      "type": "text",
      "prompt_tokens": 120,
      "completion_tokens": 340,
      "total_tokens": 460,
      "units": 0,
      "cost_rub": 0.42,
      "created_at": "2026-06-15T10:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

Das Feld request_id ist dieselbe ID, die Sie im Header x-getvibe-request-id der ursprünglichen Antwort erhalten haben. Sie ist auch bei gestreamten Antworten vorhanden, sodass ein Stream genau seinem Datensatz zugeordnet werden kann. Bei einem Medien-Datensatz ist es die jobId aus der Antwort auf die Generierungsanfrage.

Das Feld cost_rub enthält den Betrag, den wir für das Ereignis abgebucht haben. Die Felder route und address_as zeigen, welche öffentliche Route die Anfrage tatsächlich bedient hat (siehe Routing → Flight breakdown). Es werden nur die Nutzungsfelder des Clients zurückgegeben.

Ein bestimmter Datensatz: /v1/generations/{id}

GEThttps://getvibeapi.com/v1/generations/{id}

Gibt einen einzelnen Datensatz aus dem Nutzungsverlauf anhand seiner id zurück. Die Anfrage ist auf den Eigentümer beschränkt: Sie erhalten nur Ihre eigenen Ereignisse. Die id stammt aus der GET /v1/generations-Antwort (dem Feld id) oder dem Header x-pv-generation-id einer nicht gestreamten /v1/chat/completions-Antwort.

curl https://getvibeapi.com/v1/generations/USAGE_EVENT_ID \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# USAGE_EVENT_ID comes from the /v1/generations response (the id field)
# or from the x-pv-generation-id header of a non-streaming response
# find the record by request id: GET /v1/generations?request_id=$REQUEST_ID

Beispielantwort:

{
  "id": "cmpl_abc123",
  "request_id": "8d4b6b3a-4f7c-4a4e-9a61-2f0c1d3e5b7a",
  "model": "gpt-6.1-sol",
  "route": "yellow",
  "address_as": "gpt-6.1-sol:yellow",
  "type": "text",
  "prompt_tokens": 120,
  "completion_tokens": 340,
  "total_tokens": 460,
  "units": 0,
  "cost_rub": 0.42,
  "created_at": "2026-06-15T10:00:00.000Z"
}

Parameter	Typ	Beschreibung
`id`req.	string (path)	Datensatzkennung.
`mediaType`	string	Typ: TEXT, IMAGE, VIDEO, AUDIO, MUSIC, MODEL_3D.

Bei Streaming-Anfragen (stream: true) wird die Datensatz-ID asynchron erstellt – der Header x-pv-generation-id fehlt. Der Datensatz erscheint direkt nach Abschluss des Streams im Verlauf.

← ZurückMedia-Webhooks Weiter →Routing und Limits