Активность по дням
Активность по моделям за последние 30 завершённых дней UTC.
Обновлено
GET /v1/activity
Получите активность по моделям за последние 30 завершённых дней UTC. Сегодняшний день не включается.
Авторизация
Authorization: Bearer <MANAGEMENT_API_KEY>: управляющий ключ выбранного рабочего пространства.
Рабочее пространство определяется ключом. Заголовок X-Org-Id не поддерживается.
Query-параметры
| Поле | Тип | Описание |
|---|---|---|
date | string | YYYY-MM-DD; необязательный день внутри окна. Дата за пределами окна возвращает пустой список. |
group_by | string | workspace; добавляет workspace_id в ответ. |
workspace_id, api_key_hash, user_id, external_user | string | 1–128 символов. Необязательные фильтры, не расширяют доступ. |
Ответ · 200
| Поле | Тип | Описание |
|---|---|---|
data | object[] | Строка для каждой даты UTC и модели. |
data[].date | string | YYYY-MM-DD. |
data[].model, data[].model_permaslug | string | Публичный ID модели; одинаковое значение в обоих полях. |
data[].requests | number | Количество завершённых запросов. |
data[].prompt_tokens, completion_tokens, reasoning_tokens, cached_tokens | number | Зафиксированные счётчики токенов строки. |
data[].usage | number | Фактические расходы в currency. |
data[].usage_exact | string | Та же сумма с 8 знаками после запятой. |
data[].currency | string | Валюта рабочего пространства. |
data[].workspace_id | string | Только при group_by=workspace. |
data[].provider_name, data[].endpoint_id | string | Сейчас unknown. |
data[].byok_usage_inference | number | Всегда 0. |
Расходы группируются по времени проводки, статистика запросов по времени завершения. Платные ошибки и разрывы соединения входят в расходы. Возвраты не уменьшают исходное списание. Для сверки используйте точные строки и десятичную арифметику.
Пример ответа
Все идентификаторы и суммы в примерах условные.
Пример запроса
Загрузите ключ в переменную окружения на сервере. TypeScript использует встроенный fetch в Node.js, Python только стандартную библиотеку.
const response = await fetch("https://api.provod.ai/v1/activity?group_by=workspace", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.MANAGEMENT_API_KEY}`,
},
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());Ошибки
| HTTP | Ошибка | Причина |
|---|---|---|
401 | Unauthorized | Отсутствующий, недействительный, отключённый, отозванный или истёкший ключ. Заголовок X-Org-Id также отклоняется. |
403 | Forbidden | Неверный тип ключа или недостаточно прав в рабочем пространстве. |
400 | Bad Request | Неверные или неизвестные параметры. |
429 | Too Many Requests | Превышен лимит запросов аналитики: 2 в секунду, 30 в минуту; также действуют общие ограничения сервиса. |
| 503 | Service Unavailable | Сервис ограничения частоты запросов временно недоступен. Повторите позже. |
Пример ошибки авторизации:
{
"error": {
"code": "invalid_api_key",
"message": "Invalid API key",
"metadata": {}
}
}Пример ошибки метода:
{
"statusCode": 429,
"message": "ThrottlerException: Too Many Requests"
}Далее
При 429 учитывайте заголовок Retry-After. Лимит применяется к рабочему пространству для каждого метода.