Historique du solde et de l’utilisation

GET /v1/balance : votre solde prépayé restant. GET /api/key/usage : le solde ainsi que les dépenses et le nombre de requêtes du jour et du mois pour chaque clé. GET /v1/generations : historique d’utilisation paginé. Exemples en curl et en Python.

Libre-service : consultez votre solde, récupérez les tarifs par programmation et consultez l’historique d’utilisation de votre clé.

Solde

GEThttps://getvibeapi.com/v1/balance

Renvoie le solde prépayé restant.

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

Prix programmatiques : /v1/pricing

GEThttps://getvibeapi.com/v1/pricing

La source de prix canonique de votre compte : modèles et variantes, prix des médias par unité. Renvoie un objet avec data (modèles de texte) et media (images et vidéos). Les prix sont actualisés en temps réel et tiennent compte des remplacements distants.

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

Chaque enregistrement de variante contient un champ addressAs correspondant à la valeur exacte du champ model dans une requête (par ex. claude-opus-4.8:yellow). Le champ cacheReadRub existe uniquement pour les variantes avec cache activé et indique le prix de lecture du cache du prompt. Les enregistrements multimédias sont marqués estimated: true ; le coût exact du média dépend du volume réel de génération et est renvoyé dans le x-pv-cost-rub ; pour les flux, le champ du corps requiert x-pv-cost: 1.

Résumé de la clé

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

Renvoie le solde ainsi que les dépenses d'aujourd'hui et de ce mois-ci, et le nombre de requêtes du jour. S'authentifie avec la même clé sk-pv-… via l'en-tête Authorization: Bearer ou 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

Historique de l’utilisation

Si vous vous déconnectez pendant la diffusion d’une réponse, vous ne payez que les tokens que le fournisseur a effectivement confirmés comme traités. Si le flux se termine avant tout token de sortie et que le fournisseur confirme les tokens d’entrée, seuls ces tokens d’entrée sont facturés ; sans utilisation confirmée, le montant facturé est nul. Les réponses vides, les erreurs du fournisseur, les annulations dues à nos limites de coût et les tentatives échouées remplacées par une nouvelle tentative réussie ne vous sont pas facturées.

GEThttps://getvibeapi.com/v1/generations

Paramètre	Type	Description
`page`	number	Numéro de page. Valeur par défaut : 1.
`limit`	number	Taille de page, jusqu’à 100. Valeur par défaut : 20.
`dateFrom`	chaîne (ISO)	Filtre : à partir de cette date.
`dateTo`	chaîne (ISO)	Filtre : jusqu'à cette date.
`request_id`	string	Uniquement les enregistrements de cette requête. La valeur provient de l'en-tête d'identifiant de requête du projet (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"

Exemple de réponse :

{
  "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
}

Le champ request_id est le même identifiant que celui reçu dans l'en-tête x-getvibe-request-id de la réponse d'origine. Il est également présent dans les réponses en streaming, ce qui permet d'associer exactement un flux à son enregistrement. Pour un enregistrement multimédia, il s'agit du jobId de la réponse de soumission de la génération.

Le champ cost_rub correspond au montant que nous avons débité pour l’événement. Les champs route et address_as indiquent quelle route publique a réellement traité la requête (voir Routage → Détail du trajet). Seuls les champs d’utilisation propres au client sont renvoyés.

Un enregistrement précis : /v1/generations/{id}

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

Renvoie un seul enregistrement de l'historique d'utilisation par son id. La requête est limitée au propriétaire : vous obtenez uniquement vos propres événements. Le id provient de la réponse GET /v1/generations (le champ id) ou de l'en-tête x-pv-generation-id d'une réponse /v1/chat/completions sans flux.

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

Exemple de réponse :

{
  "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"
}

Paramètre	Type	Description
`id`req.	chaîne (chemin)	Identifiant de l’enregistrement.
`mediaType`	string	Type : TEXT, IMAGE, VIDEO, AUDIO, MUSIC, MODEL_3D.

Pour les requêtes en streaming (stream: true), l’identifiant de l’enregistrement est créé de manière asynchrone : l’en-tête x-pv-generation-id est absent. L’enregistrement apparaît dans l’historique dès que le streaming est terminé.

← PrécédentWebhooks multimédias Suivant →Routage et limites