GET /v1/balance

Este endpoint somente leitura valida a chave de API, mas não requer um saldo positivo.

Solicitar

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

Resposta

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

Para credenciais individuais, o saldo pertence ao usuário proprietário da chave. Para credenciais comerciais, as cobranças de API sempre usam a carteira do proprietário da empresa. O saldo compartilhado da empresa é retornado somente quando o principal da credencial tem visibilidade de saldo no nível da empresa (proprietário da organização, administrador ou função de cobrança). As credenciais de desenvolvedor/visualizador de funcionários podem executar solicitações de API permitidas, mas receber HTTP 403 de /v1/balance; esses usuários veem apenas o uso e os limites permitidos do grupo no painel de controle. Chave API usage e spend_limit permanecem valores separados.

Erro de autenticação

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

Erro de permissão comercial

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