TokenLab Management API Menambahkan Pencarian Saldo Organisasi

Management API TokenLab kini mendukung pencarian saldo secara langsung, memungkinkan tim untuk menanyakan total saldo organisasi mereka saat ini melalui management token alih-alih memeriksa dasbor secara manual. Hal ini menutup celah umum bagi tim yang menjalankan pemeriksaan anggaran otomatis, peringatan isi ulang, atau alur kerja yang dibatasi oleh penggunaan.

Poin Penting

• Management API kini menyediakan endpoint saldo yang mengembalikan total saldo organisasi Anda saat ini.
• Endpoint ini terpisah dari API key inferensi model yang digunakan untuk memanggil Claude Sonnet 5, GPT-5.5, Gemini 3.5 Flash, dan model lainnya.
• Pencarian saldo ditujukan untuk pemeriksaan anggaran, peringatan isi ulang, menjeda atau melanjutkan alur kerja otomatis, dan memberi data pada dasbor keuangan.
• Endpoint ini sangat cocok dipadukan dengan endpoint penggunaan API key yang sudah ada untuk membangun gambaran pengeluaran yang lengkap.

Mengapa Fitur Ini Sebelumnya Tidak Ada

Sebelum pembaruan ini, memeriksa saldo organisasi Anda berarti harus masuk ke dasbor TokenLab dan membacanya dari halaman penagihan. Hal itu mungkin cukup bagi seseorang yang memeriksanya sekali sehari, tetapi menjadi kendala saat Anda ingin mengotomatiskan sesuatu.

Tim yang menjalankan beban kerja produksi di berbagai model seperti DeepSeek V4 Pro, Qwen3.7 Plus, atau Kimi K2.7 Code sering kali menginginkan skrip yang memeriksa saldo sebelum memulai pekerjaan besar, atau monitor yang mengirimkan peringatan saat saldo turun di bawah ambang batas. Tanpa endpoint saldo yang dapat dikueri, satu-satunya pilihan adalah pemeriksaan manual atau melakukan scraping pada dasbor, yang mana keduanya bukanlah hal yang ingin Anda jalankan dalam produksi.

Pencarian saldo melalui Management API memperbaiki hal ini. Sekarang, otomatisasi yang sama yang memicu sekumpulan pekerjaan pembuatan video di Kling 3.0 atau Seedance dapat memeriksa saldo yang tersedia terlebih dahulu dan memutuskan apakah akan melanjutkannya.

Management Token vs. API Key Inferensi Model

Penting untuk bersikap tepat mengenai hal ini, karena kedua jenis kredensial tersebut memiliki tujuan yang berbeda dan mencampurnya akan menyebabkan kesalahan yang membingungkan.

API key inferensi model adalah apa yang Anda gunakan untuk memanggil model secara langsung. Jika Anda mengirim permintaan chat completion ke GPT-5.5, membuat gambar dengan GPT Image 2 atau Nano Banana Pro, atau merender video dengan Veo 3 atau PixVerse V6, Anda melakukan autentikasi dengan inference key. Kunci ini dicakup untuk melakukan panggilan model dan mengembalikan output model. Kunci ini tidak memberi Anda akses ke data tingkat akun seperti saldo atau ringkasan penggunaan.

Management token adalah jenis kredensial terpisah yang dibuat untuk operasi akun. Token ini memungkinkan Anda menanyakan hal-hal tentang organisasi Anda secara keseluruhan: saldo, penggunaan di seluruh API key, dan data tingkat akun lainnya. Management token tidak memanggil model apa pun secara langsung. Ini adalah kredensial yang Anda gunakan untuk sisi pembukuan dalam menjalankan akun di TokenLab, bukan sisi pembuatan (generasi).

Menjaga keduanya tetap terpisah penting karena alasan praktis: ini memungkinkan Anda memberikan management token kepada proses keuangan atau operasional tanpa memberikan kemampuan kepada proses tersebut untuk menghabiskan anggaran model Anda. Sebaliknya, layanan yang hanya perlu memanggil GLM-5.2 atau DeepSeek V4 Flash tidak memerlukan visibilitas apa pun ke dalam saldo atau riwayat pengeluaran Anda, sehingga layanan tersebut seharusnya hanya memegang inference key.

Cara Kerja Pencarian Saldo

Endpoint baru ini mengembalikan total saldo organisasi Anda saat ini sebagai respons yang lugas. Anda memanggilnya dengan management token, dan endpoint tersebut akan memberi tahu Anda posisi saldo Anda.

Berikut adalah contoh minimal menggunakan nilai placeholder:

curl -s https://api.tokenlab.sh/v1/management/balance \
  -H "Authorization: Bearer YOUR_MANAGEMENT_TOKEN"

Respons tersebut memberi Anda angka saldo saat ini untuk organisasi Anda. Dari sana, pola yang biasa digunakan adalah:

1. Panggil endpoint saldo sesuai jadwal, atau tepat sebelum pekerjaan yang memakan biaya dimulai.
2. Bandingkan nilai yang dikembalikan dengan ambang batas yang Anda tentukan.
3. Piculah tindakan apa pun yang masuk akal: kirim peringatan, jeda antrean, blokir pengiriman pekerjaan baru, atau sekadar catat untuk nanti.

