Temel kılavuzlar
✨ TokenLab API Entegrasyon Skill’i
Bakımı sürdürülen TokenLab API entegrasyon skill’ini kurun ve coding agent’lara model keşfi, model details okuma ve API hatalarından toparlanma yolunu öğretin.
Bu sayfayı okuyup TokenLab Skill’i mevcut aracıma ekleyin. Önce kurulu sürümü ve etkin yapılandırmayı kontrol edin. Mevcut hesapları, sağlayıcıları, izinleri ve ayarları koruyun. Dosyaları yedekleyip değişiklikleri gösterin. API anahtarını yerel olarak gireceğim; sohbette istemeyin veya göstermeyin. Önce yapılandırmanın yüklendiğini doğrulayın ve ücretli testleri çalıştırmadan önce açıklayın.
https://tokenlab.sh/docs/tr/integrations/coding-agent-skillBu sayfa bakımı sürdürülen ortak tokenlab-api-integration skill’ini açıklar. Kanonik dağıtım hedging8563/tokenlab-skills içindedir; public repository bilinçli olarak yalnızca bu skill’i tutar.
Bu sayfayı skill kurulumu ve agent iş akışı rehberi için kullanın. Endpoint özelindeki kurulumlar için ilgili SDK, client veya API reference sayfasını kullanın.
Skill ne yapar
- TokenLab chat, image, audio, video, translation ve diğer API aileleri için minimum çalıştırılabilir örnekler üretir.
- OpenAI uyumlu client’lar için
https://api.tokenlab.sh/v1kullanır ve native Anthropic veya Gemini route’larına ne zaman geçileceğini açıklar. - Eskimiş listelerden tahmin etmek yerine
/v1/models,/llms.txtverecommended_forkısa listeleriyle modelleri keşfeder. - Non-chat istekleri tekrar denemeden önce modelin model details bilgisini okur; desteklenmeyen alanlar sessizce atılmaz.
did_you_mean,suggestions,retry_after,recommended_requestgibi Agent-First hata ipuçlarını işler.
Kurulum
Kanonik etkileşimsiz kurulum komutunu kullanın:
npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -yBu komut TokenLab skills repository’den ortak tokenlab-api-integration skill’ini kurar.
Aracınız installer desteklemiyorsa repository içindeki skills/tokenlab-api-integration/ klasörünü aracınızın ortak skills veya rules dizinine kopyalayın.
Mevcut kurulumları güncelleme
Skill’i TokenLab repository temizliğinden önce kurduysanız aynı komutu yeniden çalıştırın. Güncel public paket daha küçüktür ve üretilmiş yerel arama script’lerine artık bağlı değildir.
Kurulumu doğrulama
Coding agent’ınıza sorun:
Hangi skills kullanılabilir?tokenlab-api-integration görünüyorsa kurulum başarılıdır.
API Key alma
TokenLab’i ziyaret edin
tokenlab.sh adresine gidin
Giriş yapın
Hesap oluşturun veya giriş yapın
API Key alın
Dashboard → API Keys bölümünü açıp yeni bir key oluşturun
key’i kopyalayın
key sk-... ile başlar. Güvenli saklayın.
API keys değerlerini prompt’lara veya kaynak dosyalara yapıştırmayın. Skill hangi ortam değişkeninin kullanılacağını sormalı ve key’i o değişkenden okuyan kod üretmelidir.
Önerilen Agent iş akışı
Güncel model listesini, ardından seçilen modelin tokenlab.accepted_request_formats ve açık istek alanlarını okuyun. Konuşma ve araç çağrılarında aynı biçimi koruyun; alanlar biçimler arasında otomatik dönüştürülmez. Hata olduğunda seçilmiş modeli veya protokolü kendiliğinizden değiştirmeyin.
Minimum chat örneği
Bu örnek OpenAI Python SDK ile TokenLab base URL kullanı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-luna",
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)Şununla çalıştırın:
pip install openai
export TOKENLAB_API_KEY="sk-your-api-key"
python app.pyModel keşfi ve model details’lar
Eskimiş paket listeleri yerine canlı keşfi tercih edin:
# Makine tarafından okunabilir API özeti
curl https://api.tokenlab.sh/llms.txt
# Modelleri listele
curl "https://api.tokenlab.sh/v1/models" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?category=image" -H "Authorization: Bearer $TOKENLAB_API_KEY"
# Sıralı non-chat kısa listeleri
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer $TOKENLAB_API_KEY"
# Non-chat isteği tekrar denemeden önce tek modelin model details bilgisini oku
curl "https://api.tokenlab.sh/v1/models/gpt-image-2" -H "Authorization: Bearer $TOKENLAB_API_KEY"
# Yalnızca fiyat ayrıntısı
curl "https://api.tokenlab.sh/v1/models/gpt-image-2/pricing" -H "Authorization: Bearer $TOKENLAB_API_KEY"Native protokol seçimi
Yaygın chat, image, embedding, audio ve rerank örnekleri için OpenAI uyumlu /v1 varsayılan yoldur. Native protokol kullanılabilirliğini model ya da sağlayıcı adından veya Chat yanıt başlıklarından çıkarmayın. GET /v1/models/{model} isteğini okuyun ve yalnızca model ayrıntılarında ilan edilen bir istek biçimini kullanın.
Okunacak alan tokenlab.accepted_request_formats değeridir.
Protokol uç noktaları Chat Completions için /v1/chat/completions, Responses için /v1/responses, Messages için /v1/messages ve Gemini için /v1beta/models/{model}:generateContent şeklindedir.
Agent-First hata toparlama
Hatalar, coding agent’ların dokümanı kazımadan ayrıştırabileceği alanlar içerir:
Önce HTTP durumunu ve hata code alanını kullanın. Yanlış ad için did_you_mean yol gösterebilir; kullanıcı seçmeden modeli değiştirmeyin. 429 için Retry-After veya retry_after değerine uyun; yalnızca hata izin verdiğinde ve yeniden deneme açıkça seçildiğinde tekrar deneyin. Doğrulama, kimlik doğrulama, bakiye ve izin hatalarını önce düzeltin. Oluşturma isteği zaman aşımına uğrarsa tekrar göndermeden önce mevcut görevi kontrol edin.
Desteklenen API aileleri
| Aile | Birincil yol |
|---|---|
| Chat ve Responses | /v1/chat/completions, /v1/responses |
| Claude-yerel mesajlar | /v1/messages |
| Gemini-native istekler | /v1beta/models/{model}:generateContent |
| Görseller | /v1/images/generations, /v1/images/edits |
| Video | /v1/videos/generations |
| Müzik | /v1/music/generations |
| Worlds | /v1/worlds/generations ve world status ile media asset endpoint’leri |
| 3D | /v1/3d/generations |
| Ses | /v1/audio/speech, /v1/audio/transcriptions, /v1/audio/translations |
| Realtime | /v1/realtime?model={model} |
| Embeddings ve rerank | /v1/embeddings, /v1/rerank |
| Metin çevirisi | /v1/translations |
En iyi uygulamalar
API Key güvenliği
Ortam değişkenleri ve server-side çağrılar kullanın. Keys değerlerini frontend kodunda asla göstermeyin.
Non-chat için önce contract
Image, video, music, 3D, translation, audio, embedding veya rerank isteklerini tekrar denemeden önce /v1/models?recommended_for=... ve /v1/models/:model okuyun.
En küçük çalışır örnek
Soyutlama, queue veya UI akışı eklemeden önce çalışan tek bir çağrı üretin.
Yapılandırılmış ipuçlarını kullan
Kodu değiştirmeden önce did_you_mean, retry_after, alternatives ve recommended_request alanlarını ayrıştırın.
FAQ
Kaynaklar
API veya hesap sorunlarında uygulama içi Desteği kullanın; önizlemeyi kontrol edip açıkça gönderin. Belirli bir istek için İstekler ve inceleme kılavuzundan başlayın. Skill hatalarını GitHub Issues üzerinden bildirin.