Taşıma Kılavuzları

TokenLab çoklu format yapısına sahiptir: OpenAI uyumlu istemcileri, Anthropic’e özgü Messages çağrılarını, Gemini’ye özgü REST çağrılarını ve medya uç noktalarını doğal biçimlerinde tutabilirsiniz. En güvenli taşıma yöntemi, her iş yükünü tek bir evrensel formata dönüştürmemekten geçer. Uygulamanızın ihtiyaç duyduğu davranışı sağlayan rotayı seçin.

Rota Eşleme

Mevcut iş yükü	TokenLab temel URL	Birincil uç nokta	Taşıma notu
OpenAI Chat Completions	`https://api.tokenlab.sh/v1`	`/chat/completions`	OpenAI uyumlu sohbet ve fonksiyon çağırma için en küçük değişiklik
OpenAI Responses	`https://api.tokenlab.sh/v1`	`/responses`	Uygulamanız Responses’a özgü girdilere, araçlara veya çıktı yönetimine bağlıysa kullanın
Anthropic SDK	`https://api.tokenlab.sh`	`/v1/messages`	SDK temel URL’sine `/v1` eklemeyin
Gemini REST	`https://api.tokenlab.sh`	`/v1beta/models/:model:generateContent`	Gemini’ye özgü alanları Gemini rotasında tutun
Medya üretimi	`https://api.tokenlab.sh/v1`	`/images`, `/videos`, `/music`, `/3d`	Modelleri `recommended_for` ile keşfedin ve belgelendiği yerlerde asenkron yoklamayı (polling) bekleyin
Yönetim ve faturalandırma	`https://api.tokenlab.sh/v1`	`/management/...`	Sunucu tarafı kullanım ve fatura mutabakatı için yönetim token’larını kullanın

Hızlı Taşıma Reçeteleri

OpenAI’dan TokenLab’e

Sadece SDK base_url / baseURL değerini https://api.tokenlab.sh/v1 olarak değiştirin, geçişi kolaylaştıracaksa mevcut OpenAI API anahtarı ortam değişkeni adınızı koruyun ve GET /v1/models kontrolünden sonra model kimliklerini (ID) güncelleyin.

OpenRouter’dan TokenLab’e

Uygulamanızın daha önce OpenRouter’ın OpenAI uyumlu temel URL’sini kullandığı yerlerde https://api.tokenlab.sh/v1 kullanın. Sağlayıcı ön eki olan model kimliklerini kaldırın ve /v1/models üzerinden TokenLab genel model kimliklerini kullanın; bir iş yükü Claude Messages veya Gemini generateContent gerektirdiğinde, bunu OpenAI uyumlu sohbet üzerinden zorlamak yerine yerel TokenLab uç noktasına taşıyın.

LiteLLM’den TokenLab’e

LiteLLM’in custom_openai/<model> rotasını api_base: https://api.tokenlab.sh/v1 ile kullanın. LiteLLM takma adlarını gerçek TokenLab model kimliklerinden ayrı tutun, böylece uygulama istemlerini (prompt) değiştirmeden yönlendirme politikasını değiştirebilirsiniz.

TokenLab Üzerinden Claude Messages

Anthropic SDK istemcilerini https://api.tokenlab.sh adresine yönlendirin ve messages.create çağrısı yapın. SDK temel URL’sine /v1 eklemeyin; SDK, /v1/messages yolunu kendisi yönetir.

TokenLab Üzerinden Gemini Native

Gemini yüklerini https://api.tokenlab.sh/v1beta/models/{model}:generateContent üzerinde tutun. Uygulamanız Gemini davranışına bağlıysa, Gemini’ye özgü contents, parts, dosyalar, önbelleğe alınmış içerikler, fonksiyon tanımları ve yerleşik araçlar bu rotada kalmalıdır.

OpenAI Uyumlu Taşıma

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello from TokenLab"}],
)

Mevcut yeniden deneme (retry), zaman aşımı ve akış (streaming) kodunuzu koruyun, ancak üretim trafiğinden önce model kimliklerini GET /v1/models ile doğrulayın. Görüntü üretimi için model parametresini açıkça gönderin ve görüntü modelleri sohbet modellerinden daha fazla farklılık gösterdiği için görüntü kılavuzunu okuyun.

Anthropic Taşıma

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain TokenLab in one sentence."}],
)

Claude’a özgü araç kullanımı, düşünme akışları ve Anthropic mesaj semantiği için /v1/messages kullanın. Kasıtlı olarak OpenAI uyumlu bir davranış değişikliği istemediğiniz sürece, Anthropic’e özgü alanları Chat Completions üzerinden çevirmeyin.

Gemini Taşıma

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-your-tokenlab-key" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'

