GET /v1/balance

Aquest punt final de només lectura valida la clau de l'API, però no requereix un saldo positiu.

Sol·licitud

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

Resposta

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

Per a les credencials individuals, el saldo pertany a l'usuari propietari de la clau. Per a les credencials empresarials, els càrrecs de l'API sempre utilitzen la cartera del propietari de l'empresa. El saldo de l'empresa compartida només es retorna quan el principal de la credencial té visibilitat del saldo a nivell d'empresa (propietari de l'organització, administrador o funció de facturació). Les credencials de desenvolupador/espectador dels empleats poden executar sol·licituds d'API permeses però reben HTTP 403 de /v1/balance; aquests usuaris només veuen l'ús i els límits del grup permesos al tauler de control. Clau API usage i spend_limit romanen valors separats.

Error d'autenticació

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

Error de permís empresarial

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