Справочник API
Расходы (usage)
Агрегаты из usage_events, снимки и выгрузка отчётов через API платформы.
Кому подходит
- Финансам — фиксация периодов.
- Администраторам — сводка потребления в кабинете.
Требуется токен администратора (роли owner или admin).
Источник данных — usage_events после запросов к API моделей (gateway). Ручная синхронизация с внешним proxy не используется.
GET /api/organizations/{orgId}/usage
Актуальная сводка расходов за период (по умолчанию последние 30 дней).
Query (опционально): periodStart, periodEnd (YYYY-MM-DD).
curl -s "https://api.example.com/api/organizations/org_abc/usage?periodStart=2026-05-01&periodEnd=2026-06-01" \
-H "Authorization: Bearer <token>"Ответ 200 — UsageSummary:
{
"organizationId": "org_abc",
"totalTokens": 53000,
"totalSpendUsd": 266.5,
"byKey": {
"key_xyz": {"tokens": 53000, "spendUsd": 266.5}
}
}POST /api/organizations/{orgId}/usage/snapshots
Сохранить снимок сводки за период.
Тело (опционально): periodStart, periodEnd.
curl -s -X POST https://api.example.com/api/organizations/org_abc/usage/snapshots \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"periodStart":"2026-05-01","periodEnd":"2026-06-01"}'Ответ 201 — UsageSnapshot (поля как в сводке + id, capturedAt).
GET /api/organizations/{orgId}/usage/snapshots
Список всех снимков организации.
curl -s https://api.example.com/api/organizations/org_abc/usage/snapshots \
-H "Authorization: Bearer <token>"Ответ 200: массив UsageSnapshot.
GET /api/organizations/{orgId}/usage/export
Выгрузка снимков файлом.
Query: format=json|csv (по умолчанию json).
curl -s "https://api.example.com/api/organizations/org_abc/usage/export?format=csv" \
-H "Authorization: Bearer <token>" \
-o usage-snapshots.csv