GET /v1/balance

Tento koncový bod pouze pro čtení ověřuje klíč API, ale nevyžaduje kladný zůstatek.

Žádost

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

Odpověď

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

U individuálních přihlašovacích údajů patří zůstatek uživateli, který vlastní klíč. Pro obchodní přihlašovací údaje se poplatky za rozhraní API vždy používají v peněžence vlastníka společnosti. Sdílený zůstatek společnosti je vrácen pouze v případě, že hlavní pověření má viditelnost zůstatku na úrovni společnosti (vlastník organizace, správce nebo role fakturace). Pověření vývojáře/prohlížeče zaměstnance může spouštět povolené požadavky API, ale přijímat HTTP 403 od /v1/balance; tito uživatelé vidí na ovládacím panelu pouze jejich povolené použití skupiny a limity. API klíč usage a spend_limit zůstávají oddělené hodnoty.

Chyba ověření

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

Chyba obchodního oprávnění

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