TokenLab Management API, Organizasyon Bakiyesi Sorgulama Özelliği Ekledi

TokenLab'in Management API'si artık doğrudan bakiye sorgulamayı destekliyor; bu sayede ekipler, kontrol panelini manuel olarak kontrol etmek yerine bir yönetim token'ı aracılığıyla organizasyonlarının güncel toplam bakiyesini sorgulayabiliyor. Bu özellik, otomatik bütçe kontrolleri, bakiye yükleme uyarıları veya kullanım sınırlamalı iş akışları yürüten ekipler için yaygın bir eksikliği gideriyor.

Öne Çıkanlar

• Management API artık organizasyonunuzun güncel toplam bakiyesini döndüren bir bakiye uç noktası (endpoint) sunuyor.
• Bu, Claude Sonnet 5, GPT-5.5, Gemini 3.5 Flash ve diğer modelleri çağırmak için kullanılan model çıkarım (inference) API anahtarlarından ayrıdır.
• Bakiye sorgulama; bütçe kontrolleri, bakiye yükleme uyarıları, otomatik iş akışlarını duraklatma veya devam ettirme ve finans panellerini besleme amaçlıdır.
• Bu uç nokta, eksiksiz bir harcama tablosu oluşturmak için mevcut API anahtarı kullanım uç noktasıyla birlikte iyi çalışır.

Bu Neden Eksikti?

Bu güncellemeden önce organizasyonunuzun bakiyesini kontrol etmek, TokenLab kontrol paneline giriş yapıp faturalandırma sayfasından bakmak anlamına geliyordu. Bu, günde bir kez kontrol eden bir kişi için sorun değil, ancak herhangi bir şeyi otomatikleştirmek istediğiniz anda işleri zorlaştırıyordu.

DeepSeek V4 Pro, Qwen3.7 Plus veya Kimi K2.7 Code gibi modellerde üretim iş yüklerini çalıştıran ekipler, genellikle büyük bir işi başlatmadan önce bakiyeyi kontrol eden bir betiğe veya bakiye belirli bir eşiğin altına düştüğünde uyarı veren bir izleme sistemine ihtiyaç duyarlar. Sorgulanabilir bir bakiye uç noktası olmadan tek seçenek manuel kontroller veya kontrol panelini kazımaktı (scraping); bunların hiçbiri üretim ortamında çalışmasını isteyeceğiniz yöntemler değildir.

Management API üzerinden bakiye sorgulama bu sorunu çözüyor. Artık Kling 3.0 veya Seedance üzerinde bir video üretim işi grubunu tetikleyen otomasyon, önce mevcut bakiyeyi kontrol edip devam edip etmeyeceğine karar verebiliyor.

Yönetim Token'ları ve Model Çıkarım (Inference) API Anahtarları

Bu konuda hassas olmakta fayda var, çünkü iki kimlik bilgisi türü farklı amaçlara hizmet eder ve bunları karıştırmak kafa karıştırıcı hatalara yol açar.

Model çıkarım API anahtarları, modelleri doğrudan çağırmak için kullandığınız anahtarlardır. GPT-5.5'e bir sohbet tamamlama isteği gönderiyorsanız, GPT Image 2 veya Nano Banana Pro ile bir görsel oluşturuyorsanız ya da Veo 3 veya PixVerse V6 ile video işliyorsanız, bir çıkarım anahtarıyla kimlik doğrulaması yapıyorsunuz demektir. Bu anahtarlar, model çağrıları yapma ve model çıktısı alma ile sınırlıdır. Bakiye veya kullanım özetleri gibi hesap düzeyi verilere erişim sağlamazlar.

Yönetim token'ları ise hesap işlemleri için oluşturulmuş ayrı bir kimlik bilgisi türüdür. Organizasyonunuzun bütünüyle ilgili şeyleri sorgulamanıza olanak tanırlar: bakiye, API anahtarları genelindeki kullanım ve diğer hesap düzeyi veriler. Bir yönetim token'ı hiçbir modeli doğrudan çağırmaz. Bu, TokenLab'de bir hesap yürütmenin üretim tarafı için değil, muhasebe tarafı için kullandığınız kimlik bilgisidir.