Karena ini adalah operasi baca yang sederhana, biaya untuk memanggilnya sering pun murah. Tim yang menjalankan pipeline volume tinggi terhadap model seperti DeepSeek V4 Pro atau Claude Sonnet 5 dapat memeriksa saldo sebelum setiap batch besar tanpa menambah overhead yang berarti.

Detail endpoint lengkap ada di referensi saldo Management API.

Di Mana Fitur Ini Cocok: Pemeriksaan Anggaran, Peringatan, dan Dasbor

Penggunaan paling umum yang diminta oleh tim mencakup empat skenario:

Kasus penggunaan	Seperti apa bentuknya
Pemeriksaan anggaran pra-pekerjaan	Skrip memeriksa saldo sebelum mengirimkan pekerjaan batch besar ke model seperti Kling 3.0 atau Veo 3, melewatkan pekerjaan jika saldo terlalu rendah
Peringatan isi ulang	Pemeriksaan terjadwal membandingkan saldo dengan nilai batas bawah, mengirim peringatan Slack atau email saat terlampaui
Jeda dan lanjutkan alur kerja	Otomatisasi menjeda pipeline yang memanggil Qwen3.7 Plus atau GLM-5.2 saat saldo turun, melanjutkannya setelah diisi ulang
Dasbor keuangan	Angka saldo ditarik sesuai jadwal dan ditampilkan bersama data penggunaan untuk pelaporan

Jika Anda menyiapkan ini untuk pertama kalinya, daftar periksa singkat membantu menjaga implementasi tetap bersih:

• Buat atau konfirmasi bahwa management token Anda memiliki cakupan yang tepat untuk akses saldo
• Simpan management token secara terpisah dari API key inferensi apa pun
• Tetapkan interval polling yang masuk akal (sekali per pekerjaan, per jam, atau per hari, tergantung pada kasus penggunaan Anda)
• Tentukan ambang batas peringatan Anda sebelumnya, bukan setelah saldo menipis
• Pasangkan pencarian saldo dengan endpoint penggunaan API key jika Anda menginginkan rincian pengeluaran lengkap bersama angka saldo

Bagi tim yang juga menginginkan data pengeluaran historis alih-alih hanya angka saldo langsung, postingan ekspor penggunaan dasbor membahas cara menarik data tersebut untuk pelaporan.

Memulai

Jika Anda sudah menggunakan Management API untuk pelaporan penggunaan, menambahkan pemeriksaan saldo adalah langkah kecil: pola autentikasi yang sama, satu endpoint baru untuk dipanggil. Jika Anda belum menyiapkan management token, buatlah satu dari pengaturan akun Anda dan simpan secara terpisah dari API key inferensi apa pun yang Anda gunakan untuk memanggil model.

FAQ

Apakah pencarian saldo memerlukan API key khusus? Tidak ada jenis kunci khusus selain management token standar. Ini adalah kredensial yang berbeda dari API key inferensi yang digunakan untuk memanggil model, tetapi tidak diperlukan konfigurasi tambahan selain memiliki management token yang valid.

Bisakah saya menggunakan ini untuk menghentikan pekerjaan secara otomatis saat saldo habis? Ya. Itu adalah salah satu kasus penggunaan utama. Periksa saldo sebelum atau selama pekerjaan, dan jika saldo turun di bawah ambang batas Anda, jeda alur kerja, hentikan antrean, atau blokir pengiriman baru hingga saldo dipulihkan.

Apakah ini sama dengan endpoint penggunaan? Tidak. Pencarian saldo mengembalikan total saldo Anda saat ini. Endpoint penggunaan API key mengembalikan data penggunaan yang dirinci berdasarkan kunci. Sebagian besar dasbor keuangan menggunakan keduanya secara bersamaan.

Sumber dan Pembaruan

Artikel ini mencerminkan endpoint saldo Management API sebagaimana diamati pada 2026-07-07. Perilaku endpoint dan format respons dapat berubah; periksa dokumentasi endpoint saldo resmi untuk referensi saat ini.

---

Siap untuk membangun pemeriksaan saldo ke dalam alur kerja Anda? Masuk ke TokenLab, buat management token, dan mulailah memeriksa saldo organisasi Anda hari ini.

Bacaan Terkait dan Langkah Selanjutnya

Pencarian saldo organisasi bekerja bersama alat pelaporan lain yang sudah tersedia di Management API TokenLab. Untuk melihat lebih dekat bagaimana data pengeluaran dapat ditarik dan ditinjau secara berkala, lihat Ekspor Penggunaan TokenLab Membuat Pengeluaran API AI Lebih Mudah Ditinjau. Jika Anda merencanakan pengeluaran sebelum peluncuran, Panduan Kalkulator Biaya API AI: Estimasi Pengeluaran Sebelum Anda Rilis membahas cara mengestimasi biaya sebelum permintaan dikirim. Dan untuk konteks tentang bagaimana penyedia bersaing satu sama lain, Perbandingan Harga API AI 2026: Biaya Sebenarnya dari GPT-5.5, Claude Sonnet 5, dan Gemini 3.5 Flash merinci tarif saat ini di berbagai model utama.

Seperti biasa, ketersediaan dan harga model sering berubah, jadi konfirmasikan detail saat ini sebelum mengandalkannya untuk penggunaan produksi volume tinggi. Siap mencoba pencarian saldo sendiri? Buat API key dan mulailah mengujinya hari ini.