余额和使用记录

GET /v1/balance，用于查询剩余的预付余额。GET /api/key/usage，用于查询余额以及每个密钥的今日/月度支出和请求数。GET /v1/generations，用于查询分页的使用历史。提供 curl 和 Python 示例。

自助服务：查看余额、以编程方式获取价格，以及查看 API key 的使用历史。

余额

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

返回余额、今天和本月的支出，以及今天的请求数。通过Authorization: Bearer标头或x-api-key使用同一个密钥sk-pv-…进行授权。

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

使用情况历史记录

如果你在响应流式传输期间断开连接，你只需为提供商实际确认已处理的 token 付费。如果流在输出任何 token 之前结束，且提供商确认了输入 token，则只收取该输入费用；如果没有已确认的用量，费用为零。空响应、提供商错误、因我们的费用上限而取消的请求，以及被成功重试替代的失败尝试，都不会向你收费。

GEThttps://getvibeapi.com/v1/generations

参数	类型	描述
`page`	number	页码。默认为 1。
`limit`	number	页面大小，最多 100。默认为 20。
`dateFrom`	字符串（ISO）	筛选：从此日期开始。
`dateTo`	字符串（ISO）	筛选：截至此日期。
`request_id`	string	仅限此请求的记录。该值来自项目的请求 ID 响应头（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 响应头中收到的 ID 相同。流式响应也会包含它，因此可以将流与其记录精确匹配。对于媒体记录，它是生成提交响应中的 jobId。

cost_rub 字段是我们为该事件扣除的金额。route 和 address_as 字段显示实际处理请求的公共路由（请参阅路由 → Flight breakdown）。仅返回客户端自身的 usage 字段。

单条具体记录：/v1/generations/{id}

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

根据其id返回单条使用历史记录。请求按所有者限定范围：你只能获取自己的事件。id来自GET /v1/generations响应（id字段）或非流式/v1/chat/completions响应的x-pv-generation-id标头。

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.	字符串（路径）	记录标识符。
`mediaType`	string	类型：TEXT、IMAGE、VIDEO、AUDIO、MUSIC、MODEL_3D。

对于流式（stream: true）请求，记录 ID 会异步创建，因此不会出现 x-pv-generation-id header。流结束后，记录会立即出现在历史记录中。

← 上一页媒体 Webhook 下一页 →路由与限制