Uyumluluk matrisi
Araç ve SDK uyumluluğu
Kodlama araçları, sohbet uygulamaları, SDK'lar ve çerçeveler için doğru TokenLab kurulumunu bulun
Çoğu araç, bir API anahtarını ve temel URL'yi (base URL) değiştirerek TokenLab'e bağlanır. Tam kurulum, aracın hangi API formatını kullanabildiğine bağlıdır.
| API formatı | Temel URL | Yaygın istemciler |
|---|---|---|
| Chat Completions (OpenAI uyumlu) | https://api.tokenlab.sh/v1 | OpenAI SDK'ları, birçok sohbet uygulaması ve çerçeve |
| OpenAI Responses | https://api.tokenlab.sh/v1 | Responses istemcileri ve Responses olayları etrafında oluşturulmuş araçlar |
| Anthropic Messages | https://api.tokenlab.sh | Anthropic SDK'ları ve Claude odaklı araçlar |
| Gemini | https://api.tokenlab.sh | Özel bir ana bilgisayara (host) izin veren Gemini REST ve SDK istemcileri |
Seçilen model, accepted_request_formats içinde aynı formatı listelemelidir. Akış (streaming) ve araç çağırma (tool calling) işlemleri de modelin yeteneklerine ve istemciye bağlıdır. Örnekler için API formatları bölümüne bakın.
Uyumluluk etiketleri
| Etiket | Anlamı |
|---|---|
| Çalışır | Bağlantılı TokenLab kurulumu, istemcinin belgelenmiş yapılandırma seçeneklerini kullanır |
| Sınırlı çalışır | Yapılandırma belirli özellikler veya kimlik doğrulama modları için geçerlidir; diğer satıcı hizmetleri kendi gereksinimlerini korur |
Bu etiketler, bağlantılı sayfadaki yapılandırmayı tanımlar. Özellik kullanılabilirliği ayrıca seçilen modele ve istemci sürümüne bağlıdır.
Kodlama araçları
| Araç | Durum | API formatı | Notlar |
|---|---|---|---|
| Claude Code | Çalışır | Anthropic Messages | ANTHROPIC_BASE_URL ve bir TokenLab API anahtarı kullanır |
| Codex CLI | Sınırlı çalışır | Responses | Responses kullanır; kullanılabilir özellikler seçilen modele bağlıdır |
| Cursor | Sınırlı çalışır | OpenAI uyumlu | Özel bir API anahtarı ve URL kabul eden Cursor özellikleri için geçerlidir |
| Cline | Çalışır | OpenAI uyumlu | OpenAI Compatible seçeneğini seçin ve bir temel URL ile model kimliği girin |
| Kilo Code | Çalışır | OpenAI uyumlu | Özel bir sağlayıcı ve model kimliği kullanır |
| OpenCode | Çalışır | OpenAI uyumlu | OPENCODE_CONFIG ile ayrı bir sağlayıcı yapılandırması yükleyin |
| OpenHands | Çalışır | OpenAI uyumlu | LiteLLM destekli arayüz: Advanced → Custom Model (openai/ ön eki) ve Base URL |
| Gemini CLI | Sınırlı çalışır | Gemini | API anahtarı kimlik doğrulaması ile GOOGLE_GEMINI_BASE_URL kullanın; ayrı bir GEMINI_CLI_HOME mevcut kurulumu korur |
| Visual Studio Code | Sınırlı çalışır | OpenAI uyumlu | Özel Uç Nokta (Chat Completions) aracılığıyla sohbet; sohbet için Copilot planı gerekmez. Satır içi öneriler ve anlamsal arama hala GitHub gerektirir |
Sohbet uygulamaları
| Uygulama | Durum | Notlar |
|---|---|---|
| Chatbox | Çalışır | Bir OpenAI API Compatible sağlayıcısı ekleyin |
| Cherry Studio | Çalışır | Bir sağlayıcı ekleyin ve Verify and Enable işlemini tamamlayın |
| DeepChat | Çalışır | Chat Completions için OpenAI Completions seçeneğini belirleyin |
| Jan | Çalışır | OpenAI uyumlu bir hizmet ekleyin |
| LibreChat | Çalışır | Özel bir OpenAI uyumlu uç nokta yapılandırın |
| Open WebUI | Çalışır | API Türü Chat olan OpenAI uyumlu bir bağlantı ekleyin |
SDK'lar ve çerçeveler
| İstemci | Durum | Kurulum |
|---|---|---|
| OpenAI SDK | Çalışır | base_url / baseURL değerini https://api.tokenlab.sh/v1 olarak ayarlayın |
| Anthropic SDK | Çalışır | Temel URL'yi https://api.tokenlab.sh olarak ayarlayın |
| Vercel AI SDK | Çalışır | Özel bir OpenAI uyumlu sağlayıcı oluşturun |
| LangChain | Çalışır | ChatOpenAI veya OpenAIEmbeddings öğesini TokenLab URL'si ile yapılandırın |
| LlamaIndex | Çalışır | OpenAI uyumlu istemci seçeneklerini kullanın |
| OpenAI Agents SDK | Sınırlı çalışır | Kılavuz OpenAIChatCompletionsModel kullanır; Responses kullanmadan önce model ve SDK özellik desteğini kontrol edin |
| AutoGen | Çalışır | OpenAI uyumlu bir model istemcisi kullanın |
| CrewAI | Çalışır | OpenAI uyumlu LLM istemcisini yapılandırın |
| PydanticAI | Çalışır | OpenAI uyumlu bir sağlayıcı sağlayın |
Daha fazla çerçeve, gözlemlenebilirlik aracı, ağ geçidi ve değerlendirme ürünü, Entegrasyonlar gezintisinde listelenmiştir.
Akışlı yanıtlarda kullanım
Chat Completions akışları, akış kapanmadan önce nihai bir kullanım parçası ekleyen stream_options: { include_usage: true } seçeneğini kabul eder. Responses API'si include_usage özelliğini açığa çıkarmaz; Responses akışları kullanımı bunun yerine terminal olaylarında raporlar.
Özel bir API anahtarının yerini almadığı durumlar
Bazı ürünler, model çağrılarını ürün satıcısı tarafından barındırılan özelliklerle karıştırır. Bir TokenLab anahtarı, BYOK ayarları aracılığıyla sunulan model isteklerini güçlendirebilir, ancak ilişkisiz aboneliklerin, otomatik tamamlama hizmetlerinin, hesap özelliklerinin veya özel eklentilerin yerini almaz.
Bir araç güncellemesi yapılandırmasını değiştirdiğinde, başka bir yerden eski bir ortam değişkeni parçacığını kopyalamak yerine güncel entegrasyon sayfasını kullanın.
Bir özelliğe güvenmeden önce
- Aracın ihtiyacınız olan format için özel bir temel URL'ye izin verdiğini doğrulayın.
- Modelin bu formatı
accepted_request_formatsiçinde listelediğini doğrulayın. - İş akışınız gerektiriyorsa akış ve araç çağırma işlemlerini test edin.
- API anahtarını güvenilir bir makinede veya sunucuda tutun.
- Bir hata bildirirken İstek Kimliğini (Request ID) kaydedin.