GET /v1/balance

Эта конечная точка, доступная только для чтения, проверяет ключ API, но не требует положительного баланса.

Запрос

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

Ответ

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

Для индивидуальных учетных данных баланс принадлежит пользователю, которому принадлежит ключ. Для учетных данных Business при оплате 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."
  }
}