Uygulamanız Gemini’ye özgü davranışlara bağlıysa, Gemini yerleşik araçlarını, File API referanslarını, önbelleğe alınmış içerikleri, fonksiyon tanımlarını ve yerel içerik parçalarını /v1beta üzerinde tutun.

Medya Taşıma

GET /v1/models?recommended_for=image|video|music|3d sorgusunu yapın.
Liste yanıtlarındaki GET /v1/models verilerini ve mümkünse tam GET /v1/models/{model} verilerini okuyun.
Özellikle görüntü uç noktaları için açık bir model gönderin.
Asenkron işler için task_id, poll_url, uç nokta, model ve kendi iş kimliğinizi (job ID) saklayın.
Maliyetleri sağlayıcı görev kimlikleri ile değil, kullanım kayıtları ve billing_transaction_id ile mutabık kalın.

Medya iş yükleri kendi geçiş planlarına ihtiyaç duyar çünkü gecikme, yeniden denemeler ve nihai varlıklar sohbet tamamlamalarından farklı davranır.

Üretim Ortamı Geçiş Planı

Aşama	Hedef	Kontroller
1. Envanter	Uç noktaları, modelleri, istek alanlarını, akış/asenkron davranışını ve fatura sahibini listeleyin	Sağlayıcıya özel gizli alanların genel olduğu varsayılmamalıdır
2. Tek rota pilotu	Bir uç noktayı ve bir model ailesini taşıyın	Yanıt şekli, maliyet ve günlükler beklentilerle eşleşiyor mu
3. Gölge veya örnekleme	Seçilen çıktıları önceki sağlayıcıyla karşılaştırın	Kullanıcı tarafından görülen kalite ve gecikme kabul edilebilir mi
4. Kademeli geçiş	Trafiği anahtara, organizasyona veya özellik bayrağına (feature flag) göre artırın	`4xx`, `5xx`, gecikme, denge ve yinelenen asenkron işleri izleyin
5. Temizlik	Eski sağlayıcı yolunu ancak kararlı kullanımdan sonra kaldırın	Geri alma yolu ve destek kılavuzu belgelenmiştir

Taşıma Tuzakları

Uygulamanız yerel Anthropic, Gemini veya Responses davranışı gerektiriyorsa, her modeli tek bir OpenAI Chat Completions yolunun arkasına koymayın.
Eski görüntü varsayımlarını baz almayın. model parametresini açıkça gönderin.
Bir görevin zaten oluşturulup oluşturulmadığını kontrol etmeden asenkron oluşturma isteklerini yeniden denemeyin.
Günlüklerinizde veya kullanıcı arayüzünüzde sağlayıcıya özgü tanımlayıcıları ifşa etmeyin.
Faturalandırmayı sağlayıcı görev kimlikleri ile karşılaştırmayın. TokenLab kullanım kayıtlarını kullanın.

API Referansı

Konu	Referans
Çoklu Format API	Multi-Format API
OpenAI SDK	OpenAI SDK
Anthropic SDK	Anthropic SDK
Gemini Native	Gemini Native API
Görüntü Üretimi	Görüntü Üretimi
Asenkron İşler ve Yoklama	Asenkron İşler & Anket

Başlarken

Temel kılavuzlar

Medya kılavuzları

Taşıma Kılavuzları

Rota Eşleme

Hızlı Taşıma Reçeteleri

OpenAI’dan TokenLab’e

OpenRouter’dan TokenLab’e

LiteLLM’den TokenLab’e

TokenLab Üzerinden Claude Messages

TokenLab Üzerinden Gemini Native

OpenAI Uyumlu Taşıma

Anthropic Taşıma

Gemini Taşıma

Medya Taşıma

Üretim Ortamı Geçiş Planı

Taşıma Tuzakları

API Referansı

​Rota Eşleme

​Hızlı Taşıma Reçeteleri

​OpenAI’dan TokenLab’e

​OpenRouter’dan TokenLab’e

​LiteLLM’den TokenLab’e

​TokenLab Üzerinden Claude Messages

​TokenLab Üzerinden Gemini Native

​OpenAI Uyumlu Taşıma

​Anthropic Taşıma

​Gemini Taşıma

​Medya Taşıma

​Üretim Ortamı Geçiş Planı

​Taşıma Tuzakları

​API Referansı

Rota Eşleme

Hızlı Taşıma Reçeteleri

OpenAI’dan TokenLab’e

OpenRouter’dan TokenLab’e

LiteLLM’den TokenLab’e

TokenLab Üzerinden Claude Messages

TokenLab Üzerinden Gemini Native

OpenAI Uyumlu Taşıma

Anthropic Taşıma

Gemini Taşıma

Medya Taşıma

Üretim Ortamı Geçiş Planı

Taşıma Tuzakları

API Referansı