Ajanlar için TokenLab: Makine Tarafından Okunabilir Modeller, Fiyatlandırma, SDK'lar ve MCP

Belleğinden bir model ID'si seçen bir kodlama ajanı, sonunda artık var olmayan bir modeli seçecek ve bunu ancak bir 404 hatasından veya sürpriz bir faturadan sonra fark edecektir. TokenLab MCP, ajana önce kontrol edebileceği canlı bir katalog sunar; böylece herhangi bir entegrasyon kodu yazmadan önce ID'yi, kabul edilen istek formatını ve fiyatı doğrulayabilir. Sunucuyu başlangıçta kesinlikle salt okunur olarak tanımlamıştık. 2026-10-03 tarihinde gözlemlenen dokümanlar aksini belirtiyor, bu nedenle bu sürüm bunu düzeltmekte ve üzerinde çalışılmış bir akış eklemektedir.

Öne Çıkanlar

• TokenLab MCP sunucusunun üç profili vardır: catalog (API anahtarı gerektirmez), core ve full. Sadece catalog anahtarsızdır.
• Bir anahtar ile model istekleri gönderebilir, medya oluşturabilir, dosyaları yönetebilir ve asenkron görevleri kontrol edebilir. Salt okunur değildir.
• tokenlab.accepted_request_formats, tokenlab.pricing, tokenlab.lifecycle ve tokenlab.deliveryAvailability üzerinden yönlendirme yapın. Öneri sırasını hard-code yapmayın.
• Gemini Files, devam ettirilebilir yüklemeler ve cachedContents hiçbir MCP profilinde yer almaz.
• Bir API anahtarını asla bir isteme veya araç argümanına yapıştırmayın.

TokenLab MCP sunucusu bir kodlama ajanına ne sağlar?

MCP sunucu dokümanlarına (2026-10-03 tarihinde gözlemlenmiştir) göre, TokenLab MCP Server bir istemcinin güncel modelleri ve fiyatları incelemesine, model istekleri göndermesine, medya oluşturmasına, dosyalarla çalışmasına ve asenkron görevleri kontrol etmesine olanak tanır. Dokümanlar bu yetenekleri şu şekilde adlandırır:

• modelleri listeleme ve bir modelin yeteneklerini okuma (list_models, get_model)
• güncel fiyatları okuma veya birkaç modeli karşılaştırma
• Chat Completions, Responses, Anthropic Messages veya Gemini istekleri gönderme
• evaluate_decisions ile yazılı kararları değerlendirme
• görseller oluşturma veya düzenleme; video, müzik, 3D, konuşma, transkripsiyon veya çeviri oluşturma
• OpenAI uyumlu /v1/files API aracılığıyla dosya yükleme ve alma
• embedding oluşturma veya dokümanları yeniden sıralama (rerank)
• desteklenen asenkron görevleri kontrol etme ve iptal etme (yoklama için get_task_status)

Dokümanlar bu sürümde fiyatlandırma veya API genel bakışı için araç isimlerini listelemiyor. Eski taslağımızda get_model_pricing ve get_api_overview isimleri geçiyordu. Bu iki isme güvenmeden önce bağlı istemcinizin araç listesini kontrol edin.

Araç kullanılabilirliği profile göre değişir:

Profil	API anahtarı	İçerik
catalog	Gerekli değil	Model listesi, model detayları, fiyatlar, karşılaştırmalar, API genel bakışı
core	Ücretli çağrılar için gerekli	Yaygın sohbet, karar, medya, ses, dosya, görev, embedding, rerank ve çeviri araçları
full	Ücretli çağrılar için gerekli	core artı ek geliştirici API'leri

Sadece daha iyi model seçimi istiyorsanız catalog ile başlayın. İstemcinin içerik oluşturması veya bir model çağırması gerektiğinde core kullanın.

TokenLab MCP sunucusunu istemcinize yükleyin

Paket, Node.js 18.17 veya daha yenisini ve npx gerektirir. Yerel olarak stdio üzerinden çalışır, bu nedenle global bir kuruluma ihtiyacınız yoktur. Önce aktif yapılandırmanızı yedekleyin ve sadece TokenLab girişini ekleyin. Bu komutlar 2026-10-03 tarihinde gözlemlenen dokümanlardan alınmıştır.

Claude Code:

claude mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=catalog \
  --scope user \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.26

Codex:

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=catalog \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.26

Cursor (~/.cursor/mcp.json veya .cursor/mcp.json):

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.26"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "catalog"
      }
    }
  }
}

VS Code, servers anahtarı ve "type": "stdio" ile .vscode/mcp.json kullanır. Claude Desktop, claude_desktop_config.json içinde Cursor ile aynı yapıyı kullanır. Her ikisini de dokümanlar sayfasından kopyalayın.

Ücretli araçları etkinleştirmek için Console → API keys bölümünde bir anahtar oluşturun ve sunucu ortamında her iki değişkeni de ayarlayın:

