GET /v1/balance

Denna skrivskyddade slutpunkt validerar API-nyckeln men kräver inget positivt saldo.

Begäran

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

Svar

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

För individuella inloggningsuppgifter tillhör saldot användaren som äger nyckeln. För företagsuppgifter använder API-avgifter alltid företagets ägares plånbok. Det delade företagssaldot returneras endast när behörighetshuvudmannen har saldosynlighet på företagsnivå (organisationsägare, administratör eller faktureringsroll). Anställdas utvecklare/tittare kan köra tillåtna API-förfrågningar men ta emot HTTP 403 från /v1/balance; dessa användare ser bara sin tillåtna gruppanvändning och gränser i kontrollpanelen. API-nyckel usage och spend_limit förbli separata värden.

Autentiseringsfel

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

Företagsbehörighetsfel

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