DocsAPI ReferenceGET /v1/usage
GET

/v1/usage

API Reference

GET /v1/usage

История списаний с курсорной пагинацией.

Требуется авторизация.

Параметры

Параметр
Тип
Описание
limit
int
Количество записей, от 1 до 100. По умолчанию 20
cursor
string
Курсор для загрузки следующей страницы

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

JSON
bash
{
  "data": [
    {
      "created_at": "2026-05-01T12:00:00+00:00",
      "model": "GPT 4.1",
      "input_tokens": 1500,
      "output_tokens": 320,
      "total_tokens": 1820,
      "cost_cents": 0.29
    }
  ],
  "next_cursor": "2026-05-01T11:59:00+00:00|abc123"
}

Пагинация

Если next_cursor равен null, записей больше нет. Для загрузки следующей страницы передайте значение next_cursor в параметр cursor.

Поля ответа

Поле
Тип
Описание
created_at
string
Временная метка ISO 8601
model
string
Отображаемое имя модели
input_tokens
int
Входные токены
output_tokens
int
Выходные токены
total_tokens
int
Всего токенов (input + output)
cost_cents
float
Стоимость в центах с точной дробной частью
GET /v1/usage · Zukko