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 API | TokenLab temel URL'si | Uç Nokta | Dikkat Edilmesi Gerekenler |
|---|---|---|---|
| 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ı işleme süreçlerine bağımlı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/generations, /videos/generations, /music/generations, /3d/generations | 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ı ç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
GET /v1/models?recommended_for=image|video|music|3dsorgusunu yapın.GET /v1/modelsüzerinden model listesini veGET /v1/models/{model}üzerinden tüm detayları okuyun.- Özellikle görsel uç noktaları için açık bir
modelgönderin. - 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. - Maliyetleri sağlayıcı iş kimlikleri ile değil, kullanım kayıtları ve
billing_transaction_idile 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.
modelbilgisini 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ı
| Konu | Referans |
|---|---|
| Çoklu Format API | Çoklu Format API |
| OpenAI SDK | OpenAI SDK |
| Anthropic SDK | Anthropic SDK |
| Gemini Native | Gemini Native API |
| Görsel Üretimi | Görsel Üretimi |
| Asenkron İşler ve Yoklama | Asenkron İşler ve Yoklama |