# Параметры аналитики

Source: https://provod.ai/ru/docs/analytics-meta

**`GET /v1/analytics/meta`**

Получите список метрик, измерений, операторов фильтрации и ограничений запроса.

## Авторизация

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

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

## Метрики и измерения


| Поле                                           | Тип    | Описание                                                                                           |
| ---------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------- |
| `total_usage`                                  | number | Фактические расходы, включая связанные проверки guardrail; также возвращается total\_usage\_exact. |
| `request_count, error_count`                   | number | Завершённые запросы и ошибки. Ошибочные запросы тоже могут быть платными.                          |
| `total_prompt_tokens, total_completion_tokens` | number | Зафиксированные входные и выходные токены.                                                         |
| `total_reasoning_tokens, total_cached_tokens`  | number | Зафиксированные токены рассуждений и кеша.                                                         |
| `avg_latency`                                  | number | Средняя длительность запроса в секундах.                                                           |


Измерения: `model`, `external_user`, `generation_id`, `api_key_hash`, `api_key_id`, `user_id`, `user`, `workspace_id`, `workspace`.

`api_key_id` возвращает тот же хеш, что и `api_key_hash`. `user` и `workspace` являются псевдонимами `user_id` и `workspace_id`. `external_user` берётся из поля `user` запроса Chat Completions или Responses; это ID пользователя вашего приложения, а не участника рабочего пространства. Старые запросы могут содержать null.

## Параметры

Тело запроса и параметры не требуются.

## Ответ · 200


| Поле                                  | Тип       | Описание                                                                                                |
| ------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------- |
| `data.currency`                       | string    | Валюта расчётов.                                                                                        |
| `data.metrics`                        | object\[] | name, display\_label (строки), display\_format (currency или number), is\_rate (boolean, сейчас false). |
| `data.dimensions, data.granularities` | object\[] | Строки name и display\_label. Гранулярность: hour, day, week, month.                                    |
| `data.operators`                      | object\[] | name: eq, neq, in или not\_in; value\_type: scalar для eq/neq, array для in/not\_in.                    |
| `data.limits`                         | object    | max\_days: 93, max\_rows: 10000, max\_dimensions: 2, max\_filters: 20.                                  |


### Пример ответа

Все идентификаторы и суммы в примерах условные.


**JSON ответа**


```json
{
  "data": {
    "currency": "RUB",
    "metrics": [
      {
        "name": "total_usage",
        "display_label": "total_usage",
        "display_format": "currency",
        "is_rate": false
      },
      {
        "name": "request_count",
        "display_label": "request_count",
        "display_format": "number",
        "is_rate": false
      },
      {
        "name": "error_count",
        "display_label": "error_count",
        "display_format": "number",
        "is_rate": false
      },
      {
        "name": "total_prompt_tokens",
        "display_label": "total_prompt_tokens",
        "display_format": "number",
        "is_rate": false
      },
      {
        "name": "total_completion_tokens",
        "display_label": "total_completion_tokens",
        "display_format": "number",
        "is_rate": false
      },
      {
        "name": "total_reasoning_tokens",
        "display_label": "total_reasoning_tokens",
        "display_format": "number",
        "is_rate": false
      },
      {
        "name": "total_cached_tokens",
        "display_label": "total_cached_tokens",
        "display_format": "number",
        "is_rate": false
      },
      {
        "name": "avg_latency",
        "display_label": "avg_latency",
        "display_format": "number",
        "is_rate": false
      }
    ],
    "dimensions": [
      {
        "name": "model",
        "display_label": "model"
      },
      {
        "name": "api_key_id",
        "display_label": "api_key_id"
      },
      {
        "name": "external_user",
        "display_label": "external_user"
      },
      {
        "name": "user",
        "display_label": "user"
      },
      {
        "name": "workspace",
        "display_label": "workspace"
      },
      {
        "name": "api_key_hash",
        "display_label": "api_key_hash"
      },
      {
        "name": "user_id",
        "display_label": "user_id"
      },
      {
        "name": "generation_id",
        "display_label": "generation_id"
      },
      {
        "name": "workspace_id",
        "display_label": "workspace_id"
      }
    ],
    "granularities": [
      {
        "name": "hour",
        "display_label": "hour"
      },
      {
        "name": "day",
        "display_label": "day"
      },
      {
        "name": "week",
        "display_label": "week"
      },
      {
        "name": "month",
        "display_label": "month"
      }
    ],
    "operators": [
      {
        "name": "eq",
        "value_type": "scalar"
      },
      {
        "name": "neq",
        "value_type": "scalar"
      },
      {
        "name": "in",
        "value_type": "array"
      },
      {
        "name": "not_in",
        "value_type": "array"
      }
    ],
    "limits": {
      "max_days": 93,
      "max_rows": 10000,
      "max_dimensions": 2,
      "max_filters": 20
    }
  }
}
```



## Пример запроса

Загрузите ключ в переменную окружения на сервере. TypeScript использует встроенный fetch в Node.js, Python только стандартную библиотеку.




TypeScript



Python



cURL




```typescript
const response = await fetch("https://api.provod.ai/v1/analytics/meta", {
  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());
```



```python
import json
import os
from urllib.request import Request, urlopen

request = Request(
    "https://api.provod.ai/v1/analytics/meta",
    method="GET",
    headers={"Authorization": f"Bearer {os.environ['MANAGEMENT_API_KEY']}"},
)
with urlopen(request) as response:
    print(json.load(response))
```



```bash
curl --fail-with-body --silent --show-error -X GET \
  "https://api.provod.ai/v1/analytics/meta" \
  -H "Authorization: Bearer ${MANAGEMENT_API_KEY}"
```



## Ошибки


| HTTP  | Ошибка       | Причина                                                                                                             |
| ----- | ------------ | ------------------------------------------------------------------------------------------------------------------- |
| `401` | Unauthorized | Отсутствующий, недействительный, отключённый, отозванный или истёкший ключ. Заголовок `X-Org-Id` также отклоняется. |
| `403` | Forbidden    | Неверный тип ключа или недостаточно прав в рабочем пространстве.                                                    |


Пример ошибки авторизации:

```json
{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid API key",
    "metadata": {}
  }
}
```

## Далее

* [Управляющие ключи](/ru/docs/management-keys)
* [Стоимость запроса](/ru/docs/generation-metadata)
