Получить использование по моделям

GET /api/open/v1/usage/models

Параметры запроса

Параметр	Где	Тип	Обязательный	По умолчанию	Описание
`start_timestamp`	query	integer	Нет	См. ниже	Время начала (включительно), unix-секунды
`end_timestamp`	query	integer	Нет	См. ниже	Время окончания (включительно), unix-секунды
`limit`	query	integer	Нет	`10`	Количество моделей, от 1 до 100; значения вне диапазона возвращают 400

Правила временного диапазона:

Оба параметра опущены: последние 30 дней.
Только start_timestamp: 30 дней вперёд, но не позже текущего времени.
Только end_timestamp: 30 дней назад.
Диапазон может составлять не более 366 дней.

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

curl "https://www.routeapi.ai/api/open/v1/usage/models?start_timestamp=1726400000&end_timestamp=1729000000&limit=10" \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

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

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "model_name": "gpt-4o",
        "prompt_tokens": 120000,
        "completion_tokens": 30000,
        "total_tokens": 150000,
        "amount": 3.20
      }
    ],
    "start_timestamp": 1726400000,
    "end_timestamp": 1729000000
  }
}

Поля ответа

Поле	Тип	Описание
`items[].model_name`	string	Имя модели
`items[].prompt_tokens`	integer	Всего входных токенов модели за диапазон
`items[].completion_tokens`	integer	Всего выходных токенов модели за диапазон
`items[].total_tokens`	integer	Сумма входных и выходных токенов
`items[].amount`	number	Потраченная моделью сумма в валюте сайта, два знака после запятой
`start_timestamp`	integer	Фактическое время начала
`end_timestamp`	integer	Фактическое время окончания

Ошибки

HTTP	code	Сценарий
400	`invalid_request`	`limit` не является целым числом от 1 до 100, временная метка отрицательна или диапазон некорректен
429	—	Превышен лимит запросов на пользователя (по умолчанию 30/минуту); тело может быть пустым

Прочие общие коды ошибок см. в Ошибки и лимиты.

Примечания

Результаты отсортированы по total_tokens по убыванию; при равенстве — по имени модели по возрастанию, порядок стабилен.
amount каждой строки округляется отдельно, поэтому сумма строк может отличаться от итога на величину до 0,01.
Учитываются только логи потребления (биллинга); неудачные запросы не включаются.
Количество токенов указано в исходных единицах, не в миллионах.
Суммы указаны в валюте отображения сайта, см. Получить баланс.
Этот эндпоинт делит лимит запросов на пользователя (по умолчанию 30/минуту) с Использование, Логи аккаунта, Экспорт логов и Использование по Key. См. Ограничения частоты.