GET /v1/balance

Ce point de terminaison en lecture seule valide la clé API mais ne nécessite pas de solde positif.

Demande

curl https://api.model-gate.com/v1/balance \
  -H "Authorization: Bearer mg_live_..."

Réponse

{
  "object": "balance",
  "currency": "USD",
  "balance": "12.3400000000"
}

Pour les informations d’identification individuelles, le solde appartient à l’utilisateur propriétaire de la clé. Pour les informations d'identification professionnelles, les frais d'API utilisent toujours le portefeuille du propriétaire de l'entreprise. Le solde partagé de l'entreprise est renvoyé uniquement lorsque le principal des informations d'identification dispose d'une visibilité sur le solde au niveau de l'entreprise (propriétaire de l'organisation, administrateur ou rôle de facturation). Les informations d'identification des employés développeurs/spectateurs peuvent exécuter des requêtes API autorisées, mais recevoir le HTTP 403 de /v1/balance; ces utilisateurs voient uniquement leur utilisation de groupe autorisée et leurs limites dans le panneau de configuration. Clé API usage et spend_limit restent des valeurs distinctes.

Erreur d'authentification

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "invalid API key"
  }
}

Erreur d'autorisation commerciale

{
  "error": {
    "type": "permission_error",
    "code": "balance_not_permitted",
    "message": "Company balance is not available for this credential principal."
  }
}