GET /v1/balance

Ez a csak olvasható végpont érvényesíti az API-kulcsot, de nem igényel pozitív egyenleget.

Kér

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

Válasz

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

Egyéni hitelesítési adatok esetén az egyenleg a kulcsot birtokló felhasználóhoz tartozik. Az üzleti hitelesítési adatok esetében az API-díjak mindig a vállalat tulajdonosának pénztárcáját használják. A megosztott vállalati egyenleg csak akkor kerül visszaadásra, ha a megbízó hitelesítő adatai vállalati szintű egyenleget láthatnak (szervezet tulajdonosa, adminisztrátori vagy számlázói szerepkör). Az alkalmazottak fejlesztői/nézői hitelesítő adatai végrehajthatják az engedélyezett API kéréseket, de HTTP 403-at kapnak /v1/balance; ezek a felhasználók csak a megengedett csoporthasználatukat és korlátaikat látják a vezérlőpulton. API-kulcs usage és spend_limit külön értékek maradnak.

Hitelesítési hiba

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

Üzleti engedély hiba

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