aisplice

Référence API

Solde

GET/v1/balance

Renvoie le solde du compte et ce que la clé API appelante peut encore dépenser, en USD. Gratuit et en lecture seule : aucun appel de modèle, rien n'est facturé. Les clés épuisées ou expirées peuvent toujours l'appeler ; seules les clés désactivées sont refusées.

#Paramètres de la requête

  • Authorizationheaderobligatoire

    Bearer sk-YOUR_KEY. Pas de corps ni de paramètre de requête.

balance correspond à l'ensemble du portefeuille du compte et peut passer sous zéro après le règlement d'un gros traitement. available est ce que cette clé peut dépenser immédiatement : le plus petit montant entre balance et la limite restante propre à la clé, jamais sous zéro. key.remaining vaut null lorsque la clé n'a pas de limite propre ; expires_at à 0 signifie qu'elle n'expire jamais.

Les appelants B2B peuvent l'interroger avant d'envoyer du travail et alerter leur équipe quand available devient faible. Si la signature des requêtes est activée, signez cet appel comme tout autre appel effectué avec cette clé, avec le chemin /v1/balance.

#Erreurs associées

  • 401Clé manquante, invalide ou désactivée — ou, si la signature des requêtes est activée, signature manquante ou incorrecte.
  • 403Le compte est désactivé.
  • 500Le solde n'a pas pu être lu. Réessayez dans quelques secondes.

Table complète des codes d'erreur →

#Exemple de requête

curl https://www.aisplice.store/v1/balance \
  -H "Authorization: Bearer sk-YOUR_KEY"

#Réponse

response.json
{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "available": 2,
  "key": {
    "name": "app",
    "unlimited": false,
    "remaining": 2,
    "used": 1,
    "expires_at": 0
  }
}

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.

PrécédentPolitique d'envoi de fichiersSuivantListe des modèles