Yapay zekâ API bakiyemi koddan nasıl sorgularım, bakiye azalınca nasıl uyarı alırım?

Kısaca: Wiozen API'de bakiyeyi GET https://api.wiozen.com/v1/balance ile, normal isteklerde kullandığın anahtarla okursun. Yanıtta iki alan var: balance nano-dolar cinsinden bir tam sayı (1 dolar = 1.000.000.000), formatted ise ekranda gösterilecek metin. Bu istek ücretlenmez ve günlük sorgu hakkından düşmez; bir zamanlanmış görevle sorgulayıp eşiğin altına inince kendine bildirim gönderebilirsin.

Bakiye nasıl sorgulanır?

Uç tek bir GET isteği bekler, gövde yok. Anahtarını Authorization: Bearer başlığında gönder; x-api-key başlığı da kabul edilir. Anahtarını API_KEY ortam değişkenine koyup şunu çalıştır:

curl https://api.wiozen.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

Yanıt şöyle görünür:

{"balance": 4370000000, "formatted": "$4.37"}

Anahtar yoksa 401 Missing API key, anahtar yanlışsa ya da iptal edilmişse 401 Invalid API key döner. Bu yüzden aynı istek, bir anahtarın hâlâ çalışıp çalışmadığını model çağırmadan ve para harcamadan denemenin de en kolay yolu.

balance ve formatted alanları ne anlama geliyor?

Wiozen bakiyeyi kesirli dolar yerine nano-dolar olarak tam sayıyla tutar, çünkü tek bir kısa isteğin maliyeti bir sentin çok altında kalabilir. Dolara çevirmek için balance'ı 1.000.000.000'a böl: yukarıdaki 4370000000, 4,37 dolar demek.

Hesaplama ve karşılaştırma için her zaman balance'ı kullan. formatted insanlara göstermek içindir; ondalık basamak sayısı tutara göre değişir (1 doların altındaki tutarlar dört ya da altı basamakla yazılır) ve ayraçlar dile göre farklı olabilir. Onu sayıya çevirmeye çalışma.

Bakiye eksiye düşebilir. Tek bir isteğin maliyeti kalan bakiyeden fazla çıkarsa fark bir sonraki yüklemeden düşer; o arada balance negatif bir sayı olur. Kodun bu durumu da "bakiye bitti" olarak ele alsın.

Bakiye hangi anahtarın, hangi hesabın?

Bakiye hesaba aittir, anahtara değil. Aynı hesaptaki hangi anahtarla sorgularsan sorgula aynı sayıyı görürsün. Bütün anahtarların harcaması bu tek bakiyeden düşer.

Anahtara koyduğun harcama limiti bu yanıtta görünmez. Limiti dolan bir anahtar, hesapta bakiye olsa bile istekleri 429 API key spend limit reached ile reddeder. Anahtar başına harcamayı ve limiti Anahtarlar sayfasında görürsün.

Kendi düşük bakiye uyarını kurmak

Bakiye istek başlarken kontrol edilir. Kalan tutar isteğin tahmini maliyetine yetmezse istek 429 Quota exhausted alır ve başlamaz. Gece çalışan bir toplu iş ya da müşterine açık bir uygulama için bunu hata geldikten sonra öğrenmek geç olur. Bakiyeyi düzenli sorgulayıp eşiğin altına inince uyarı veren küçük bir betik bunu önler:

import os
import requests

THRESHOLD_USD = 2.0  # bu tutarın altında uyar

r = requests.get(
    "https://api.wiozen.com/v1/balance",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    timeout=10,
)
r.raise_for_status()
usd = r.json()["balance"] / 1_000_000_000

if usd < THRESHOLD_USD:
    print(f"Bakiye azaldı: ${usd:.2f}")
    # Buraya kendi bildirimini koy: e-posta, Slack, Telegram...

Betiği cron ya da başka bir zamanlayıcıyla saatte bir çalıştırmak çoğu kullanım için yeter. Eşiği bir günlük harcamana göre seç; günde ortalama ne harcadığını Kullanım sayfasındaki grafikten görürsün.

