Temel kılavuzlar

Geçiş Kılavuzları

Mevcut OpenAI, Anthropic, Gemini ve medya istemcilerinizi TokenLab'e taşıyın

Uygulamanızın halihazırda kullandığı istek formatını koruyun. OpenAI uyumlu istemciler, Anthropic Messages, Gemini REST ve medya uç noktalarının her birinin eşleşen bir TokenLab API adresi vardır.

API eşlemesi

Mevcut APITokenLab temel URL'siUç NoktaDikkat Edilmesi Gerekenler
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completionsOpenAI uyumlu sohbet ve fonksiyon çağırma için en küçük değişiklik
OpenAI Responseshttps://api.tokenlab.sh/v1/responsesUygulamanız Responses'a özgü girdilere, araçlara veya çıktı işleme süreçlerine bağımlıysa kullanın
Anthropic SDKhttps://api.tokenlab.sh/v1/messagesSDK temel URL'sine /v1 eklemeyin
Gemini RESThttps://api.tokenlab.sh/v1beta/models/:model:generateContentGemini'ye özgü alanları Gemini rotasında tutun
Medya üretimihttps://api.tokenlab.sh/v1/images/generations, /videos/generations, /music/generations, /3d/generationsModelleri recommended_for ile keşfedin ve belgelendiği yerlerde asenkron yoklamayı (polling) bekleyin
Yönetim ve faturalandırmahttps://api.tokenlab.sh/v1/management/...Sunucu tarafı çağrılar model API anahtarı değil, yönetim token'ı kullanır

Hızlı Geçiş Reçeteleri

OpenAI'dan TokenLab'e

SDK base_url / baseURL değerini https://api.tokenlab.sh/v1 olarak değiştirin, API anahtarını yenileyin ve GET /v1/models üzerinden bir model kimliği seçin.

OpenRouter'dan TokenLab'e

OpenRouter temel URL'sini https://api.tokenlab.sh/v1 ile değiştirin. TokenLab model kimlikleri OpenRouter sağlayıcı öneki içermez. Anthropic Messages veya Gemini'yi yalnızca uygulamanızın bu formatlardaki alanlara ihtiyacı olduğunda kullanın.

LiteLLM'den TokenLab'e

LiteLLM'in custom_openai/<model> yapılandırmasını api_base: https://api.tokenlab.sh/v1 ile kullanın. LiteLLM takma adınızı TokenLab model kimliğinden ayrı tutun, böylece uygulama istemlerini düzenlemeden her ikisi de değiştirilebilir.

TokenLab ile 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 ile Gemini Native

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

OpenAI Uyumlu Geçiş

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) kodunuz genellikle aynı kalabilir. Model kimliğini GET /v1/models ile doğrulayın. Görsel istekleri mutlaka bir model içermelidir; modele özgü girdiler için görsel kılavuzuna bakın.

Anthropic Geçişi

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 araç çağrıları, düşünme blokları ve Anthropic mesaj alanları için /v1/messages kullanın. Chat Completions bu alanları garanti etmez.

Gemini Geçişi

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-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ğımlıysa, Gemini yerleşik araçlarını, File API referanslarını, önbelleğe alınmış içerikleri, fonksiyon bildirimlerini ve yerel içerik parçalarını /v1beta üzerinde tutun.

Medya Geçişi

  1. GET /v1/models?recommended_for=image|video|music|3d sorgusunu yapın.
  2. GET /v1/models üzerinden model listesini ve GET /v1/models/{model} üzerinden tüm detayları okuyun.
  3. Özellikle görsel 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. Bunları GET /v1/tasks/{id} ile yoklayın.
  5. Maliyetleri sağlayıcı iş kimlikleri ile değil, kullanım kayıtları ve billing_transaction_id ile mutabık kılın.

Medya üretimi asenkron olarak tamamlanabilir, bu nedenle mevcut bir entegrasyonu değiştirmeden önce task_id ve poll_url değerlerini kaydedin. Bir oluşturma isteği zaman aşımı, ikinci bir kullanıcı işi oluşturmamalıdır.

Geçişte Dikkat Edilmesi Gerekenler

  • Uygulamanız yerel Anthropic, Gemini veya Responses davranışlarına ihtiyaç duyuyorsa, her modeli bir OpenAI Chat Completions yolunun arkasına koymayın.
  • Eski görsel varsayımlarını baz almayın. model bilgisini açıkça gönderin.
  • Bir görevin zaten oluşturulup oluşturulmadığını kontrol etmeden asenkron oluşturma isteklerini yeniden denemeyin.
  • Ürününüzde TokenLab görev kimliklerini ve kullanım kayıtlarını kullanın. Üçüncü taraf görev kimlikleri faturalandırma tanımlayıcıları değildir.

API Referansı

KonuReferans
Çoklu Format APIÇoklu Format API
OpenAI SDKOpenAI SDK
Anthropic SDKAnthropic SDK
Gemini NativeGemini Native API
Görsel ÜretimiGörsel Üretimi
Asenkron İşler ve YoklamaAsenkron İşler ve Yoklama

Bu sayfada