Статистика использования

Методы usage показывают расход изображений по аккаунту и по API-ключам. Один файл в запросе считается одной единицей.

Авторизация

Usage endpoints доступны пользователю в личном кабинете и требуют cookie-сессию sid. Даты считаются в UTC в формате YYYY-MM-DD.

Сводка

GET /v1/usage/summary 
{
  "today_used": 18,
  "all_time_used": 420,
  "free_daily_limit": 500
}

Дневная статистика аккаунта

GET /v1/usage/daily?from=2026-05-01&to=2026-05-16 
{
  "items": [
    { "day": "2026-05-16", "used": 18 }
  ]
}
ПараметрТипОписание
fromdateНачало периода. Если не указан, берётся последний месяц.
todateКонец периода. Если не указан, берётся текущий день UTC.

Дневная статистика по ключам

GET /v1/usage/keys/daily?key_id=66f...&from=2026-05-01&to=2026-05-16 
{
  "items": [{
    "day": "2026-05-16",
    "key_id": "66f...",
    "key_prefix": "sk_live_xxxxxxxx",
    "key_name": "production",
    "key_status": "active",
    "used": 12
  }]
}
ПараметрТипОписание
key_idObjectIdФильтр по одному ключу.
key_idsCSV/ObjectId[]Фильтр по нескольким ключам, значения можно передать через запятую.
from, todateПериод статистики в UTC.