テーマ
言語

残高と使用量の履歴

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
パラメータータイプ説明
pagenumberページ番号。デフォルトは 1 です。
limitnumberページサイズ、最大 100。デフォルトは 20 です。
dateFromstring (ISO)フィルター: この日付から。
dateTostring (ISO)フィルター: この日付まで。
request_idstringこのリクエストのレコードのみ。値はプロジェクトのリクエスト 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 フィールドは、実際にリクエストを処理したパブリックルートを示します（ルーティング → フライト内訳 を参照）。返されるのはクライアント自身の使用状況フィールドのみです。

特定のレコード: /v1/generations/{id}

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

id を指定して使用履歴のレコードを 1 件返します。このリクエストはオーナー単位でスコープされるため、自分自身のイベントしか取得できません。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"
}
パラメータータイプ説明
idreq.string (path)レコード識別子。
mediaTypestringタイプ: TEXT, IMAGE, VIDEO, AUDIO, MUSIC, MODEL_3D。
ストリーミング(stream: true)リクエストでは、レコードIDは非同期で作成されるため、x-pv-generation-idヘッダーは付与されません。レコードはストリーミング終了直後に履歴へ表示されます。
← 前へメディア Webhook次へ →ルーティングと制限
GetVibe API の残高と使用量 — /v1/balance、/api/key/usage | GetVibe API