Bunları ayrı tutmak pratik bir nedenden dolayı önemlidir: Bir finans veya operasyon sürecine, model bütçenizi tüketme yetkisi vermeden bir yönetim token'ı teslim etmenizi sağlar. Tersine, sadece GLM-5.2 veya DeepSeek V4 Flash çağırması gereken bir hizmetin bakiyeniz veya harcama geçmişiniz üzerinde herhangi bir görünürlüğe ihtiyacı yoktur, bu nedenle sadece bir çıkarım anahtarına sahip olmalıdır.

Bakiye Sorgulama Nasıl Çalışır?

Yeni uç nokta, organizasyonunuzun güncel toplam bakiyesini basit bir yanıt olarak döndürür. Bunu bir yönetim token'ı ile çağırırsınız ve size durumun ne olduğunu söyler.

İşte yer tutucu değerler kullanan minimal bir örnek:

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

Yanıt size organizasyonunuz için güncel bakiye rakamını verir. Buradan itibaren izlenen genel yöntem şöyledir:

1. Bakiye uç noktasını bir programa göre veya maliyetli bir iş başlamadan hemen önce çağırın.
2. Döndürülen değeri belirlediğiniz bir eşik değerle karşılaştırın.
3. Mantıklı olan eylemi tetikleyin: uyarı gönderin, bir kuyruğu duraklatın, yeni iş gönderimlerini engelleyin veya sadece daha sonrası için günlüğe kaydedin.

Bu basit bir okuma işlemi olduğundan, sık sık çağrılması maliyetsizdir. DeepSeek V4 Pro veya Claude Sonnet 5 gibi modellerde yüksek hacimli iş hatları çalıştıran ekipler, anlamlı bir ek yük oluşturmadan her büyük gruptan önce bakiyeyi kontrol edebilir.

Uç nokta ile ilgili tüm detaylar Management API bakiye referansında mevcuttur.

Bu Özellik Nereye Uyuyor: Bütçe Kontrolleri, Uyarılar ve Paneller

Ekiplerin talep ettiği en yaygın kullanım durumları dört senaryoyla eşleşiyor:

Kullanım durumu	Nasıl görünüyor
İş öncesi bütçe kontrolü	Betiğin, Kling 3.0 veya Veo 3 gibi bir modele büyük bir grup işi göndermeden önce bakiyeyi kontrol etmesi, bakiye çok düşükse işi atlaması
Bakiye yükleme uyarısı	Planlanmış kontrolün, bakiyeyi bir alt sınır değeriyle karşılaştırması ve aşıldığında Slack veya e-posta uyarısı göndermesi
İş akışını duraklatma ve devam ettirme	Otomasyonun, bakiye düştüğünde Qwen3.7 Plus veya GLM-5.2 çağıran bir hattı duraklatması, bakiye yüklendiğinde devam ettirmesi
Finans panelleri	Bakiye rakamının bir programa göre çekilmesi ve raporlama için kullanım verileriyle birlikte görüntülenmesi

Bunu ilk kez kuruyorsanız, kısa bir kontrol listesi uygulamanın temiz kalmasına yardımcı olur:

• Yönetim token'ınızın bakiye erişimi için doğru kapsama sahip olduğunu oluşturun veya onaylayın
• Yönetim token'ını herhangi bir çıkarım API anahtarından ayrı bir yerde saklayın
• Makul bir yoklama (polling) aralığı belirleyin (kullanım durumunuza bağlı olarak iş başına, saatlik veya günlük)
• Uyarı eşiğinizi bakiye azaldıktan sonra değil, önceden belirleyin
• Bakiye rakamının yanında tam bir harcama dökümü istiyorsanız bakiye sorgulamayı API anahtarı kullanım uç noktası ile eşleştirin

