Historial de saldo y uso

GET /v1/balance: tu saldo prepagado restante. GET /api/key/usage: saldo, además del gasto y el número de solicitudes de hoy y del mes por clave. GET /v1/generations: historial de uso paginado. Ejemplos en curl y Python.

Autoservicio: consulta tu saldo, obtén precios mediante programación y consulta el historial de uso de tu clave.

Saldo

GEThttps://getvibeapi.com/v1/balance

Devuelve el saldo prepagado restante.

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

Precios programáticos: /v1/pricing

GEThttps://getvibeapi.com/v1/pricing

La fuente de precios canónica de tu cuenta: modelos y variantes, precios de medios por unidad. Devuelve un objeto con data (modelos de texto) y media (imágenes y video). Los precios están actualizados y tienen en cuenta los cambios remotos.

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

Cada registro de variante tiene un campo addressAs, el valor exacto del campo model en una solicitud (por ejemplo, claude-opus-4.8:yellow). El campo cacheReadRub solo existe para las variantes con caché habilitada y muestra el precio de lectura de la caché del prompt. Los registros multimedia están marcados como estimated: true; el cargo exacto por contenido multimedia depende del volumen real de generación y se devuelve en el x-pv-cost-rub; para los streams, el campo del cuerpo requiere x-pv-cost: 1.

Resumen de la clave

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

Devuelve el saldo, además del gasto de hoy y de este mes y el número de solicitudes de hoy. Se autoriza con la misma clave sk-pv-… mediante el encabezado Authorization: Bearer o 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

Historial de uso

Si te desconectas mientras se transmite una respuesta, solo pagas por los tokens que el proveedor haya confirmado que procesó. Si la transmisión termina antes de generar tokens de salida y el proveedor confirma tokens de entrada, solo se cobra esa entrada; sin uso confirmado, el cargo es cero. Las respuestas vacías, los errores del proveedor, las cancelaciones por nuestros límites de costo y los intentos fallidos que se reemplazan por un reintento exitoso no se te cobran.

GEThttps://getvibeapi.com/v1/generations

Parámetro	Tipo	Descripción
`page`	number	Número de página. Predeterminado: 1.
`limit`	number	Tamaño de página, hasta 100. Predeterminado: 20.
`dateFrom`	cadena (ISO)	Filtro: desde esta fecha.
`dateTo`	cadena (ISO)	Filtro: hasta esta fecha.
`request_id`	string	Solo los registros de esta solicitud. El valor procede de la cabecera de id de solicitud del proyecto (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"

Respuesta de ejemplo:

{
  "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
}

El campo request_id es el mismo id que recibió en la cabecera x-getvibe-request-id de la respuesta original. También está presente en las respuestas en streaming, por lo que un flujo se puede asociar exactamente con su registro. En un registro de medios es el jobId de la respuesta de envío de la generación.

El campo cost_rub es el importe que debitamos por el evento. Los campos route y address_as muestran qué ruta pública atendió realmente la solicitud (consulta Enrutamiento → Desglose de vuelos). Solo se devuelven los campos de uso propios del cliente.

Un registro específico: /v1/generations/{id}

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

Devuelve un único registro del historial de uso mediante su id. La solicitud está limitada al propietario: solo obtienes tus propios eventos. El id proviene de la respuesta GET /v1/generations (el campo id) o del encabezado x-pv-generation-id de una respuesta /v1/chat/completions que no usa streaming.

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

Respuesta de ejemplo:

{
  "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"
}

Parámetro	Tipo	Descripción
`id`req.	cadena (ruta)	Identificador del registro.
`mediaType`	string	Tipo: TEXT, IMAGE, VIDEO, AUDIO, MUSIC, MODEL_3D.

Para solicitudes de streaming (stream: true), el id del registro se crea de forma asíncrona; el encabezado x-pv-generation-id está ausente. El registro aparece en el historial justo después de que termina el stream.

← AnteriorWebhooks multimedia Siguiente →Enrutamiento y límites