Dokumentasi

Dokumentasi

Grup kunci

Beri setiap klien Anda kunci API sendiri, kumpulkan dalam satu grup, lihat berapa yang dibelanjakan setiap klien dan setiap kunci dalam periode apa pun, dan batasi berapa yang bisa dibelanjakan setiap klien dalam sebulan. Satu akun, satu saldo.

Grup adalah folder kunci API di akun Anda, misalnya satu per klien: CID000001, CID000002. Kunci dalam grup memanggil API sama seperti kunci lain, dan grup tidak punya saldo, isi ulang, atau login sendiri; grup dapat memiliki batas pengeluaran bulanan atas semua kuncinya. Sebuah kunci berada di satu grup atau tidak di grup mana pun.

Siapkan grup dalam tiga langkah

  • Buat grup. Di halaman Kunci API, pilih “Grup baru” dan beri nama sesuai klien.
  • Masukkan kunci. Pilih “Kunci baru” pada judul grup untuk membuat kunci di dalamnya. Untuk memasukkan kunci yang sudah ada, buka menunya dan pilih “Pindahkan ke grup”.
  • Baca angkanya. Halaman Kunci API menampilkan biaya setiap kunci pada bulan kalender ini dan total setiap grup. Halaman Penggunaan menampilkan kunci yang sama di bawah grupnya untuk hari ini, 7 atau 30 hari terakhir, bulan ini, bulan lalu, atau hari yang Anda pilih, hingga 90 hari.

Baca satu bulan dan ekspor

Di halaman Penggunaan, pilih “Bulan lalu” (atau “Bulan ini”, atau “Kustom” untuk memilih hari) di bagian atas. Di “Menurut kunci API”, judul tiap grup menampilkan biaya dan jumlah panggilannya. Menu grup di bagian atas mempersempit seluruh halaman ke satu grup: angka, grafik, model, dan panggilannya. “Ekspor CSV” mengunduh apa yang ditampilkan halaman, dengan periode dan grup yang sama, per kunci atau per hari.

Per kunci, file berisi satu baris per kunci dan grup, dengan nama seperti kunavo-cost-by-key_2026-10-01_2026-10-31.csv. File ini mencantumkan setiap kunci yang membuat panggilan dalam periode tersebut, termasuk yang sudah dicabut, di bawah grup tempat setiap panggilan dibuat, serta setiap kunci aktif tanpa panggilan di grupnya saat ini, dengan nilai 0, sehingga daftar kunci setiap klien lengkap. Grup mengikuti urutan dasbor, kunci di setiap grup dari yang paling mahal ke yang paling murah, dan kunci tanpa grup di akhir. Per hari, file diawali kolom date dan berisi satu baris untuk setiap hari sebuah kunci membuat panggilan di suatu grup.

KolomIsi
groupGrup tempat panggilan dibuat; kosong untuk panggilan yang dibuat di luar grup mana pun. Grup yang kemudian dihapus memiliki (deleted) setelah namanya.
key_nameNama kunci.
key_prefixAwal kunci, seperti yang ditampilkan dasbor. Tidak pernah kunci lengkapnya.
key_statusactive atau revoked.
callsPanggilan yang dilakukan dengan kunci itu dalam rentang tersebut.
errorsDari panggilan itu, yang gagal. Panggilan yang gagal tidak dikenai biaya.
input_tokensToken input, termasuk baca dan tulis cache.
output_tokensToken output.
cached_input_tokensDari token input, yang dibaca dari cache prompt.
cache_write_tokensDari token input, yang ditulis ke cache prompt.
cost_usdBiaya yang ditagihkan untuk panggilan tersebut, dalam dolar AS, dengan delapan angka desimal.
Nama yang terlihat seperti rumus. Nama grup atau kunci yang diawali =, +, -, atau @ ditulis dengan tanda petik tunggal di depannya, sehingga spreadsheet menampilkannya sebagai teks, bukan menjalankannya sebagai rumus.

Batasi biaya setiap grup dalam sebulan

Buka menu grup di halaman Kunci API dan pilih “Atur batas bulanan”. Batas ini menghitung biaya semua kunci di grup itu secara gabungan dalam satu bulan kalender (UTC): panggilan yang dibuat setiap kunci selama berada di grup tersebut. Permintaan yang akan membuat grup melewati batas ditolak dengan 402 dan tidak dikenakan biaya. Kosongkan kolom untuk tanpa batas, atau isi 0 untuk menjeda semua kunci di grup tanpa mencabut satu pun.

