Neden izlemelisiniz?
API kullanımınızı izlemek üç şey için önemlidir: maliyeti kontrol etmek, hataları (özellikle 5xx ve zaman aşımı) fark etmek ve beklenmedik sıçramaları (hatalı bir döngü, sızmış bir anahtar) erkenden yakalamak. Konsol bunun için iki araç sunar: Genel bakış ve İstek günlüğü.
Genel bakış
Konsolda Genel bakış sekmesi şunları gösterir:
Bakiye kartı
Büyük rakam, kalan kredinizdir (dolar olarak; altında TL karşılığı). Altında "Toplam harcama … · N istek" yazar. Yanındaki düğmelerle doğrudan Kredi yükle veya Playground'u dene sayfalarına geçebilirsiniz.
Özet kartları
Seçili dönem için dört kart:
| Kart | Anlamı |
|---|---|
| Harcama | Dönem içinde harcadığınız tutar (dolar; altında TL) |
| Giriş tokenı | Modele gönderdiğiniz toplam token |
| Çıkış tokenı | Modellerin ürettiği toplam token |
| İstek | Dönem içindeki istek sayısı |
Sağ üstteki 7 gün / 30 gün / 90 gün düğmeleriyle dönemi değiştirirsiniz.
Günlük token grafiği
Her çubuk bir günü gösterir; yükseklik o günün toplam (giriş + çıkış) token sayısıdır. Sol kenarda ölçek (ör. "146 K", "73 K"), altta ilk gün ve bugün yazar. Çubuğun üzerine gelince o günün detayı çıkar: tarih, token sayısı, istek sayısı ve harcama. Hiç istek olmayan günler ince bir çizgi olarak görünür. Bugünün çubuğu daha koyu renklidir.
Grafikte şunlara bakın:
- Ani sıçrama: Tek bir günde beklenmedik yükseliş = hatalı döngü, bir test betiği ya da sızmış anahtar olabilir.
- Süregelen artış: Kullanıcı sayınız ya da istek başına token artıyor mu?
- Sıfır günler: Entegrasyonunuz çalışmıyor olabilir.
Modele göre harcama
Her model için bir ilerleme çubuğu ve harcama tutarı; altında istek sayısı, giriş ve çıkış tokenı yazar. Bütçenizin hangi modele gittiğini görüp daha ekonomik bir modele geçip geçemeyeceğinizi değerlendirebilirsiniz.
Kurulum adımları
Henüz kredi yüklemediyseniz, anahtar oluşturmadıysanız ya da ilk isteği göndermediyseniz, Genel bakış'ta bir kurulum kontrol listesi çıkar; her adımın yanındaki Git düğmesi sizi ilgili sayfaya götürür. Hepsi tamamlanınca liste kaybolur.
İstek günlüğü
İstek günlüğü sekmesi, son 200 isteğinizi (yeniden eskiye) tablo halinde listeler. Yenile düğmesi listeyi günceller.
| Sütun | Anlamı |
|---|---|
| Zaman | "az önce", "5 dk önce"… (tam tarih için üzerine gelin) |
| Anahtar | İsteği yapan anahtarın adı; Playground istekleri "Playground" yazar; iptal edilmiş anahtarlar "(iptal)" eki alır |
| Model | Kullanılan model (ör. cocorex-1) |
| Uç | chat (OpenAI biçimi), messages (Anthropic biçimi) veya playground; ⚡ işareti akış (stream) kullanıldığını gösterir |
| Giriş / Çıkış | Token sayıları |
| Maliyet | İsteğin tutarı (dolar; üzerine gelince TL karşılığı) |
| Süre | İsteğin toplam süresi (ms veya sn) |
| Durum | 200 başarılı; diğerleri hata |
Durum kodları
- 200 (yeşil): Başarılı. Ücret alındı.
- 502 / 504 / 500 (kırmızı): Model sağlayıcı hatası, zaman aşımı veya sunucu hatası. Ücretlendirilmez (maliyet "—"). Üzerine gelince hata türü (
upstream_error,upstream_timeout,server_error) görünür.
Neler kaydedilmez?
Günlükte yalnızca kullanım bilgileri (zaman, anahtar, model, uç, token, maliyet, süre, durum) tutulur. Mesaj ve cevap metinleriniz günlüğe yazılmaz — bu yüzden günlükten bir isteğin içeriğini geri okuyamazsınız. Saklama süresi: son 200 istek; günlük özetler yaklaşık 120 gün.
Günlüğü nasıl kullanırsınız?
Maliyeti anlamak: En pahalı isteklere (Maliyet sütunu) bakın. Giriş tokenı çok yüksekse sohbet geçmişiniz veya sistem talimatınız şişiyor olabilir (maliyet rehberi).
Hataları bulmak: Kırmızı durumlar kümeleniyorsa o zaman aralığında bir kesinti vardı. Tekrar deneme (retry) mantığınız varsa bunları doğrulayın.
Yavaşlığı ölçmek: Süre sütunu; modeller arasında karşılaştırın. Akış kullanıyorsanız kullanıcı, tamamlanmayı beklemeden ilk kelimeyi görür.
Anahtar bazlı denetim: Anahtar sütunuyla hangi uygulamanın ne yaptığını görün. Beklenmedik bir anahtar kullanımı sızıntı işareti olabilir; hemen iptal edin (anahtar yönetimi).
Test istekleri: Playground isteklerini "Playground" anahtarıyla ayırt eder, üretim kullanımından ayrıştırırsınız.
Sık sorulanlar
Grafikteki bugünün verisi gecikmeli mi? Hayır; bir istek tamamlandığında kayda geçer. Sayfayı yenileyin.
Günlükte 200'den eski isteklerim yok. Evet; yalnızca son 200 istek tutulur. Daha uzun geçmiş için kendi tarafınızda istek kaydı tutmanızı öneririz.
Harcamam ile bakiye düşüşü uyuşmuyor. Kredi yüklemeleri ve (varsa) indirimler bakiyeyi etkiler; Genel bakış'taki "Harcama" kartı dönem içi yalnızca kullanım tutarını gösterir.
Günlük saat dilimi nedir? Günler Türkiye saatine göre (gece yarısı) ayrılır.