Temel kılavuzlar

Faturalandırma ve fiyatlandırma

Ücretler, tahminler, bakiyeler ve limitlerin nasıl çalıştığı

Tek bir TokenLab bakiyesi tüm modellerde geçerlidir. Abonelik veya minimum harcama zorunluluğu yoktur. Bakiye yüklemeleri 5$'dan başlar. Ücretler, modele ve her istek için kaydedilen kullanıma göre belirlenir.

Teslimat seçenekleri

Aynı model ve API iki farklı rota üzerinden sunulur: Verified daha ucuzdur, Official ise daha güvenilirdir. Teslimat seçeneği, isteğin hangi rotadan çalışacağını ve hangi fiyatı ödeyeceğinizi belirler.

SeçenekRotaFiyatRota kullanılamıyorsa
VerifiedYalnızca Verified: TokenLab tarafından test edilen rotalarVerified fiyatı, çoğu modelde Official fiyatından daha düşüktürİstek başarısız olur ve ücretlendirilmez
OfficialYalnızca Official: Model üreticisi veya büyük bir platformOfficial fiyatı, model üreticisinin yayınladığı fiyatİstek başarısız olur ve ücretlendirilmez
Auto (varsayılan)Önce Verified. Verified'da arz yoksa veya çıktı üretilmeden önce başarısız olursa Official rotası bir kez çalışırİsteği tamamlayan rotanın fiyatıOfficial rotası isteği çalıştırır

Modeller sayfası, her model için her iki fiyatı da gösterir.

  • Tamamlanan her istek bir kez ücretlendirilir.
  • Auto, çıktı başladıktan veya bir görev kabul edildikten sonra rota değiştirmez.
  • Bir çalıştırma öncesinde Auto, olası iki tutardan yüksek olanı rezerve eder. Bakiye yalnızca Verified tahminini karşılıyorsa, Auto o istek için yalnızca Verified rotasını çalıştırır ve Official rotasına geçiş yapmaz. Çalıştırma sonrasında gerçek ücreti ödersiniz ve kalan tutar serbest bırakılır.
  • X-TokenLab-Delivery-Policy istek başlığı, API anahtarı ayarını geçersiz kılar; API anahtarı ayarı ise Çalışma Alanı (Workspace) varsayılanını geçersiz kılar. Bkz. API'ye giriş.

Ücretli üretim için Console, onay öncesinde maksimum tahmini gösterir. Tamamlandıktan sonra, Çalıştırmalar (Runs) ve Kullanım (Usage) bölümleri nihai ücreti ve isteği tamamlayan seçeneği gösterir.

Fiyatlandırma Modelleri

Model fiyatları değişebilir. Güncel fiyat için Console'u, Modeller sayfasını, GET /v1/models/:model/pricing uç noktasını veya Fiyatlandırma API'sini kontrol edin.

Modeller sayfasında, Verified fiyatı veya indirim sütunundaki bir çizgi, şu anda bir Verified teklifinin mevcut olmadığı anlamına gelir; bu, ücretsiz olduğu anlamına gelmez. Official arzı olan modeller, Official veya Auto aracılığıyla kullanılabilir kalmaya devam eder. API'de, böyle bir modelin Verified fiyat alanları null değerindedir veya belirtilmemiştir; official_* fiyat alanları ise ödeyeceğiniz tutarı gösterir. Teslimat etiketleri desteklenen seçenekleri tanımlarken, kullanılabilirlik her istek çalıştırıldığında kontrol edilir. Seri fiyatları, ilgili teslimat seçeneğinde arzı olan modelleri özetler ve farklı faturalandırma birimlerini ayrı tutar.

Token Bazlı Fiyatlandırma

Çoğu sohbet, akıl yürütme, yerleştirme (embedding), yeniden sıralama (rerank) ve bazı görsel modelleri; girdi, çıktı, önbellek veya görsel-çıktı token'ları üzerinden fiyatlandırılır.

Fiyatlandırma ailesiÖrneklerGüncel fiyatı doğrulama
Sohbet / Yanıtlargpt-5.4, claude-sonnet-4-6, gemini-3.6-flashModeller sayfası veya Fiyatlandırma API'si
Yerleştirmeler / Yeniden sıralamatext-embedding-3-small, qwen3-vl-rerankModel fiyatlandırma detayı
Token bazlı görsellergpt-image-2GET /v1/models/gpt-image-2/pricing

