GET /v1/balance

Este punto final de solo lectura valida la clave API pero no requiere un saldo positivo.

Pedido

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

Respuesta

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

Para las credenciales individuales, el saldo pertenece al usuario propietario de la clave. Para las credenciales comerciales, los cargos de API siempre utilizan la billetera del propietario de la empresa. El saldo compartido de la empresa se devuelve solo cuando la entidad principal de la credencial tiene visibilidad del saldo a nivel de la empresa (propietario de la organización, administrador o función de facturación). Las credenciales de desarrollador/espectador de los empleados pueden ejecutar solicitudes de API permitidas pero recibir HTTP 403 de /v1/balance; esos usuarios solo ven el uso y los límites de su grupo permitido en el panel de control. clave API usage y spend_limit siguen siendo valores separados.

Error de autenticación

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

Error de permiso comercial

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