Баланс и история использования

GET /v1/balance — остаток предоплаченного баланса в рублях. GET /api/key/usage — баланс плюс траты за сегодня и месяц и число запросов по ключу. GET /v1/generations — история использования с пагинацией и фильтрами по датам. Примеры на curl и Python.

Самообслуживание: проверка остатка баланса, программа для получения цен и история использования вашим ключом.

Баланс

GEThttps://plusvibeapi.ru/v1/balance

Возвращает остаток предоплаченного баланса в рублях.

curl https://plusvibeapi.ru/v1/balance \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY"
# → {"balance_rub": 1234.56, "currency": "RUB"}

Программные цены: /v1/pricing

GEThttps://plusvibeapi.ru/v1/pricing

Канонический источник цен для вашего аккаунта: модели и варианты, медиа-цены за единицу. Возвращает объект с data (текстовые модели) и media (изображения и видео). Цены — живые, с учётом удалённых переопределений.

curl https://plusvibeapi.ru/v1/pricing \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY"

Каждая вариантная запись содержит поле addressAs — точное значение для поля model в запросе (например claude-opus-4.8:sub). Поле cacheReadRub присутствует только для кэширующих вариантов и показывает цену чтения кэша промпта. Медиа-записи помечены estimated: true — точная сумма списания для медиа зависит от фактического объёма генерации и возвращается в заголовке x-pv-cost-rub.

Сводка по ключу

GEThttps://plusvibeapi.ru/api/key/usage

Возвращает баланс плюс траты за сегодня и за текущий месяц и число запросов за сегодня. Авторизация тем же ключом sk-pv-… — заголовком Authorization: Bearer или x-api-key.

curl https://plusvibeapi.ru/api/key/usage \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY"
# тот же ключ принимается и в заголовке x-api-key

История использования

GEThttps://plusvibeapi.ru/v1/generations

Параметр	Тип	Описание
`page`	number	Номер страницы. По умолчанию 1.
`limit`	number	Размер страницы, до 100. По умолчанию 20.
`dateFrom`	string (ISO)	Фильтр: с какой даты.
`dateTo`	string (ISO)	Фильтр: по какую дату.

curl "https://plusvibeapi.ru/v1/generations?page=1&limit=20" \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY"
# опциональные фильтры: dateFrom, dateTo (ISO 8601)

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

{
  "data": [
    {
      "id": "...",
      "model": "gpt-5.6-luna",
      "route": "sub5plus",
      "address_as": "gpt-5.6-luna:sub5plus",
      "type": "text",
      "prompt_tokens": 120,
      "completion_tokens": 340,
      "total_tokens": 460,
      "units": 0,
      "cost_rub": 0.42,
      "created_at": "2026-06-15T10:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

Поле cost_rub — сумма, которую мы списали с вас за событие. Поля route и address_as показывают, какой публичный маршрут реально обслужил запрос (см. Маршрутизация → Flight breakdown). Возвращаются только клиентские поля использования.

Конкретная запись: /v1/generations/{id}

GEThttps://plusvibeapi.ru/v1/generations/{id}

Возвращает одну запись истории использования по её id. Запрос ограничен владельцем: вы получаете только свои собственные события. Идентификатор id берётся из ответа GET /v1/generations (поле id) или из заголовка x-pv-generation-id не-потокового ответа /v1/chat/completions.

curl https://plusvibeapi.ru/v1/generations/USAGE_EVENT_ID \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY"
# USAGE_EVENT_ID берётся из ответа /v1/generations (поле id)
# или из заголовка x-pv-generation-id не-строкового ответа

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

{
  "id": "cmpl_abc123",
  "model": "gpt-5.6-luna",
  "route": "sub5plus",
  "address_as": "gpt-5.6-luna:sub5plus",
  "type": "text",
  "prompt_tokens": 120,
  "completion_tokens": 340,
  "total_tokens": 460,
  "units": 0,
  "cost_rub": 0.42,
  "created_at": "2026-06-15T10:00:00.000Z"
}

Параметр	Тип	Описание
`id`обяз.	string (path)	Идентификатор записи.
`mediaType`	string	Тип: TEXT, IMAGE, VIDEO, AUDIO, MUSIC, MODEL_3D.

Для потоковых (stream: true) запросов идентификатор записи создаётся асинхронно — заголовок x-pv-generation-id отсутствует. Запись появляется в истории сразу после завершения стрима.

← ПредыдущийWebhook медиа-задач Следующий →Маршрутизация и лимиты