Histórico de saldo e uso

GET /v1/balance — seu saldo pré-pago restante. GET /api/key/usage — saldo, além dos gastos e da quantidade de solicitações de hoje/no mês por chave. GET /v1/generations — histórico de uso paginado. Exemplos em curl e Python.

Autoatendimento: consulte seu saldo, obtenha preços programaticamente e veja o histórico de uso da sua chave.

Saldo

GEThttps://getvibeapi.com/v1/balance

Retorna seu saldo pré-pago restante.

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

Preços programáticos: /v1/pricing

GEThttps://getvibeapi.com/v1/pricing

A fonte canônica de preços da sua conta: modelos e variantes, preços de mídia por unidade. Retorna um objeto com data (modelos de texto) e media (imagens e vídeo). Os preços são atualizados em tempo real e levam em conta substituições remotas.

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

Cada registro de variante tem um campo addressAs: o valor exato para o campo model em uma solicitação (por exemplo, claude-opus-4.8:yellow). O campo cacheReadRub existe apenas para variantes com cache ativado e mostra o preço de leitura do cache do prompt. Os registros de mídia são marcados como estimated: true: a cobrança exata de mídia depende do volume real de geração e é retornada no x-pv-cost-rub; para streams, o campo do corpo exige x-pv-cost: 1.

Resumo da chave

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

Retorna o saldo, além dos gastos de hoje e deste mês e da contagem de solicitações de hoje. Autoriza com a mesma chave sk-pv-… por meio do cabeçalho Authorization: Bearer ou de 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

Histórico de uso

Se você se desconectar enquanto uma resposta está sendo transmitida, pagará apenas pelos tokens que o provedor confirmou como processados. Se a transmissão terminar antes de qualquer token de saída e o provedor confirmar os tokens de entrada, somente essa entrada será cobrada; sem uso confirmado, a cobrança será zero. Respostas vazias, erros do provedor, cancelamentos por nosso limite de custo e tentativas com falha substituídas por uma nova tentativa bem-sucedida não serão cobrados de você.

GEThttps://getvibeapi.com/v1/generations

Parâmetro	Tipo	Descrição
`page`	number	Número da página. O padrão é 1.
`limit`	number	Tamanho da página, até 100. O padrão é 20.
`dateFrom`	string (ISO)	Filtro: a partir desta data.
`dateTo`	string (ISO)	Filtro: até esta data.
`request_id`	string	Somente registros desta solicitação. O valor vem do cabeçalho de id da solicitação do projeto (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"

Exemplo de resposta:

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

O campo request_id é o mesmo id que você recebeu no cabeçalho x-getvibe-request-id da resposta original. Ele também está presente em respostas em streaming, então um stream pode ser associado exatamente ao seu registro. Em um registro de mídia, é o jobId da resposta de envio da geração.

O campo cost_rub é o valor que debitamos pelo evento. Os campos route e address_as mostram qual rota pública realmente atendeu à solicitação (consulte Roteamento → detalhamento do voo). Somente os campos de uso do próprio cliente são retornados.

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

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

Retorna um único registro do histórico de uso pelo seu id. A solicitação é vinculada ao proprietário: você recebe apenas os seus próprios eventos. O id vem da resposta GET /v1/generations (o campo id) ou do cabeçalho x-pv-generation-id de uma resposta /v1/chat/completions sem 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

Exemplo de resposta:

{
  "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	Descrição
`id`req.	string (path)	Identificador do registro.
`mediaType`	string	Tipo: TEXT, IMAGE, VIDEO, AUDIO, MUSIC, MODEL_3D.

Para solicitações de streaming (stream: true), o id do registro é criado de forma assíncrona — o cabeçalho x-pv-generation-id fica ausente. O registro aparece no histórico logo após o término do stream.

← AnteriorWebhooks de mídia Próximo →Roteamento e limites