TokenLab Teslimat Kademesi Seçimi: Auto, Verified veya Official

Bir model kimliği tamamen geçerli olsa bile bir istek 503 hatasıyla başarısız olabilir; bunun nedeni genellikle sabitlediğiniz teslimat katmanıdır. İş hattımızda, bir modele sunmadığı bir seçeneği zorla uyguladığımızda bu durumla karşılaştık. Bu kılavuz, üç teslimat katmanı seçeneğini, ayarların uygulanma sırasını ve her birinin faturanız için ne anlama geldiğini açıklamaktadır. Aşağıdaki tüm bilgiler, 03.10.2026 tarihinde gözlemlenen TokenLab dokümantasyonundan ve canlı model API'sinden alınmıştır.

Önemli Çıkarımlar

• Bir teslimat katmanı üç değere sahiptir: auto, verified ve official.
• İstek başlığı (header), API anahtarı ayarını geçersiz kılar; bu da Workspace varsayılanını geçersiz kılar.
• İstenen seçeneğin arzı yoksa, 503 delivery_tier_unavailable hatası alırsınız. retryable değeri false olduğunda, aynı isteği tekrar göndermeyin.
• Yalnızca isteği tamamlayan seçenek için bir kez ödeme yaparsınız.
• Bir katmanı sabitlemeden önce GET /v1/models/{model} komutunu kontrol edin. Bu herkese açıktır ve anahtar gerektirmez.

Üç teslimat katmanı seçeneği

API referansı (03.10.2026 tarihinde gözlemlenmiştir) üç seçenek tanımlar:

• Auto, uygun olduğunda TokenLab Verified'ı, gerekirse Official'ı kullanır. İsteğinizi tamamlayan seçenek için ödeme yaparsınız.
• TokenLab Verified, TokenLab tarafından doğrulanmış teslimattır. TokenLab fiyatları geçerlidir.
• Official, model üreticisinin halka açık fiyatını temel alır. TokenLab'de gösterilen fiyat, ödeyeceğiniz fiyattır.

Üretim (generation) istekleri X-TokenLab-Delivery-Policy: auto | verified | official başlığını kabul eder. Geçersiz bir başlık değeri 400 hatası döndürür.

Hangi ayar önce uygulanır?

Teslimat katmanını üç yer belirleyebilir. Belgelenen sıra şöyledir:

1. İstek başlığı.
2. API anahtarı ayarı.
3. Workspace varsayılanı.

Başlık anahtarı, anahtar ise Workspace'i geçersiz kılar. Realtime oturumlar istisnadır: bunlar API anahtarı veya Workspace ayarını kullanır ve sorgu dizesi (query-string) geçersiz kılmasını kabul etmez.

Bir istekte teslimat katmanını ayarlama

Aşağıda, Official teslimatı sabitleyen bir Chat Completions çağrısı bulunmaktadır. claude-sonnet-5 model kimliği, canlı model API'sinde her iki seçenek de mevcut olacak şekilde listelenmiştir. Model sayfasına bakın.

curl https://api.tokenlab.sh/v1/chat/completions \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-TokenLab-Delivery-Policy: official" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Aynı başlık Anthropic Messages uç noktasında da çalışır. /v1/messages için anahtar başlığı, API referansına göre Anthropic Messages'ın kabul ettiği x-api-key olabilir.

curl https://api.tokenlab.sh/v1/messages \
  -H "x-api-key: $TOKENLAB_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -H "X-TokenLab-Delivery-Policy: verified" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Bir API anahtarında teslimat katmanını ayarlama

Bir teslimat katmanını tek bir anahtar için varsayılan yapmak istiyorsanız, bir yönetim anahtarı (mt-...) ile Management API'sini kullanın. Create API Key ve Update API Key sayfaları (her ikisi de 03.10.2026 tarihinde gözlemlenmiştir), bir deliveryPolicy alanını belgeler. Değerleri auto, verified, official veya null olabilir. null değeri, Workspace politikasını miras alır.