Batas bulanan milik setiap kunci tetap berlaku, dan batas yang lebih dulu tercapai yang menolak permintaan. Judul grup menampilkan biaya bulan ini terhadap batasnya, dengan “Batas tercapai” begitu permintaan mulai ditolak, dan “Dijeda” saat batasnya 0.

Kunavo mengirim email ke alamat akun Anda saat sebuah grup, atau kunci dengan batasnya sendiri, telah memakai 80% dari batas bulanannya, dan sekali lagi saat permintaan mulai ditolak karena batas itu: paling banyak satu email dari setiap jenis per bulan untuk setiap batas.

Cara angka dihitung

  • Biaya adalah jumlah yang ditagihkan. Biaya tiap panggilan adalah jumlah yang dipotong dari saldo Anda saat panggilan selesai. Panggilan yang gagal tidak dikenai biaya.
  • Bulan dan hari menggunakan UTC. Bulan ini dimulai pada tanggal 1 pukul 00:00 UTC. Di Yangon (UTC+6:30), misalnya, Oktober berakhir pada 1 November pukul 06:30 waktu setempat. Halaman Penggunaan mencantumkan tanggal rentang yang ditampilkannya.
  • Panggilan dihitung di grup tempat kuncinya berada saat panggilan dibuat. Jika Anda memindahkan kunci ke grup lain, hanya panggilannya sejak saat itu yang dihitung di sana; panggilan sebelumnya tetap di tempatnya. Karena itu, total bulan sebuah grup di halaman Kunci API bisa berbeda dari jumlah kunci yang sekarang tercantum di bawahnya.
  • Kunci yang dicabut tetap di grupnya. Biaya yang dikeluarkannya sebelum dicabut tetap dihitung dalam total grup itu dan muncul di ekspor.
  • Grup yang dihapus tetap menyimpan panggilannya. Panggilan itu tetap berada di bawah namanya, ditandai sudah dihapus, di halaman Penggunaan dan di hasil ekspor, dan namanya dapat dipakai lagi untuk grup baru.
  • Tiga tempat, satu angka. Untuk satu bulan kalender, total sebuah grup di halaman Kunci API, totalnya di “Bulan ini” pada halaman Penggunaan, dan jumlah barisnya di CSV sama persis hingga sen.

Pertanyaan

  • Apakah tiap grup punya saldo sendiri? Tidak. Semua grup memakai satu saldo akun Anda. Untuk membatasi biaya satu klien, tetapkan batas bulanan pada grupnya, atau pada setiap kuncinya.
  • Bisakah klien saya login untuk melihat penggunaannya? Tidak. Grup hanya terlihat oleh Anda. Sebuah kunci dapat membaca penggunaannya sendiri dengan GET /v1/usage, yang tidak menampilkan grupnya. Jika grupnya memiliki batas bulanan, GET /v1/balance menunjukkan batas itu kepada kunci tersebut beserta biaya seluruh grup bulan ini, tetapi tidak menampilkan nama grup.
  • Apa yang terjadi jika saya menghapus grup? Anda yang memilih: kuncinya tetap berfungsi dan sejak itu tanpa grup, atau dicabut bersama grupnya. Dalam kedua kasus, panggilan yang sudah dibuat kunci-kunci itu tetap berada di bawah nama grup.
  • Bagaimana jika kunci berpindah dari satu klien ke klien lain? Pindahkan ke grup klien lain itu: panggilannya dihitung di sana sejak saat itu, dan panggilan sebelumnya tetap pada klien pertama.
  • Bisakah saya melihat rentang waktu lain? Bisa: pilih “Kustom” di halaman Penggunaan dan tentukan hingga 90 hari. Untuk program, GET /v1/usage mengembalikan biaya per hari satu kunci untuk rentang yang sama.

Untuk membuat, mengelompokkan, membatasi, dan mencabut kunci klien dari alat Anda sendiri, bukan secara manual, gunakan API manajemen. Kuncinya adalah kredensial terpisah dan hanya berfungsi di API itu.