Просмотр баланса
Чтение баланса только с правами на финансовые данные компании.
GET /v1/balance возвращает текущий баланс расчётного аккаунта, если ключ разрешает его просмотр. Баланс компании не является набором отдельных дочерних балансов ключей. Доступ к использованию проекта сам по себе не разрешает просмотр баланса.
Запрос
curl https://api.b2b-llm.com/v1/balance -H "Authorization: Bearer $B2B_API_KEY"
Ответ
{"object":"balance","balance":"125.7500000000","currency":"USD"}
Сохраняйте точную десятичную строку в финансовом коде. Не преобразуйте её в двоичное число с плавающей точкой для сверки. Интерфейс может округлять значение для удобства чтения, но источником истины остаются сохранённые суммы транзакций.
Права владельца/администратора организации и финансовые права компании отличаются от проектных ролей разработчика/наблюдателя. Выбор общего проекта в Playground не передаёт сотруднику права создателя ключа на просмотр баланса. Для автоматизации владелец также может использовать эндпоинт баланса Partner API.