Ringkasan akun
Tiga endpoint baca-saja memberi tahu kondisi akunmu dari kode. Pakai untuk memeriksa sebelum pekerjaan yang panjang, membuat dasbor pengeluaran, atau memberi agen cara memantau anggarannya sendiri. Membaca tidak dikenai biaya.
Endpoint mana yang dipanggil
Section titled “Endpoint mana yang dipanggil”| Pertanyaan | Endpoint |
|---|---|
| Berapa saldo yang bisa saya pakai sekarang? | Saldo akun: GET /v1/account/balance |
| Berapa sisa kuota paket, dan kapan direset? | Kuota akun: GET /v1/account/quota |
| Berapa yang sudah saya pakai, dan untuk apa? | Pemakaian: GET /v1/usage, /v1/usage/daily, dan /v1/usage/log |
Key mana yang bisa membaca apa
Section titled “Key mana yang bisa membaca apa”| Key | Saldo | Kuota | Pemakaian |
|---|---|---|---|
| Key tanpa pembatasan | Seluruh akun | Seluruh akun | Seluruh akun |
| Key yang dibatasi | Ditolak | Ditolak | Hanya pemakaian key itu sendiri |
| API key dibagikan | Ditolak | Ditolak | Ditolak |
Key yang dibatasi adalah key dengan pembatasan model, batas biaya, atau batas token. Panggilan yang ditolak mengembalikan 403 dengan restricted_key_not_allowed untuk key yang dibatasi dan shared_key_not_allowed untuk API key dibagikan. Untuk membaca ketiganya, pakai key tanpa pembatasan dari akun itu sendiri. Lihat Autentikasi & API key.
Key per tool
Section titled “Key per tool”Untuk memberi tiap tool key sendiri, pakai Key per tool: POST, GET, dan DELETE pada /v1/account/keys. Hanya key dari kenari login yang bisa memanggilnya, dan key login yang dicabut ikut mencabut key per tool miliknya.
Dari klien MCP
Section titled “Dari klien MCP”Server MCP punya satu tool untuk tiap pertanyaan: kenari_balance, kenari_quota, dan kenari_usage. Aturannya sama. Untuk key yang dibatasi, kenari_usage dibatasi pada key itu, sedangkan dua tool lainnya ditolak.