Bu taslak, belgelenen PATCH biçimini izler. Anahtar kimliği, dokümanlardaki örnek değerdir.

curl -X PATCH "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryPolicy": "verified"
  }'

Güncelleme en az bir alan gerektirir, bu nedenle bu gövde kendi başına geçerlidir. Yanıtlar ayarı delivery_policy olarak bildirir; burada null, anahtarın Workspace varsayılanını miras aldığı anlamına gelir. Oluşturma uç noktası, istek gövdesinde aynı deliveryPolicy alanını kabul eder. Oluşturma sırasında bunu atlamak, belgelenen null mirasıyla tutarlıdır, çünkü oluşturma örneği yanıtı delivery_policy: null değerini gösterir.

İstenen seçenek mevcut olmadığında

İstediğiniz seçeneğin arzı yoksa, TokenLab 503 delivery_tier_unavailable hatası ve bir istek kimliği döndürür. Hata işleme kılavuzu (03.10.2026 tarihinde gözlemlenmiştir), retryable değerinin nasıl okunacağını açıklar.

5xx durumu her zaman geçici bir kesinti anlamına gelmez. Seçilen işlemin o katmanda arzı olmadığında, retryable değeri false olur ve retry_after atlanır. Aynı isteği değiştirmeden tekrarlamayın. Bunun yerine:

1. İnsan tarafından okunabilir message kısmını değil, code ve retryable değerlerini okuyun.
2. İstek Kimliğini (Request ID) yanıt başlıklarından kaydedin.
3. Başka bir model veya katman seçmeden önce GET /v1/models ile modelin teslimat uygunluğunu kontrol edin.

Kılavuz, benzer model isimlerinin uygunluğu kanıtlamadığı konusunda uyarır. Bir istemci code değerine göre dallanmalı ve 5xx hatasını yalnızca retryable değeri true olduğunda, retry_after değerine saygı duyarak ve deneme sayısını sınırlayarak yeniden denemelidir.

Bir modelin hangi seçeneklere sahip olduğunu kontrol etme

Model uç noktası delivery availability by option (seçeneğe göre teslimat uygunluğu) bildirir. Bu değerler 03.10.2026 tarihinde gözlemlenen canlı model API'sinden alınmıştır:

Model ID	Verified	Official	Model sayfası
claude-sonnet-5	true	true	/models/claude-5/claude-sonnet-5
gpt-5.6-terra	true	true	/models/gpt-5-6/gpt-5.6-terra
deepseek-v4-flash	false	true	/models/deepseek-v4/deepseek-v4-flash

Örneğin, deepseek-v4-flash üzerinde verified sabitlemek, API bugün Verified arzı bildirmediği için delivery_tier_unavailable hatasına yol açacak türden bir istektir. Official ve Auto orada geçerli kalmaya devam eder.

Herhangi bir modeli kendiniz kontrol edin:

curl "https://api.tokenlab.sh/v1/models/deepseek-v4-flash"

Uygunluk her istek çalıştığında kontrol edilir ve Faturalandırma kılavuzu, teslimat etiketlerinin desteklenen seçenekleri tanımladığını belirtir. Model API'sini bir anlık görüntü olarak değerlendirin ve sabit bir katman kodlamadan önce tekrar okuyun.

Seçim ödemenizi nasıl etkiler?

Faturalandırma kılavuzu (03.10.2026 tarihinde gözlemlenmiştir), tamamlanan her isteğin, sonucu üreten seçenek için bir kez ücretlendirildiğini belirtir:

• TokenLab Verified, TokenLab halka açık fiyatlarını kullanır.
• Official, model üreticisinin halka açık fiyatını temel alan Official fiyat katmanını kullanır.
• Auto, isteği hangi seçenek tamamlarsa onun üzerinden ücretlendirir.