Sadece canlı bir bakiye rakamı yerine geçmiş harcama verilerini de isteyen ekipler için, kontrol paneli kullanım dışa aktarımları yazısı, bu verilerin raporlama için nasıl çekileceğini ele almaktadır.

Başlarken

Eğer zaten kullanım raporlaması için Management API kullanıyorsanız, bakiye kontrolleri eklemek çok kolaydır: aynı kimlik doğrulama düzeni, çağrılacak yeni bir uç nokta. Henüz bir yönetim token'ı oluşturmadıysanız, hesap ayarlarınızdan bir tane oluşturun ve modelleri çağırmak için kullandığınız çıkarım API anahtarlarından ayrı tutun.

SSS

Bakiye sorgulama özel bir API anahtarı gerektirir mi? Standart bir yönetim token'ı dışında özel bir anahtar türü gerekmez. Modelleri çağırmak için kullanılan çıkarım API anahtarlarından farklı bir kimlik bilgisidir, ancak geçerli bir yönetim token'ına sahip olmanın dışında ek bir yapılandırma gerekmez.

Bunu, bakiye tükendiğinde işleri otomatik olarak durdurmak için kullanabilir miyim? Evet. Bu, birincil kullanım durumlarından biridir. Bir işten önce veya iş sırasında bakiyeyi kontrol edin ve eşiğinizin altına düşerse, bakiye yenilenene kadar iş akışını duraklatın, kuyruğu durdurun veya yeni gönderimleri engelleyin.

Bu, kullanım uç noktasıyla aynı mı? Hayır. Bakiye sorgulama, güncel toplam bakiyenizi döndürür. API anahtarı kullanım uç noktası, anahtara göre dökümü alınmış kullanım verilerini döndürür. Çoğu finans paneli her ikisini birlikte kullanır.

Kaynaklar ve Güncellik

Bu makale, 2026-07-07 tarihinde gözlemlendiği şekliyle Management API bakiye uç noktasını yansıtmaktadır. Uç nokta davranışı ve yanıt formatları değişebilir; güncel referans için resmi bakiye uç noktası dokümantasyonunu kontrol edin.

---

Bakiye kontrollerini iş akışınıza dahil etmeye hazır mısınız? TokenLab'e giriş yapın, bir yönetim token'ı oluşturun ve organizasyonunuzun bakiyesini bugün sorgulamaya başlayın.

İlgili Okumalar ve Sonraki Adım

Organizasyon bakiye sorgulama, TokenLab Management API'sinde halihazırda mevcut olan diğer raporlama araçlarıyla birlikte çalışır. Harcama verilerinin düzenli olarak nasıl çekilip incelenebileceğine daha yakından bakmak için TokenLab Kullanım Dışa Aktarımları, AI API Harcamalarının İncelenmesini Kolaylaştırıyor yazısına göz atın. Bir lansman öncesinde harcama planlıyorsanız, AI API Maliyet Hesaplayıcı Kılavuzu: Göndermeden Önce Harcamayı Tahmin Edin yazısı, istekler gitmeden önce maliyetleri tahmin etme sürecini adım adım anlatır. Sağlayıcıların birbirine göre durumunu anlamak için ise 2026 AI API Fiyat Karşılaştırması: GPT-5.5, Claude Sonnet 5 ve Gemini 3.5 Flash'ın Gerçek Maliyeti yazısı, büyük modeller genelindeki güncel oranları detaylandırır.

Her zaman olduğu gibi, model kullanılabilirliği ve fiyatlandırma sık sık değişir, bu nedenle yüksek hacimli üretim kullanımı için bunlara güvenmeden önce güncel ayrıntıları doğrulayın. Bakiye sorgulamayı kendiniz denemeye hazır mısınız? Bir API anahtarı oluşturun ve bugün test etmeye başlayın.