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şlemeCopy Anchor Link

Hızlı Taşıma ReçeteleriCopy Anchor Link

OpenAI'dan TokenLab'eCopy Anchor Link

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'eCopy Anchor Link

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'eCopy Anchor Link

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 MessagesCopy Anchor Link

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 NativeCopy Anchor Link

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şımaCopy Anchor Link

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.6-terra",
    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şımaCopy Anchor Link

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-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Reply with: Connected to TokenLab."}],
)

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şımaCopy Anchor Link

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şımaCopy Anchor Link

1. GET /v1/models?recommended_for=image|video|music|3d sorgusunu yapın.
2. Liste yanıtlarındaki GET /v1/models verilerini ve mümkünse tam GET /v1/models/{model} verilerini okuyun.
3. Özellikle görüntü uç noktaları için açık bir model gönderin.
4. Asenkron işler için task_id, poll_url, uç nokta, model ve kendi iş kimliğinizi (job ID) saklayın.
5. 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ıCopy Anchor Link

Taşıma TuzaklarıCopy Anchor Link

• 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ıCopy Anchor Link