Использование и оплата
Gateway предоставляет операционную статистику запросов. Makura Account остаётся источником истины для баланса, транзакций и оформления платежа.
Эндпоинты статистики Gateway требуют управляющий ключ, привязанный к владельцу.
Эндпоинты
| Эндпоинт | Результат |
|---|---|
GET /v1/account/usage/summary | Запросы, ошибки, токены, расходы и задержка |
GET /v1/account/usage/metrics | Временные ряды и разбивка по моделям и ключам |
GET /v1/account/usage/logs | История запросов с курсорной пагинацией |
Сводка использования
curl https://api.makura.ai/v1/account/usage/summary -H "Authorization: Bearer YOUR_PROVISIONING_KEY"Метрики
curl "https://api.makura.ai/v1/account/usage/metrics?date_from=2026-07-01T00%3A00%3A00Z&date_to=2026-07-08T00%3A00%3A00Z" -H "Authorization: Bearer YOUR_PROVISIONING_KEY"Используйте date_from и date_to в ISO 8601. Максимальный интервал определяется текущим контрактом Gateway.
Ответ включает:
- число запросов и ошибок;
- расход в кредитах;
- токены и задержки;
- разбивку по дням, моделям и API-ключам.
Граница кошелька
Авторитетный баланс и журнал операций находятся в Makura Account. Gateway резервирует и списывает средства во время выполнения запросов к моделям, но не предоставляет управление кошельком через пользовательские управляющие ключи.
Текущий баланс, операции и пополнение доступны в разделе Кредиты. Суммы кошелька показываются в его валюте, включая рубли; лимиты API-ключей показываются отдельно в кредитах.
Практические сценарии
- определить самые дорогие модели за период;
- сравнить рабочее и тестовое окружения при раздельных ключах;
- атрибутировать расходы командам и сервисам;
- анализировать задержку, время до первого токена (TTFT) и пропускную способность только при наличии измерений.