GET /v1/balance

Acest punct final numai pentru citire validează cheia API, dar nu necesită un sold pozitiv.

Cerere

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

Răspuns

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

Pentru acreditările individuale, soldul aparține utilizatorului care deține cheia. Pentru acreditările de afaceri, taxele API folosesc întotdeauna portofelul proprietarului companiei. Soldul companiei partajat este returnat numai atunci când principalul acreditării are vizibilitate la nivel de companie (proprietar al organizației, administrator sau rol de facturare). Acreditările angajaților de dezvoltator/spectator pot executa solicitări API permise, dar primesc HTTP 403 de la /v1/balance; acei utilizatori văd numai utilizarea grupului permis și limitele în panoul de control. Cheie API usage şi spend_limit rămân valori separate.

Eroare de autentificare

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

Eroare de permisiunea companiei

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