Genel Bakış
TokenLab tek bir API anahtarıyla dört protokol yüzeyi sunar: Chat Completions, Responses, Anthropic Messages ve yerel Gemini. Yerel giriş yalnızca model bu biçimi yayımladığında ve aynı protokolde bir upstream rota bulunduğunda kullanılabilir; yerel girişler Chat Completions’a geri dönmez. Başka bir protokole tek yönlü derlenebilen tek giriş Chat’tir.OpenAI Biçimi
/v1/chat/completions
Standart biçim, en geniş uyumlulukResponses
/v1/responses
Yerel Responses yaşam döngüsü ve olaylarıAnthropic Biçimi
/v1/messages
Genişletilmiş düşünme, yerel Claude özellikleriGemini Biçimi
/v1beta/models/:model:generateContent
Google ekosistemi entegrasyonuNeden Çoklu-Format?
Biçim Karşılaştırması
OpenAI Biçimi
Mevcut OpenAI SDK entegrasyonları ve taşınabilir sohbet veya embedding akışları için bu uyumluluk yolunu kullanın. Claude veya Gemini yerel davranışı için aşağıdaki Anthropic veya Gemini biçimini kullanın.- Genel kullanım
- Mevcut OpenAI SDK entegrasyonları
- Azami uyumluluk
Anthropic Biçimi
Yerel Anthropic Messages API’si. Genişletilmiş düşünme gibi Claude’a özgü özellikler için gereklidir.Genişletilmiş Düşünme (Claude Opus 4.6)
Sadece Anthropic biçiminde kullanılabilir:- Claude’a özgü özellikler
- Genişletilmiş düşünme modu
- Yerel Anthropic SDK kullanıcıları
Gemini Biçimi
Google ekosistemi entegrasyonu için yerel Google Gemini API biçimi.Akış
- Google Cloud entegrasyonları
- Mevcut Gemini SDK kodu
- Yerel Gemini özellikleri
/upload/v1beta/files, /v1beta/files, /v1beta/files:register ve /v1beta/cachedContents uç noktalarını destekler. Files, Gemini File API uyumlu upstream kanallarını kullanır; açık Cache kaynakları Vertex AI kanalları üzerinden de yönlendirilebilir. TokenLab üzerinden oluşturulan kaynaklar sonraki generateContent çağrıları için aynı upstream kanal/key ile bağlı kalır.
Araç Uyumluluğu Sınırı
Fonksiyon araçları yalnızca Chat girişinden tek yönlü derlenebilir ve hedefin tam araç döngüsünü temsil etmesi gerekir. Sağlayıcıya özgü yerel araçlar kendi yerel rotasında kalmalıdır:- OpenAI Responses barındırılan ve yerel araçları, örneğin
tool_search,web_search,file_search,code_interpreter, MCP, shell/apply_patch ve computer-use araçları için/v1/responsesgerekir. - Anthropic server/native araçları, örneğin
web_search_*,web_fetch_*,code_execution_*,tool_search_*, bash, computer-use ve text-editor araçları için/v1/messagesgerekir. - Gemini yerleşik araçları, örneğin
googleSearch,codeExecution,urlContext,computerUseve benzertoolsalanları için/v1betagerekir.
Doğru Biçimi Seçme
Geçiş Kılavuzları
OpenAI Resmi API’sından
Anthropic Resmi API’sından
Google AI Studio’dan
Taşınabilir Chat Uyumluluğu
Tek bir istemcinin farklı upstream protokolleriyle sunulan modellere erişmesi gerektiğinde/v1/chat/completions kullanın. Taşınabilir bir Chat isteği bütünüyle temsil edilebildiğinde Responses, Messages veya Gemini’ye tek yönlü derlenebilir. Yerel Responses, Messages ve Gemini istekleri Chat’e dönüştürülmez; model veya sağlayıcı adı yerel kullanılabilirlik anlamına gelmez.
Responses ve Gemini Sınırları
Mevcut Responses yüzeyi oluşturma, sıkıştırma, alma, silme ve SSE’yi kapsar. Background yalnızca HTTP üzerinden çalışır. WebSocket yalnızcaresponse.create kabul eder; streaming örtüktür ve bu transport üzerinde background ile response.cancel sunulmaz. Silme, iptal etme değildir.
Gemini’de ProtoJSON lowerCamelCase ve özgün proto snake_case adlarının ikisi de resmidir ve karma isteklerde de korunur. Mevcut yüzey model list/get, generateContent, streamGenerateContent, countTokens, embedContent ve batchEmbedContents işlemlerini kapsar; Interactions ve Live kapsam dışıdır. Bilinmeyen alanlar best-effort iletilir ve desteğe upstream karar verir.