Ana içeriğe atla

​
Genel Bakış

TokenLab kullandıkça öde fiyatlandırması kullanır. Abonelik veya minimum taahhüt olmadan yalnızca kullandığınız kadar ödersiniz.

​
Faturalandırma Nasıl Çalışır

  1. Hesabınıza kredi ekleyin
  2. API’yi kullanın - maliyetler istek başına düşülür
  3. Panelinizden kullanımı izleyin
  4. Bakiyeniz azaldığında yükleme yapın

​
Fiyatlandırma Modelleri

Canlı fiyatlar sağlayıcı, route ve model details değiştikçe değişebilir. Dashboard, Models sayfası, GET /v1/models/:model/pricing ve Pricing API doğru kaynak kabul edilmelidir.

​
Token bazlı fiyatlandırma

Çoğu chat, reasoning, embedding, rerank ve bazı görüntü modelleri input, output, cache veya image-output token üzerinden fiyatlanır.
Fiyat ailesiÖrneklerGüncel fiyatı doğrula
Chat / Responsesgpt-5.4, claude-sonnet-4-6, gemini-3.5-flash模型页或 Pricing API
嵌入 / reranktext-embedding-3-small, qwen3-vl-rerank模型价格详情
按 token 计费的图像gpt-image-2GET /v1/models/gpt-image-2/pricing
Statik fiyat tablolarını production mantığına kopyalamayın. Kodda yalnızca model ID saklayın ve yayından önce güncel fiyatı kontrol edin.

​
İstek ve görev fiyatlandırması

Görüntü, video, müzik, 3D, ses ve world generation modelleri istek, görüntü, saniye/dakika, görev veya sağlayıcıya özel kullanıma göre fiyatlanabilir.
AileÖrnekler
图像flux-pro, qwen-image-plus
视频veo3.1, seedance-2.0
音乐suno-music
3Dtripo-h3.1
音频tts-1, whisper-1

​
Asenkron Görev Faturalandırması (Video/Müzik/3D ve Bazı Görüntü Modelleri)

Görev tabanlı oluşturma sırasında görev oluşturma, tahmini maliyeti rezerve edebilir veya önceden düşebilir. Nihai mutabakat yalnızca asenkron görev polling veya finalization sırasında başarılı terminal duruma ulaştıktan sonra yapılır.
Görev tabanlı oluşturma akışları için (video, müzik, 3D ve bazı görüntü modelleri):
  1. Görevi gönderin. TokenLab bakiye ve API Key harcama limitlerini doğrulamak için tahmini bir ön kesinti veya rezervasyon yapabilir.
  2. Görev terminal duruma ulaşana kadar dönen poll_url değerini sorgulayın veya GET /v1/tasks/{id} çağırın.
  3. Görev başarıyla tamamlandığında nihai mutabakat kullanımı kaydeder ve görev yanıtı billing_transaction_id içerir.
  4. Oluşturma başarısız olursa veya terminal durum failed ise bekleyen tutar iade edilir ya da serbest bırakılır ve istek faturalandırılamaz olarak işaretlenir.
Terminal durum görünür olduktan sonra dashboard mutabakatı veya iadeyi yansıtmıyorsa support@tokenlab.sh adresiyle iletişime geçin. 
# Örnek: Video oluşturma faturalandırması
response = client.post("/v1/videos/generations", json={
    "model": "veo3.1",
    "prompt": "A sunset over the ocean"
})
# Tahmini maliyet şimdi rezerve edilebilir; nihai fatura başarıdan sonra görünür.

poll_url = response.json()["poll_url"]
task_id = response.json()["task_id"]
# Durum için poll_url'i sorgulayın; billing_transaction_id mutabakat sonrası görünür.

​
Faturalama işlem ID’leri

Ücretlendirilen, streaming olmayan ve OpenAI uyumlu JSON yanıtları, mutabakat yanıt tamamlanmadan önce bittiyse billing_transaction_id içerir. Aynı değer tarayıcı ve sunucu entegrasyonları için X-Billing-Transaction-ID yanıt header’ı olarak da sunulur. Gemini /v1beta gibi native uyumluluk route’ları, provider-native yanıt şeklini korumak için değeri yalnızca header üzerinden sunabilir. Asenkron medya görevleri için dönen poll_url değerini veya GET /v1/tasks/{id} yolunu sorgulayın; mutabakat tamamlandığında görev yanıtı billing_transaction_id içerir. Streaming yanıtları stream gönderildikten sonra mutabakata bağlanabilir; header yoksa mutabakat için dashboard kullanım kayıtlarını kullanın.

​
Token Sayımı

Token’lar, metin işlemenin temel birimleridir:
  • ~4 karakter = 1 token (İngilizce)
  • ~1-2 karakter = 1 token (Çince)
  • 1 görüntü = boyuta ve detaya göre değişir

​
Token Tahmini

# Kaba tahmin
def estimate_tokens(text):
    return len(text) / 4  # İngilizce için yaklaşık

# Gerçek sayı (OpenAI modelleri için)
import tiktoken
encoder = tiktoken.encoding_for_model("gpt-4o")
tokens = encoder.encode("Metniniz buraya")
print(f"Token sayısı: {len(tokens)}")

​
Kullanım Takibi

​
Panel

Kullanımınızı Panel üzerinden izleyin:
  • Gerçek zamanlı bakiye
  • Modele göre kullanım geçmişi
  • Maliyet dökümü
  • API anahtarı kullanımı

​
API Yanıtı

Her yanıt kullanım bilgilerini içerir: 
{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

​
Maliyet Optimizasyonu

Basit görevler için daha küçük modeller (GPT-4o-mini, Gemini Flash) kullanın.
Tekrarlanan aynı istekler için yanıtları önbelleğe alın.
Netliği korurken prompt’ları kısa tutun.
Tam yanıtlar gerekmediğinde yanıt uzunluğunu sınırlayın.
Streaming ek maliyet getirmez ancak algılanan performansı artırır.

​
Düşük Bakiye Uyarıları

Bakiyeniz düştüğünde uyarıları yapılandırın:
  1. Panel → Ayarlar → Bildirimler bölümüne gidin
  2. Eşik tutarınızı belirleyin
  3. E-posta bildirimleri alın

​
Kredi Ekleme

​
Ödeme Yöntemleri

  • Stripe (Visa, Mastercard)

​
Adımlar

  1. Panel hesabınıza giriş yapın
  2. Kredi Ekle seçeneğine tıklayın
  3. Tutarı ve ödeme yöntemini seçin
  4. Ödemeyi tamamlayın
Krediler, ödeme onayından sonra anında eklenir.

​
API Anahtarı Limitleri

Bireysel API anahtarları üzerinde harcama limitleri belirleyebilirsiniz:
  1. Panel → API Anahtarları bölümüne gidin
  2. Düzenlemek için bir anahtara tıklayın
  3. Kullanım Limiti belirleyin
Limite ulaşıldığında, o anahtarla yapılan istekler 402 Payment Required hatası döndürecektir.

​
Faturalar

Kurumsal hesaplar için faturalar mevcuttur:
  1. Panel → Faturalandırma bölümüne gidin
  2. İşlem geçmişini görüntüleyin
  3. Faturaları PDF olarak indirin

​
Sorularınız mı var?

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