GET /v1/balance

Questo endpoint di sola lettura convalida la chiave API ma non richiede un saldo positivo.

Richiesta

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

Risposta

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

Per le credenziali individuali, il saldo appartiene all'utente che possiede la chiave. Per le credenziali aziendali, gli addebiti API utilizzano sempre il portafoglio del proprietario dell'azienda. Il saldo aziendale condiviso viene restituito solo quando l'entità credenziale ha visibilità del saldo a livello aziendale (proprietario dell'organizzazione, amministratore o ruolo di fatturazione). Le credenziali di sviluppatore/visualizzatore del dipendente possono eseguire richieste API consentite ma ricevere HTTP 403 da /v1/balance; tali utenti visualizzano solo l'utilizzo e i limiti del gruppo consentito nel pannello di controllo. Chiave API usage E spend_limit rimangono valori separati.

Errore di autenticazione

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

Errore di autorizzazione aziendale

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