Consulter le quota d'une API Key
Consultez le quota utilisé et restant d'une BetterToken API Key avec l'authentification Bearer. Convertissez les unités en montant selon la devise et le facteur de conversion.
Utilisez GET https://bettertoken.ai/api/usage/token/ pour consulter le quota utilisé et restant d’une BetterToken API Key.
Envoyer une requête
Utilisez la même BetterToken API Key commençant par sk-... que pour appeler les modèles. Définissez-la dans la variable d’environnement locale BETTERTOKEN_API_KEY avant d’exécuter cette commande.
Authentifiez-vous avec Authorization: Bearer <API_KEY>. La requête ne contient ni paramètres ni corps. Conservez la barre oblique finale ; l’URL complète ne contient pas /v1.
curl -sS 'https://bettertoken.ai/api/usage/token/' \ -H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"Réponse réussie
code: true indique que la consultation a réussi. Cet extrait de réponse utilise des valeurs fictives.
{ "code": true, "message": "ok", "data": { "object": "token_usage", "name": "example-key", "total_granted": 1000000, "total_used": 250000, "total_available": 750000, "unlimited_quota": false, "quota_currency": "USD" }}Lire le quota
| Champ | Signification |
|---|---|
data.total_available | Quota restant de cette Key, en unités internes de quota. |
data.total_used | Quota utilisé cumulé de cette Key, dans les mêmes unités. |
data.total_granted | Somme du quota utilisé et restant, dans les mêmes unités. |
data.quota_currency | Devise du quota, par exemple USD. |
data.unlimited_quota | Si la valeur est true, cette Key n’a pas de limite de quota distincte. Le solde du portefeuille limite toujours les dépenses. |
Convertir en montant
Lisez data.quota_per_unit dans la réponse à GET https://bettertoken.ai/api/status. Divisez le quota par ce facteur pour obtenir un montant dans la devise data.quota_currency.
Montant restant = data.total_available / data.quota_per_unit
Par exemple, avec un facteur de 500000, les valeurs ci-dessus donnent 750000 / 500000 = 1.50 USD. Convertissez le quota utilisé de la même manière.
Pour consulter le solde du portefeuille de votre compte, ouvrez BetterToken Workspace. Cet endpoint renvoie uniquement le quota de l’API Key qui authentifie la requête.
Pour consulter les requêtes récentes de cette Key, voir Journaux d’une API Key.

