provod.ai / docs
API

Активность по дням

Активность по моделям за последние 30 завершённых дней UTC.

Обновлено

GET /v1/activity

Получите активность по моделям за последние 30 завершённых дней UTC. Сегодняшний день не включается.

Авторизация

Authorization: Bearer <MANAGEMENT_API_KEY>: управляющий ключ выбранного рабочего пространства.

Рабочее пространство определяется ключом. Заголовок X-Org-Id не поддерживается.

Query-параметры

ПолеТипОписание
datestringYYYY-MM-DD; необязательный день внутри окна. Дата за пределами окна возвращает пустой список.
group_bystringworkspace; добавляет workspace_id в ответ.
workspace_id, api_key_hash, user_id, external_userstring1–128 символов. Необязательные фильтры, не расширяют доступ.

Ответ · 200

ПолеТипОписание
dataobject[]Строка для каждой даты UTC и модели.
data[].datestringYYYY-MM-DD.
data[].model, data[].model_permaslugstringПубличный ID модели; одинаковое значение в обоих полях.
data[].requestsnumberКоличество завершённых запросов.
data[].prompt_tokens, completion_tokens, reasoning_tokens, cached_tokensnumberЗафиксированные счётчики токенов строки.
data[].usagenumberФактические расходы в currency.
data[].usage_exactstringТа же сумма с 8 знаками после запятой.
data[].currencystringВалюта рабочего пространства.
data[].workspace_idstringТолько при group_by=workspace.
data[].provider_name, data[].endpoint_idstringСейчас unknown.
data[].byok_usage_inferencenumberВсегда 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ОшибкаПричина
401UnauthorizedОтсутствующий, недействительный, отключённый, отозванный или истёкший ключ. Заголовок X-Org-Id также отклоняется.
403ForbiddenНеверный тип ключа или недостаточно прав в рабочем пространстве.
400Bad RequestНеверные или неизвестные параметры.
429Too 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. Лимит применяется к рабочему пространству для каждого метода.

На этой странице