> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Faturalandırma ve Fiyatlandırma

> TokenLab'nın kullandıkça öde fiyatlandırmasını anlayın

## 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](/api-reference/pricing/get-pricing) 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     | Örnekler                                           | Güncel fiyatı doğrula                |
| ---------------- | -------------------------------------------------- | ------------------------------------ |
| Chat / Responses | `gpt-5.4`, `claude-sonnet-4-6`, `gemini-3.5-flash` | 模型页或 Pricing API                     |
| 嵌入 / rerank      | `text-embedding-3-small`, `qwen3-vl-rerank`        | 模型价格详情                               |
| 按 token 计费的图像    | `gpt-image-2`                                      | `GET /v1/models/gpt-image-2/pricing` |

<Note>
  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.
</Note>

### İ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`                  |
| 3D   | `tripo-h3.1`                  |
| 音频   | `tts-1`, `whisper-1`          |

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

<Note>
  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.
</Note>

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](mailto:support@tokenlab.sh) adresiyle iletişime geçin.

```python theme={null}
# Ö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

```python theme={null}
# 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](https://tokenlab.sh/dashboard) ü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:

```json theme={null}
{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}
```

## Maliyet Optimizasyonu

<AccordionGroup>
  <Accordion title="Uygun modelleri kullanın">
    Basit görevler için daha küçük modeller (GPT-4o-mini, Gemini Flash) kullanın.
  </Accordion>

  <Accordion title="Önbelleğe almayı uygulayın">
    Tekrarlanan aynı istekler için yanıtları önbelleğe alın.
  </Accordion>

  <Accordion title="Prompt'ları optimize edin">
    Netliği korurken prompt'ları kısa tutun.
  </Accordion>

  <Accordion title="max_tokens değerini ayarlayın">
    Tam yanıtlar gerekmediğinde yanıt uzunluğunu sınırlayın.
  </Accordion>

  <Accordion title="Uzun yanıtlar için streaming kullanın">
    Streaming ek maliyet getirmez ancak algılanan performansı artırır.
  </Accordion>
</AccordionGroup>

## 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](https://tokenlab.sh/dashboard) 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](mailto:support@tokenlab.sh) ile iletişime geçin.