{
  "env": {
    "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
    "TOKENLAB_MCP_TOOL_PROFILE": "core"
  }
}

Ardından istemciyi yeniden başlatın ve claude mcp list veya codex mcp list komutunu çalıştırın. Ajandan list_models çağrısı yapmasını isteyin. Boş olmayan bir liste, paketin başladığını ve TokenLab'e ulaştığını doğrular. Eğer gerçek bir anahtar paylaşılan bir dosyaya, günlüğe veya kabuk geçmişine düşerse, onu iptal edin ve yeni bir tane oluşturun.

Bir ajan akışı: keşfet, kontrol et, çağır

Kullandığımız akış şöyledir. Bir Node.js uygulamasına görsel oluşturma özelliği eklemesi istenen bir ajan hayal edin. Aşağıdaki her değer, 2026-10-03 tarihinde gözlemlenen dokümanlardan ve canlı model sayfalarından alınmıştır.

1. Keşfet. MCP aracı veya düz HTTP ile güncel kısa listeyi isteyin:

{ "tool": "list_models", "arguments": { "recommended_for": "image" } }

curl "https://api.tokenlab.sh/v1/models?recommended_for=image"

Geçerli recommended_for değerleri image, video, music, 3d, tts, stt, embedding, rerank ve translation'dır. Ajanın nano-banana-pro seçtiğini varsayalım.

2. Formatları ve fiyatı kontrol et. get_model veya GET /v1/models/nano-banana-pro (canlı model API'si, 2026-10-03 tarihinde gözlemlenmiştir) çağrısı yapın. Şunları bildirir:

• kabul edilen istek formatları: gemini_generate_content, bu da /v1beta/models/{model}:generateContent ile eşleşir
• yetenekler: image-edit, image-to-image, text-to-image
• fiyat: 0.067 USD per_request, 0.067 ile 0.12 arasında bir fiyat aralığı ile (fiyatlandırma 2026-10-02T16:53:30.068Z tarihinde güncellenmiştir)

Chat Completions varsayan bir ajan yanlış kodu yazmış olurdu. gpt-image-2'yi (canlı model API'si) karşılaştırın. Hiçbir kabul edilen istek formatı listelemez ve 1M token başına 3.5 USD giriş ve 21 USD çıkış olarak token fiyatlıdır. Fiyat yapısı modele göre değişir, bu nedenle ajan bunu her model için ayrı ayrı okumalıdır.

3. Çağrıyı yap. Bir sohbet modeli için format kontrolü uç noktayı belirler. gpt-5.6-terra, openai_chat_completions ve openai_responses kabul eder (canlı model API'si, 2026-10-03 tarihinde gözlemlenmiştir), bu nedenle standart SDK çalışır:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "Reply only with OK."}],
)
print(response.choices[0].message.content)

Seçilen model ID'sini açıkça gönderin. Dokümanlar, TokenLab'in bunu sessizce değiştirmediğini belirtir. İstemci, fiyat veya model seçimi henüz onaylanmadıysa ücretli bir çağrıdan önce onay istemelidir.

Bir maliyet tahmini için gpt-5.6-terra, 272K giriş tokenine kadar 1M giriş tokeni başına 0.6 USD ücret alır. 10.000 tokenlik bir istem, giriş için yaklaşık 10.000 / 1.000.000 × 0.6 = 0.006 USD tutar (tahmini, çıkış öncesi). 272K giriş tokeninin üzerinde, tüm istek 1.2 USD giriş ve 5.4 USD çıkış ile daha yüksek kademeye geçer.

Bir ajanın yönlendirme için güvenmesi gereken model API alanları

Bunları GET /v1/models/{model} (Get a Model, 2026-10-03 tarihinde gözlemlenmiştir) üzerinden okuyun:

Alan	Yönlendirme için ne anlama gelir
tokenlab.accepted_request_formats	Hangi uç nokta ailesinin kullanılacağı: openai_chat_completions, /v1/chat/completions'dır, openai_responses, /v1/responses'dır, anthropic_messages, /v1/messages'dır
tokenlab.pricing / pricing_unit	Güncel halka açık fiyat ve per_token veya per_image gibi faturalandırma birimi
tokenlab.max_input_tokens, max_output_tokens	Bağlam ve çıkış sınırları. gpt-5.6-terra için: 1.050.000 ve 128.000
tokenlab.supported_operations	Metinden görsele veya görselden videoya gibi işlemler
tokenlab.lifecycle	Kullanılabilirlik, yayın tarihi, kullanımdan kaldırma tarihi, yedek model
tokenlab.deliveryAvailability	Yapılandırılmış verified ve official destek. Eksik alan bilinmiyor demektir

İki uyarı geçerlidir. Birincisi, kabul edilen bir format uç noktayı doğrular ancak bireysel araçlar ve alanlar modele göre değişebilir. İkincisi, deliveryAvailability gerçek zamanlı bir garanti değil, yapılandırılmış destektir. recommended_for sonuçlarını bir kısa liste olarak değerlendirin, çünkü dokümanlar sıralamalarını sabitlememeniz gerektiğini belirtir.