Kopyalanmış bir fiyat tablosunu kodunuza sabit (hard-code) olarak eklemeyin. Uygulamanız maliyetleri görüntülemesi veya karşılaştırması gerektiğinde güncel fiyatı okuyun.

Araç ücretleri

Bazı yerleşik araçlar, token'lara ek olarak ekstra ücrete tabidir. TokenLab, araç ücretini yalnızca model aracı kullandığında ve yanıt bunu raporladığında alır. Modelin kullanmadığı bir aracı sunan bir istek için araç ücreti alınmaz.

AraçModellerÜcret
Web aramasıOpenAI, Claude ve Grok modelleri ile Google Arama destekli Gemini 3 modelleriModelin gerçekleştirdiği her arama için. Gemini 3 için her benzersiz arama sorgusu
Arama desteği (Grounding)Google Arama destekli Gemini 2.5 modelleriAramanın desteklediği her istek için bir kez
  • Her modelin, token fiyatlarında olduğu gibi Verified ve Official için kendi araç ücreti vardır. Modelin fiyatlandırma detaylarında bu, Web search veya Search grounding olarak görünür.
  • Modelin okuduğu arama sonuçları, modelin fiyatı üzerinden girdi token'ı olarak faturalandırılır.
  • Bir modelde fiyatı olmayan bir araç için ücret alınmaz.
  • Console'da, Çalıştırmalar (Runs) bölümünde bir isteği açın: Tool fees kısmı, çağrı sayısını ve her çağrının fiyatını gösterir. API anahtarı kullanım kayıtları, charged_price_basis içinde aynı değerleri gösterir: measure.dimensions.webSearchCalls veya groundedPrompts içindeki sayı ve effectiveUnitPrices.webSearch veya effectiveUnitPrices.groundedPrompt içindeki birim fiyat.

İstem önbellekleme (Prompt caching)

Bir model, bir istemin tekrarlanan başlangıç kısmını önbellekten okuyabilir. Önbellekten okunan token'lar, girdi token'larından daha ucuzdur.

  • GPT, Gemini ve diğer bazı modeller uzun tekrarlanan istemleri otomatik olarak önbelleğe alır. Herhangi bir ayar yapmanız gerekmez.
  • Claude modelleri yalnızca siz istediğinizde önbelleğe alır. Bir Sohbet Tamamlama isteğinde "anthropic_options": {"prompt_caching": true} gönderin. TokenLab, sistem isteminin sonunu ve en son kullanıcı mesajını önbellek noktaları olarak işaretler. Mesajlar API'si ile cache_control değerini bloklara kendiniz ekleyin.
ÜcretGirdi fiyatına kıyasla
Önbellek yazma, 5 dakika (varsayılan)Daha yüksek
Önbellek yazma, 1 saat ("prompt_caching_ttl": "1h")5 dakikalık yazmadan daha yüksek
Önbellek okumaDaha düşük
  • Önbellek fiyatları modele ve teslimat seçeneğine göre değişir. Bir orana güvenmeden önce modelin önbellek fiyatlarını Modeller sayfasından veya Fiyatlandırma API'sinden kontrol edin.
  • Hiç tekrarlanmayan bir istem, önbellek yazma işlemi nedeniyle önbellekleme açıkken biraz daha maliyetli olur.
  • Modelin minimum önbelleklenebilir uzunluğundan daha kısa bir istem önbelleğe alınmaz ve önbellek yazma ücreti uygulanmaz.
  • Bir saatlik önbellek her modelde mevcut değildir. Model listesinde yoksa beş dakikalık önbelleği kullanın.
  • Yanıt sonucu gösterir: usage.prompt_tokens_details.cached_tokens önbellekten okunan token sayısıdır. usage.cache_creation_input_tokens ise önbelleğe yazılan token sayısıdır ve yalnızca sıfırdan büyük olduğunda görünür.

Hizmet katmanı

TokenLab, istekleri standart hizmet katmanında çalıştırır ve faturalandırır. service_tier değerleri olarak auto ve default kabul edilir. flex, priority, fast ve ultrafast gibi diğer değerler göz ardı edilir: istek standart katmanda çalışır ve standart fiyattan ücretlendirilir.

