GET /v1/balance

Тази крайна точка само за четене валидира API ключа, но не изисква положителен баланс.

Заявка

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

Отговор

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

За индивидуални идентификационни данни балансът принадлежи на потребителя, който притежава ключа. За бизнес идентификационни данни таксите за API винаги използват портфейла на собственика на компанията. Споделеният баланс на компанията се връща само когато принципалът на идентификационните данни има видимост на баланса на ниво компания (собственик на организация, администратор или роля за фактуриране). Идентификационните данни на разработчици/изгледатели на служителите могат да изпълняват разрешени API заявки, но да получават HTTP 403 от /v1/balance; тези потребители виждат само позволеното групово използване и ограничения в контролния панел. API-ключ usage и spend_limit остават отделни ценности.

Грешка при удостоверяване

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

Грешка в бизнес разрешението

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