✨ TokenLab API Entegrasyon Skill’i

Bu 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/v1 kullanır ve native Anthropic veya Gemini route’larına ne zaman geçileceğini açıklar.
Eskimiş listelerden tahmin etmek yerine /v1/models, /llms.txt ve recommended_for kı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_request gibi 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 -y

Bu 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ışı

Kullanıcının istediği dil ve API ailesiyle eşleşen en küçük çalışan örnekle başlayın.
Model seçimi açıksa bir modeli hard-code etmeden önce /v1/models veya https://api.tokenlab.sh/llms.txt çağırın.
Non-chat işlerde /v1/models?recommended_for=<scene> çağırın; <scene> image, video, music, 3d, tts, stt, embedding, rerank veya translation olabilir.
Başarısız non-chat isteği değiştirmeden önce /v1/models/:model okuyun ve supported_operations, supported_parameters, request_endpoint, request_endpoint_by_operation, request_shape_mode, recommended_request ile hizalayın.
API Agent-First hata döndürürse isteği yapılandırılmış alanlarla düzeltin ve yalnızca hata retryable ise yeniden deneyin.

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-4o-mini",
    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.py

Model 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 sk-KEY"
curl "https://api.tokenlab.sh/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Sıralı non-chat kısa listeleri
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer sk-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 sk-KEY"

# Yalnızca fiyat ayrıntısı
curl "https://api.tokenlab.sh/v1/models/gpt-image-2/pricing" -H "Authorization: Bearer sk-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:

Hata	Yararlı alanlar	Agent eylemi
Yanlış model adı	`did_you_mean`, `suggestions`, `hint`	Düzeltilmiş modelle veya önerilen bir alternatifle yeniden deneyin
Yetersiz bakiye	`balance_usd`, `estimated_cost_usd`, `suggestions`	Onay isteyin veya uygun maliyetli bir modele geçin
Hız sınırı veya geçici kullanılamama	`retryable`, `retry_after`, `alternatives`	Bekleyin, yeniden deneyin veya listelenen bir alternatifi seçin
Sohbet dışı istek uyumsuzluğu	`supported_operations`, `supported_parameters`, `request_endpoint`, `request_endpoint_by_operation`, `request_shape_mode`, `recommended_request`	İsteği model ayrıntılarına göre yeniden oluşturun ve amacı değiştiren alanlar için açık bir hata döndürün

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

Skill otomatik tetiklenmiyor mu?

İstekte “TokenLab” veya “TokenLab API” ifadesini kullanın. Örnek: Node.js uygulamama görsel üretimi eklemek için TokenLab kullan.

Hangi coding agent’lar destekleniyor?

Ortak skill veya rules dizinlerini destekleyen her coding agent bu klasörü kullanabilir. skills installer desteklenen agent’ları otomatik işler.

Skill nasıl güncellenir?

Kurulum komutunu yeniden çalıştırın. Yerel kopyayı kanonik public repository’den yeniler.

npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

Kaynaklar

Agent-First API

Yapılandırılmış hata ipuçları ve toparlama davranışı

API dokümantasyonu

Endpoint özelinde kurulum ve API Reference

Modeller

Kullanılabilir modelleri inceleyin

llms.txt

Agents için makine tarafından okunabilir API özeti

Sorular için GitHub Issues kullanın veya support@tokenlab.sh ile iletişime geçin.

Başlarken

Temel kılavuzlar

Medya kılavuzları

✨ TokenLab API Entegrasyon Skill’i

Skill ne yapar

Kurulum

Mevcut kurulumları güncelleme

Kurulumu doğrulama

API Key alma

Önerilen Agent iş akışı

Minimum chat örneği

Model keşfi ve model details’lar

Native protokol seçimi

Agent-First hata toparlama

Desteklenen API aileleri

En iyi uygulamalar

API Key güvenliği

Non-chat için önce contract

En küçük çalışır örnek

Yapılandırılmış ipuçlarını kullan

FAQ

Kaynaklar

Agent-First API

API dokümantasyonu

Modeller

llms.txt

​Skill ne yapar

​Kurulum

​Mevcut kurulumları güncelleme

​Kurulumu doğrulama

​API Key alma

​Önerilen Agent iş akışı

​Minimum chat örneği

​Model keşfi ve model details’lar

​Native protokol seçimi

​Agent-First hata toparlama

​Desteklenen API aileleri

​En iyi uygulamalar

API Key güvenliği

Non-chat için önce contract

En küçük çalışır örnek

Yapılandırılmış ipuçlarını kullan

​FAQ

​Kaynaklar

Agent-First API

API dokümantasyonu

Modeller

llms.txt

Skill ne yapar

Kurulum

Mevcut kurulumları güncelleme

Kurulumu doğrulama

API Key alma

Önerilen Agent iş akışı

Minimum chat örneği

Model keşfi ve model details’lar

Native protokol seçimi

Agent-First hata toparlama

Desteklenen API aileleri

En iyi uygulamalar

FAQ

Kaynaklar