Skip to main content

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ş uyumluluk

Responses

/v1/responses Yerel Responses yaşam döngüsü ve olayları

Anthropic Biçimi

/v1/messages Genişletilmiş düşünme, yerel Claude özellikleri

Gemini Biçimi

/v1beta/models/:model:generateContent Google ekosistemi entegrasyonu

Neden Ç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.
En iyi kullanım alanları:
  • 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:
En iyi kullanım alanları:
  • 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ış

En iyi kullanım alanları:
  • Google Cloud entegrasyonları
  • Mevcut Gemini SDK kodu
  • Yerel Gemini özellikleri
Gemini Files ve Cache: Yerel Gemini rotası /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/responses gerekir.
  • 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/messages gerekir.
  • Gemini yerleşik araçları, örneğin googleSearch, codeExecution, urlContext, computerUse ve benzer tools alanları için /v1beta gerekir.
TokenLab yerel protokol isteklerini Chat Completions’a düşürmez. Bilinmeyen alanlar ve araç kombinasyonları best-effort olarak iletilir; desteğe seçilen upstream karar verir.

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ızca response.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.