GET /v1/balance

Dit alleen-lezen eindpunt valideert de API-sleutel, maar vereist geen positief saldo.

Verzoek

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

Antwoord

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

Voor individuele inloggegevens behoort het saldo toe aan de gebruiker die eigenaar is van de sleutel. Voor zakelijke inloggegevens wordt voor API-kosten altijd de portemonnee van de bedrijfseigenaar gebruikt. Het gedeelde bedrijfssaldo wordt alleen geretourneerd als de referentie-principal inzicht heeft in het saldo op bedrijfsniveau (organisatie-eigenaar, beheerder of factureringsrol). De inloggegevens van de ontwikkelaar/kijker van medewerkers kunnen toegestane API-verzoeken uitvoeren, maar ontvangen HTTP 403 van /v1/balance; die gebruikers zien alleen hun toegestane groepsgebruik en limieten in het configuratiescherm. API-sleutel usage En spend_limit blijven afzonderlijke waarden.

Authenticatiefout

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

Fout met zakelijke toestemming

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