İstek ve Görev Fiyatlandırması

Görsel, video, müzik, 3D, ses ve dünya modelleri istek, görsel, saniye, dakika veya görev başına fiyatlandırılabilir. Model sayfası faturalandırma birimini gösterir.

AileÖrnekler
Görselflux-pro-1.1
Videoveo3.1, seedance-2.0
Müziksuno-music
3Dtripo-h3.1
Sesgrok-tts, whisper-large-v3

Asenkron görev faturalandırması

Bazı görevler oluşturulduklarında tahmini maliyeti rezerve eder. Tamamlanan bir görev bir kez ücretlendirilir; başarısız olan bir görev bekleyen tutarı serbest bırakır veya iade eder.

Video, müzik, 3D ve görev tabanlı görsel oluşturma işlemleri bir görev kimliği (task ID) ve poll_url döndürür. Nihai tutar, görev completed (tamamlandı) veya failed (başarısız) durumuna geldikten sonra kaydedilir. Tamamlanan bir görev, faturalandırmadan sonra billing_transaction_id içerir; başarısız olan bir görev ücretlendirilmez.

Görev bittikten sonra Kullanım (Usage) kısmında nihai ücret veya serbest bırakılan tutar hala görünmüyorsa, İstek Kimliği (Request ID) ve görev kimliği ile hello@tokenlab.sh adresine ulaşın.

Faturalandırma işlem kimlikleri

Akış (streaming) olmayan OpenAI uyumlu yanıtlar, faturalandırma yanıt gönderilmeden önce bittiğinde billing_transaction_id içerir. Aynı değer X-Billing-Transaction-ID içinde görünebilir; Gemini ve diğer yerel formatlar bunu yalnızca bu başlıkta gösterebilir.

Asenkron görevler, tamamlandıktan sonra billing_transaction_id içerir. Akış, faturalandırmadan önce bitebileceğinden, başlık mevcut olmadığında Kullanım (Usage) kısmını kullanın.

Token sayıları

Metin modelleri genellikle girdi, çıktı ve toplam token sayılarını usage içinde raporlar. Tokenlaştırma modele, dile ve medya girdisine göre değiştiğinden, karakter sayısı formülleri güvenilir faturalandırma tahminleri değildir. Modelin güncel fiyatını ve nihai Kullanım (Usage) kaydını kullanın.

Kullanımınızı bulun

Şunları bulmak için Kullanım sayfasını açın:

  • Gerçek zamanlı bakiye
  • Modele göre kullanım geçmişi
  • Maliyet dökümü
  • API anahtarı kullanımı

API yanıtı

Token bazlı yanıtlar genellikle kullanım bilgilerini içerir:

{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

Daha az harcayın

Düşük bakiye uyarıları

Console → Settings bölümünden bir eşik değeri belirleyin. Bakiye bu değerin altına düştüğünde TokenLab size e-posta gönderir.

Bakiye ekleyin

Console → Billing bölümünü açın, bir tutar seçin ve ödeme ekranında gösterilen ödeme yöntemlerinden birini kullanın. Bakiye, ödeme sağlayıcısı ödemeyi onayladıktan sonra güncellenir.

Deneme kredisi teklifi devam ederken, uygun yeni bir hesap 10 çağrıya kadar tek seferlik 0.25$ deneme kredisi alır. Kullanılmayan deneme kredisi 7 gün sonra sona erer.

İsteklerin düşük bakiye nedeniyle durmasını önlemek için Billing bölümünde Automatic funding (Otomatik fonlama) özelliğini açın. Bu özellik, bakiye belirlediğiniz tutarın altına düştüğünde aylık bir limite kadar bakiye ekler.

API Anahtarı Limitleri

Console → API Keys bölümünde bir API anahtarı oluştururken veya düzenlerken harcama limiti belirleyebilirsiniz.

Limite ulaşıldığında, o anahtarla yapılan istekler quota_exceeded koduyla 402 hatası döndürür. Devam etmek için limiti artırın veya kaldırın.

Faturalandırma yardımı

Faturalandırma ile ilgili sorularınız için hello@tokenlab.sh ile iletişime geçin.

Bu sayfada