GET

/v1/usage

Справочник API

История списаний аккаунта, от новых к старым, с курсорной пагинацией. Нужен ключ; запрос бесплатный.

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

bash

curl -G https://api.zukko.pro/v1/usage \
  -H "Authorization: Bearer fetch_YOUR_KEY" \
  --data-urlencode "limit=50"

2Параметры

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

3Ответ

json

{
  "data": [
    {
      "created_at": "2026-10-01T12:00:00+00:00",
      "model": "Claude Sonnet 5",
      "input_tokens": 1500,
      "output_tokens": 320,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "total_tokens": 1820,
      "cost_cents": 0.0546
    }
  ],
  "next_cursor": "2026-10-01T11:59:00+00:00|48213"
}

Поле	Тип	Описание
`created_at`	string	время списания, ISO 8601 в UTC
`model`	string	отображаемое название модели (например, `Claude Sonnet 5`) или служебное имя вроде `web-search`
`input_tokens`	int	входные токены, включая кэш
`output_tokens`	int	выходные токены (для изображений — число картинок)
`cache_read_tokens`	int	из входа прочитано из кэша
`cache_write_tokens`	int	из входа записано в кэш
`total_tokens`	int	сумма входных и выходных
`cost_cents`	float	стоимость в центах с дробной частью: `0.0546` = $0.000546

4Пагинация

Курсор имеет вид <время>|<числовой id записи>. Передавайте next_cursor в параметр cursor как есть, но обязательно URL-кодируйте его: в нём есть + и |, и незакодированный + превратится в пробел — тогда вернётся первая страница. Удобнее всего curl -G --data-urlencode:

bash

curl -G https://api.zukko.pro/v1/usage \
  -H "Authorization: Bearer fetch_YOUR_KEY" \
  --data-urlencode "limit=50" \
  --data-urlencode "cursor=2026-10-01T11:59:00+00:00|48213"

next_cursor: null — записей больше нет.

5Что попадает в историю

Все списания аккаунта, а не только этого ключа: другие ключи, веб-чат, Telegram-бот, веб-поиск.
Ответы из кэша Zukko и повторы по Idempotency-Key бесплатны и в историю не попадают.

GET /v1/balance

Лимиты ключа, идемпотентность и кэш