Ana içeriğe atla
TokenLab çok formatlıdır: OpenAI uyumlu istemcileri, Anthropic yerel Messages çağrılarını, Gemini yerel REST çağrılarını ve medya uç noktalarını doğal şekillerinde tutabilirsiniz. En güvenli göç, her iş yükünü tek bir evrensel formata çevirmemektir. Uygulamanızın ihtiyaç duyduğu davranışı sahiplenen rotayı seçin.

Rota Haritalama

Mevcut iş yüküTokenLab temel URL’siBirincil uç noktaGöç notu
OpenAI Sohbet Tamamlamalarıhttps://api.tokenlab.sh/v1/chat/completionsOpenAI uyumlu sohbet ve fonksiyon çağrıları için en küçük değişiklik
OpenAI Yanıtlarıhttps://api.tokenlab.sh/v1/responsesUygulamanız Yanıtlar’a özel girdi, araçlar veya çıktı işleme 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 rotasında Gemini yerel alanlarını koruyun
Medya üretimihttps://api.tokenlab.sh/v1/images, /videos, /music, /3drecommended_for ile modelleri keşfedin ve belgelenmiş yerlerde asenkron anket bekleyin
Yönetim ve faturalamahttps://api.tokenlab.sh/v1/management/...Sunucu tarafı kullanımı ve faturalama uzlaştırması için yönetim token’larını kullanın

OpenAI Uyumlu Göç

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, zaman aşımı ve akış kodunuzu koruyun, ancak üretim trafiğinden önce model kimliklerini GET /v1/models ile doğrulayın. Görüntü üretimi için model’i açıkça gönderin ve görüntü kılavuzunu okuyun çünkü görüntü modelleri sohbet modellerinden daha fazla farklılık gösterir.

Anthropic Göç

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 yerel araç kullanımı, düşünme akışları ve Anthropic mesaj anlamları için /v1/messages kullanın. Anthropic’a özel alanları Sohbet Tamamlamaları aracılığıyla çevirmeyin, aksi takdirde OpenAI uyumlu bir davranış değişikliği istemiyorsanız.

Gemini Göç

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 yerel davranışa bağımlı olduğunda Gemini yerleşik araçlarını, Dosya API referanslarını, önbelleğe alınmış içerikleri, fonksiyon bildirimlerini ve yerel içerik parçalarını /v1beta üzerinde tutun.

Medya Göçü

  1. GET /v1/models?recommended_for=image|video|music|3d sorgulayın.
  2. Liste yanıtlarında tokenlab.public_contract_summary ve mevcut olduğunda tam tokenlab.public_contract’ı 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ş ID’nizi saklayın.
  5. Maliyetleri kullanım kayıtları ve billing_transaction_id aracılığıyla uzlaştırın, sağlayıcı görev kimliklerini kullanmayın.
Medya iş yükleri, gecikme, yeniden denemeler ve nihai varlıkların sohbet tamamlamalarından farklı davrandığı için kendi dağıtım planına ihtiyaç duyar.

Üretim Dağıtım Planı

AşamaHedefKontroller
1. EnvanterUç noktaları, modelleri, istek alanlarını, akış/asenkron davranışları ve faturalama sahibini listeleyinGizli sağlayıcıya özel alanların kamuya açık olduğu varsayılmamalıdır
2. Tek rota pilotuBir uç noktayı ve bir model ailesini taşıyınYanıt şekli, maliyet ve günlükler beklentilerle eşleşiyor
3. Gölgeleme veya örneklemeSeçilen çıktıları önceki sağlayıcı ile karşılaştırınKullanıcı görünür kalitesi ve gecikmesi kabul edilebilir
4. Aşamalı dağıtımTrafiği anahtar, organizasyon veya özellik bayrağı ile artırın4xx, 5xx, gecikme, denge ve yinelenen asenkron işleri izleyin
5. TemizlikEski sağlayıcı yolunu yalnızca kararlı kullanım sonrası kaldırınGeri alma yolu ve destek kılavuzu belgelenmiştir

Göç Tuzakları

  • Uygulamanız yerel Anthropic, Gemini veya Yanıtlar davranışına ihtiyaç duyuyorsa her modeli tek bir OpenAI Sohbet Tamamlamaları yolunun arkasına koymayın.
  • Eski görüntü varsayımlarını varsaymayın. model’i açıkça gönderin.
  • Bir görev zaten oluşturulmuşsa asenkron oluşturma isteklerini yeniden denemeyin.
  • Sağlayıcı yönlendirme meta verilerini günlüklerinizde veya kullanıcı arayüzünüzde açığa çıkarmayın.
  • Faturalamayı sağlayıcı görev kimlikleri ile karşılaştırmayın. TokenLab kullanım kayıtlarını kullanın.

API Referansı

KonuReferans
Çok Formatlı APIÇok Formatlı API
OpenAI SDKOpenAI SDK
Anthropic SDKAnthropic SDK
Gemini YerelGemini Yerel API
Görüntü ÜretimiGörüntü Üretimi
Asenkron İşler & AnketAsenkron İşler & Anket