История баланса и расхода

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

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

Баланс

GEThttps://getvibeapi.com/v1/balance

Возвращает ваш оставшийся предоплаченный баланс.

curl https://getvibeapi.com/v1/balance \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# → {"balance_rub": 1234.56, "currency": "RUB"}

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

GEThttps://getvibeapi.com/v1/pricing

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

curl https://getvibeapi.com/v1/pricing \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

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

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

GEThttps://getvibeapi.com/api/key/usage

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

curl https://getvibeapi.com/api/key/usage \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# the same key is also accepted in the x-api-key header

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

Если вы отключитесь во время потоковой передачи ответа, вы платите только за те токены, которые провайдер фактически подтвердил как обработанные. Если поток завершается до появления первого выходного токена, а провайдер подтверждает входные токены, оплачиваются только они; без подтверждённого использования плата равна нулю. Пустые ответы, ошибки провайдера, отмены по нашему лимиту стоимости и неудачные попытки, заменённые успешным повтором, с вас не списываются.

GEThttps://getvibeapi.com/v1/generations

Параметр	Тип	Описание
`page`	number	Номер страницы. По умолчанию 1.
`limit`	number	Размер страницы, до 100. По умолчанию 20.
`dateFrom`	string (ISO)	Фильтр: с этой даты.
`dateTo`	string (ISO)	Фильтр: до этой даты.
`request_id`	string	Только записи этого запроса. Значение — из проектного заголовка идентификатора запроса (x-getvibe-request-id).

curl "https://getvibeapi.com/v1/generations?page=1&limit=20" \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# optional filters: dateFrom, dateTo (ISO 8601), request_id
# request_id is the x-getvibe-request-id header value on getvibeapi.com
# curl "https://getvibeapi.com/v1/generations?request_id=$REQUEST_ID"

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

{
  "data": [
    {
      "id": "...",
      "request_id": "8d4b6b3a-4f7c-4a4e-9a61-2f0c1d3e5b7a",
      "model": "gpt-6.1-sol",
      "route": "yellow",
      "address_as": "gpt-6.1-sol:yellow",
      "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
}

Поле request_id — тот же идентификатор, который вы получили в заголовке x-getvibe-request-id на исходный ответ. Он есть и у потоковых ответов, поэтому поток можно точно сопоставить с записью. У медиа-записи это jobId из ответа на создание задачи.

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

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

GEThttps://getvibeapi.com/v1/generations/{id}

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

curl https://getvibeapi.com/v1/generations/USAGE_EVENT_ID \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# USAGE_EVENT_ID comes from the /v1/generations response (the id field)
# or from the x-pv-generation-id header of a non-streaming response
# find the record by request id: GET /v1/generations?request_id=$REQUEST_ID

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

{
  "id": "cmpl_abc123",
  "request_id": "8d4b6b3a-4f7c-4a4e-9a61-2f0c1d3e5b7a",
  "model": "gpt-6.1-sol",
  "route": "yellow",
  "address_as": "gpt-6.1-sol:yellow",
  "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`req.	string (path)	Идентификатор записи.
`mediaType`	string	Тип: TEXT, IMAGE, VIDEO, AUDIO, MUSIC, MODEL_3D.

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

← НазадМедиавебхуки Далее →Маршрутизация и лимиты