Sadece fiyatlar için GET /v1/models/{model}/pricing, sadece fiyatlandırma uç noktasıdır. Karmaşık girişler kademeler içerebilir. Örneğin seedance-2.0, 1M token başına 2.04 ile 6.545 USD arasında çözünürlüğe ve video girişine bağlı çıkış fiyatlarına sahiptir (canlı model API'si, 2026-10-03 tarihinde gözlemlenmiştir).

Kurtarmaya rehberlik eden hata alanları

OpenAI uyumlu Chat Completions ve Responses hatalarında, hata kılavuzu (2026-10-03 tarihinde gözlemlenmiştir) isteğe bağlı did_you_mean, suggestions, hint, retryable ve retry_after alanlarını listeler. Önce HTTP durumunu ve code değerini ele alın. Bir 400 model_not_found hatası did_you_mean içerebilir. Modelleri sessizce değiştirmek yerine bunu kullanıcıya gösterin. Bir 503 all_channels_failed hatası retryable: false içerebilir ve tekrarlamak yardımcı olmaz. Anthropic Messages ve Gemini kendi yerel hata formatlarını korur.

MCP sunucusunun yapmadıkları

Dokümanlar şu sınırları belirtir:

• İstemcinizin ana model sağlayıcısını değiştirmez. O istemcinin kendi kurulum kılavuzunu kullanın.
• Gemini Files, devam ettirilebilir yüklemeler veya cachedContents konularını kapsamaz. Bunlar Gemini Files and cache uyarınca HTTP çağrıları gerektirir.
• Skill değildir. TokenLab Skill, npx skills add ile talimatları yükler ve hiçbir MCP sunucusu başlatmaz.
• Zaman aşımında sizin için yoklama yapmaz. Bir durum kontrolü zaman aşımına uğrarsa, ikinci bir görev oluşturmayın.
• Kararları kendi başına güvenilir kılmaz. evaluate_decisions'dan gelen bir Noul cevabı bir olasılıktır, Boolean değildir. Kendi etiketli vakalarınıza göre doğrulayın.

catalog profili ücretli çağrılar yapamaz. Görsel araçları, modele bağlı olarak ya bir sonuç ya da bir görev döndürür. Video, müzik ve 3D her zaman görev döndürür.

Hala düz HTTP yüzeylerine ihtiyaç duyduğunuz yerler

İş hattımızda, MCP olmayan ajanlar için HTTP keşif uç noktalarını MCP ile birlikte tuttuk. https://api.tokenlab.sh/llms.txt, ilk istek, yaygın uç noktalar ve hata rehberliği içeren kompakt bir genel bakıştır. 2026-10-03 tarihinde gözlemlenen dokümanlar, llms-full.txt dosyasını veya önceki taslağımızdaki model-data anlık görüntü dosyalarını kapsamaz. Onlara güvenmeden önce bu URL'leri kendiniz doğrulayın. Canlı durum ve maliyetler için halka açık Models catalog bölümüne bakın.

SSS

TokenLab MCP sunucusunu kullanmak için API anahtarına ihtiyacım var mı?

Hayır, göz atmak için değil. catalog profili anahtar olmadan modelleri, detayları, fiyatları ve karşılaştırmaları listeler. Ücretli model veya medya istekleri, core veya full profili ile sunucu ortamında TOKENLAB_API_KEY gerektirir.

Hangi MCP profili ile başlamalıyım?

Sadece daha iyi model seçimi istiyorsanız catalog ile başlayın. İstemcinin modelleri çağırması veya medya oluşturması gerektiğinde core profiline geçin. full profilini sadece ajan gerçekten ekstra geliştirici API'lerine ihtiyaç duyuyorsa kullanın.

Bir ajan model seçerken hangi model alanlarına güvenmelidir?

Uç nokta için accepted_request_formats, maliyet için birimiyle birlikte pricing, token sınırları, supported_operations ve lifecycle alanlarına güvenin. deliveryAvailability alanını canlı kullanılabilirlik olarak değil, yapılandırılmış destek olarak değerlendirin.

Ajanım neden 503 all_channels_failed hatası aldı?

İşlem, seçilen Delivery kademesinde hiçbir kaynağa sahip olmayabilir. retryable değeri false olduğunda isteği tekrarlamayın. GET /v1/models ile kullanılabilirliği kontrol edin ve kullanıcının onayıyla başka bir model seçin.

MCP sunucusu Gemini Files veya cachedContents destekliyor mu?

Hayır. Dokümanlar, Gemini Files, devam ettirilebilir yüklemeler ve cachedContents özelliklerinin şu anda HTTP çağrıları gerektirdiğini belirtiyor. MCP dosya araçları, OpenAI uyumlu /v1/files API'sini kullanır.

Console → API keys bölümünde bir anahtar oluşturun, ardından yukarıdaki komutlarla catalog profilini istemcinize ekleyin.