Riwayat saldo dan penggunaan

GET /v1/balance — sisa saldo prabayar Anda. GET /api/key/usage — saldo ditambah pengeluaran hari ini/bulan ini dan jumlah permintaan per kunci. GET /v1/generations — riwayat penggunaan berhalaman. Contoh dalam curl dan Python.

Layanan mandiri: periksa saldo Anda, ambil harga secara programatik, dan lihat riwayat pemakaian untuk kunci Anda.

Saldo

GEThttps://getvibeapi.com/v1/balance

Mengembalikan sisa saldo prabayar Anda.

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

Harga programatik: /v1/pricing

GEThttps://getvibeapi.com/v1/pricing

Sumber harga kanonis untuk akun Anda: model dan varian, harga media per unit. Menghasilkan objek dengan data (model teks) dan media (gambar dan video). Harga bersifat langsung, dengan mempertimbangkan override jarak jauh.

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

Setiap record varian memiliki field addressAs — nilai persis untuk field model dalam permintaan (mis. claude-opus-4.8:yellow). Field cacheReadRub hanya ada untuk varian dengan cache dan menunjukkan harga baca prompt-cache. Record media ditandai estimated: true — biaya media sebenarnya bergantung pada volume generasi aktual dan dikembalikan di x-pv-cost-rub; untuk stream, field body memerlukan x-pv-cost: 1.

Ringkasan key

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

Mengembalikan saldo plus pengeluaran hari ini dan bulan ini serta jumlah permintaan hari ini. Mengotorisasi dengan sk-pv-… yang sama melalui header Authorization: Bearer atau 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

Riwayat penggunaan

Jika Anda terputus saat respons sedang streaming, Anda hanya membayar token yang benar-benar telah dikonfirmasi diproses oleh penyedia. Jika stream berakhir sebelum ada token output dan penyedia mengonfirmasi token input, hanya input itu yang ditagih; tanpa usage yang dikonfirmasi, biayanya nol. Respons kosong, error penyedia, pembatalan karena batas biaya kami, dan percobaan gagal yang digantikan oleh retry yang berhasil tidak ditagihkan kepada Anda.

GEThttps://getvibeapi.com/v1/generations

Parameter	Tipe	Deskripsi
`page`	number	Nomor halaman. Default 1.
`limit`	number	Ukuran halaman, hingga 100. Default 20.
`dateFrom`	string (ISO)	Filter: mulai tanggal ini.
`dateTo`	string (ISO)	Filter: hingga tanggal ini.
`request_id`	string	Hanya catatan untuk permintaan ini. Nilainya berasal dari header id permintaan proyek (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"

Contoh respons:

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

Bidang request_id adalah id yang sama dengan yang Anda terima di header x-getvibe-request-id pada respons asli. Nilai ini juga ada pada respons streaming, sehingga stream dapat dicocokkan dengan catatannya secara tepat. Pada catatan media, nilainya adalah jobId dari respons pengiriman pembuatan.

Kolom cost_rub adalah jumlah yang kami debitkan untuk peristiwa tersebut. Kolom route dan address_as menunjukkan rute publik mana yang sebenarnya melayani permintaan (lihat Routing → Flight breakdown). Hanya kolom penggunaan milik klien sendiri yang dikembalikan.

Catatan tertentu: /v1/generations/{id}

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

Mengembalikan satu catatan riwayat penggunaan berdasarkan id-nya. Permintaan dibatasi pada pemilik: Anda hanya mendapat event milik Anda sendiri. id berasal dari respons GET /v1/generations (field id) atau header x-pv-generation-id dari respons /v1/chat/completions non-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

Contoh respons:

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

Parameter	Tipe	Deskripsi
`id`req.	string (path)	Pengenal record.
`mediaType`	string	Tipe: TEXT, IMAGE, VIDEO, AUDIO, MUSIC, MODEL_3D.

Untuk permintaan streaming (stream: true) id rekaman dibuat secara asinkron — header x-pv-generation-id tidak ada. Rekaman muncul di riwayat tepat setelah streaming selesai.

← SebelumnyaWebhook media Berikutnya →Routing & batas