Ücretli üretim için Konsol, onaydan önce maksimum bir tahmin gösterir ve Kullanım (Usage) kısmı nihai ücreti gösterir. Kullanılmayan rezerve miktar serbest bırakılır. Modeller sayfasında, TokenLab fiyat sütunundaki bir tire, şu anda hiçbir Verified teklifinin mevcut olmadığı anlamına gelir. Ücretsiz olduğu anlamına gelmez.

Kılavuz, Verified ve Official arasında sabit bir fiyat farkı belgelemez, bu yüzden bir tane olduğunu iddia etmeyeceğiz. claude-sonnet-5 üzerindeki canlı TokenLab fiyatı için model API'si, 1 milyon token başına girişi 0.9 USD ve çıkışı 4.5 USD olarak listeler (fiyatlandırma 02.10.2026 tarihinde güncellenmiştir). Tahmin olarak, 100.000 giriş token'ı artı 10.000 çıkış token'ı 0.09 + 0.045 = 0.135 USD eder. Bu rakam yalnızca listelenen TokenLab fiyatını kullanır. Karşılaştırma yapmadan önce model sayfasındaki Official fiyatı okuyun.

Kısa bir karar kılavuzu

• İsteğin tamamlanmasını istediğinizde ve her iki fiyat katmanını da kabul edebiliyorsanız Auto'yu varsayılan yapın.
• TokenLab fiyatlarına ihtiyacınız olduğunda ve model verified: true bildirdiğinde Verified'ı sabitleyin.
• Model üreticisinin halka açık fiyat temeline ihtiyacınız olduğunda veya modelin Verified arzı olmadığında Official'ı sabitleyin.
• Her zaman aynı katmana ihtiyaç duyan çalışanlar (workers) için anahtar varsayılanını ayarlayın ve tek seferlik istisnalar için başlığı kullanın.

Sabitlemeden önce GET /v1/models/{model} komutunu okuyun. Küçük bir test çalıştırın ve Kullanım (Usage) kısmından ücreti onaylayın.

Sonraki adım: teslimat politikasına sahip bir anahtar oluşturun

Konsol'da bir API anahtarı oluşturun veya bir yönetim anahtarı ile POST /v1/management/api-keys çağrısı yapın ve Create API Key sayfasında açıklandığı gibi gövdede deliveryPolicy değerini ayarlayın. Ardından yukarıdaki başlıklı küçük bir istek gönderin ve Kullanım (Usage) kısmından ücreti kontrol edin.

SSS

Başlık, API anahtarı ve Workspace anlaşmazlığa düşerse hangi ayar kazanır?

İstek başlığı kazanır. API anahtarı ayarı, Workspace varsayılanını geçersiz kılar. Realtime oturumlar başlığı atlar ve anahtar veya Workspace ayarını kullanır.

Neden 503 delivery_tier_unavailable hatası aldım ve tekrar denemeli miyim?

İstediğiniz katmanın o işlem için arzı yok. retryable değerini okuyun: false olduğunda, aynı isteği tekrar göndermeyin. GET /v1/models ile uygunluğu kontrol edin ve katmanı veya modeli değiştirin.

Official, TokenLab Verified'dan daha mı pahalı?

Dokümanlar sabit bir fark belirtmiyor. Verified, TokenLab halka açık fiyatlarını kullanır ve Official, model üreticisinin halka açık fiyat temelini kullanır. Model sayfasında ikisini karşılaştırın ve Kullanım (Usage) kısmından nihai ücreti onaylayın.

Bir modelin hangi teslimat seçeneklerini desteklediğini nasıl görebilirim?

Anahtar gerektirmeyen GET /v1/models/{model} çağrısını yapın. Bugün claude-sonnet-5 ve gpt-5.6-terra Verified ve Official bildirirken, deepseek-v4-flash yalnızca Official bildiriyor.

Realtime oturumlar için bir teslimat seçeneği ayarlayabilir miyim?

Evet, API anahtarı veya Workspace ayarı aracılığıyla. Realtime oturumlar sorgu dizesi (query-string) geçersiz kılmasını kabul etmez.

TokenLab API anahtarınızı Konsol'da oluşturun