Bakiye sorgusu dakikalık istek sınırına da takılmaz; o sınır yalnız sohbet uçlarında sayılır. Yine de her model isteğinden önce bakiye sorgulamana gerek yok. Bakiye yetmediğinde zaten 429 alırsın; o hatanın diğer nedenlerden nasıl ayrıldığı 429 rehberinde.

Panelde ve e-postada uyarı var mı?

Var. API panelinin ana sayfası bakiye belli bir tutarın altına inince "Bakiyen azaldı" uyarısı, sıfıra inince de isteklerin 429 döndüğünü söyleyen bir uyarı gösterir. Düşük bakiye e-postası Wiozen hesabından gelir ve account.wiozen.com'daki hesap ayarlarından yönetilir.

Bu iki uyarının eşiği senin seçtiğin bir tutar değil. Kendi eşiğini istiyorsan ya da uyarının e-posta dışında bir yere (bir sohbet kanalına, telefona) gitmesini istiyorsan yukarıdaki betik daha uygun.

İçerik Botu da bakiyeyi aynı uçtan okur ve eklenti panelinde gösterir. Gösterilen tutar beş dakika önbellekte tutulur; yükleme yaptıktan hemen sonra eski tutarı görürsen birkaç dakika bekle.

Sık sorulan sorular

Bir anahtarla /v1/balance isteğini şimdi dene. Bakiye yüklemek için cüzdan sayfasına git.

Hesabını aç

Diğer rehberler: Türkiye'den kredi kartı olmadan yapay zekâ API'si nasıl kullanılır? · OpenAI uyumlu bir API mevcut bir araca nasıl bağlanır? · Yapay zekâ API maliyeti nasıl hesaplanır? · Yapay zekâ API anahtarım sızdıysa ne yapmalıyım? · Yapay zekâ API'siyle görsel nasıl üretilir ve görsel başı maliyeti ne kadar? · Ses dosyasını yazıya çeviren API'nin dakikası kaç dolar, ücret nasıl hesaplanıyor? · Yapay zekâ API'si neden 429 hatası veriyor, nasıl düzeltilir? · Uzun yanıt bekleyen API isteği neden zaman aşımına düşer: akışlı mı, akışsız mı? · Anthropic Messages API mı, OpenAI Chat Completions mı: hangisini kullanmalıyım? · Bağlam penceresi (context window) nedir, 1 milyon token ne işe yarar? · Hangi yapay zekâ modelini seçmeliyim: fiyat, bağlam ve kaliteye göre karar · Düşünen (reasoning) model neden boş cevap döner, düşünme tokenları neden ücretlenir? · API bakiyem neden beklediğimden hızlı bitiyor? Harcamayı istek istek takip etmek · Bir web sayfası yapay zekâya vermek için Markdown'a nasıl çevrilir? · WordPress'te yapay zekâyla otomatik makale nasıl yazdırılır? · Blog için RSS ve Google Trends'ten konu nasıl bulunur? · Yapay zekâyla yazılan içerik Google'da ve yapay zekâ yanıtlarında görünür mü? · WordPress'te yapay zekâyla yazılan makalelere iç bağlantı nasıl ekletilir? · WordPress'te her yazıya birbirine benzemeyen öne çıkan görsel yapay zekâyla nasıl ürettirilir? · Yapay zekâya blog yazısı yazdırırken içerik tarifi (brief) nasıl yazılır? · Yemek tarifi sitesine yapay zekâyla tarif yazdırırken nelere dikkat etmeli? · WordPress eklentisini yapay zekâ API hesabına bağlarken çıkan hatalar nasıl çözülür? · WordPress'te yapay zekâ yazı botu neden yarıda kalıyor? "Tur takıldı" uyarısı ve LiteSpeed · WordPress'te otomatik yazılar neden geç çıkıyor? WP-Cron ve gerçek sunucu cron'u · Yapay zekâ yazı botuyla İngilizce ya da başka dilde blog yazısı nasıl yazdırılır? · "İçerik Botu yazı üretemiyor" uyarısı ne demek? Bot günlüğündeki satırları okumak · WordPress yapay zekâ yazı eklentisini silersem yazdığı yazılar da silinir mi? · Yapay zekâ API'sinde araç çağırma (function calling) nasıl yapılır?