API Referansı

Genel Bakış

TokenLab, yerel öncelikli ve OpenAI ile uyumludur. Yerel davranış gerektiğinde Anthropic için POST /v1/messages ve Gemini için /v1beta/models/...:generateContent gibi sağlayıcıya özgü yerel rotaları kullanın; mevcut OpenAI tarzı SDK'ları veya araçları taşırken ise OpenAI uyumlu /v1 uç noktalarını kullanın. POST /v1/responses ise Responses'a özgü davranış için gelişmiş isteğe bağlı bir yol olmaya devam eder.

Temel URL

https://api.tokenlab.sh

Kimlik Doğrulama

Model istekleri TokenLab API anahtarı kullanır. Standart kimlik doğrulama başlığı şöyledir:

Authorization: Bearer sk-your-api-key

GET /v1/models, GET /v1/models/{model} ve GET /v1/pricing herkese açıktır ve anahtar gerektirmez. Anthropic Messages ayrıca x-api-key, Gemini ise Bearer dışında x-goog-api-key veya ?key= kabul eder. /v1/management/* bir yönetim tokenı (mt-...) gerektirir.

API anahtarınızı Kontrol Paneli üzerinden alın.

Üretim istekleri X-TokenLab-Delivery-Policy: auto | verified | official kabul eder. Başlık, API anahtarı ayarından; anahtar ayarı da çalışma alanı varsayılanından önceliklidir. auto önce TokenLab Verified, gerektiğinde Official kullanır; ücret, isteği tamamlayan yönteme göre belirlenir. verified TokenLab fiyatlarını, official üreticinin açık fiyatlarını esas alır; geçerli ücret TokenLab’da gösterilendir. Realtime anahtar veya çalışma alanı ayarını kullanır, sorgu ile değiştirilemez. Geçersiz başlık 400, kullanılamayan yöntem ise 503 delivery_tier_unavailable ve istek kimliği döndürür.

Etkileşimli Playground Hakkında: Bu dokümantasyon sitesindeki playground yalnızca gösterim amaçlıdır ve API anahtarı girilmesine izin vermez. API'yi test etmek için lütfen:

cURL - Örnek komutları kopyalayın ve sk-your-api-key yerine gerçek anahtarınızı koyun
Postman - OpenAPI spesifikasyonumuzu içe aktarın
SDK - base URL olarak bizim URL'imizi kullanarak OpenAI/Anthropic SDK'sını kullanın

Desteklenen Uç Noktalar

Sohbet & Metin Üretimi

Uç Nokta	Yöntem	Açıklama
`/v1/chat/completions`	POST	OpenAI uyumlu sohbet tamamlamaları
`/v1/messages`	POST	Anthropic uyumlu mesajlar API'si
`/v1/responses`	POST	OpenAI Responses API

Embeddings & Yeniden Sıralama

Uç Nokta	Yöntem	Açıklama
`/v1/embeddings`	POST	Metin embedding'leri oluşturma
`/v1/rerank`	POST	Dokümanları yeniden sıralama

Görseller

Uç Nokta	Yöntem	Açıklama
`/v1/images/generations`	POST	Metinden görsel oluşturma
`/v1/images/edits`	POST	Görselleri düzenleme
`/v1/images/generations/{id}`	GET	Görev tabanlı görsel yanıtlar için görsel görev durumu yolu

Görsel modeller tamamlanmış bir görsel veya asenkron görev döndürebilir. Yanıtta poll_url varsa görevi sorgulamak için bu URL’yi kullanın.

Ses

Uç Nokta	Yöntem	Açıklama
`/v1/audio/speech`	POST	Metinden sese (TTS)
`/v1/audio/transcriptions`	POST	Konuşmadan metne (STT)

Gerçek zamanlı

Endpoint	Yöntem	Açıklama
`/v1/realtime?model={model}`	WS	Gerçek zamanlı WebSocket oturumları

/v1/realtime WebSocket upgrade istekleri için kullanılır. Normal GET /v1/realtime, WebSocket rotalarını doğrudan inceleyemeyen istemciler için endpoint metadata döndürür. Bu OpenAI Realtime REST yüzeyi değildir; client secret, translation client secret, Calls ve legacy beta session endpoint'leri şu anda sunulmaz.

Video

Uç Nokta	Yöntem	Açıklama
`/v1/videos/generations`	POST	Video üretim görevi oluşturma
`/v1/tasks/{id}`	GET	Video işleri için asenkron görev durumu alma
`/v1/videos/generations/{id}`	GET	Eski uyumluluğa uygun video görev durumu yolu

Yeni istemciler için, create yanıtları tarafından döndürülen poll_url'u takip etmeyi tercih edin. /v1/videos/generations/{id} yolunu yalnızca geriye dönük uyumluluk için tutun.

Asenkron Görevler

Uç Nokta	Yöntem	Açıklama
`/v1/tasks/{id}`	GET	Birleştirilmiş asenkron görev durumu uç noktası. Döndürülen `poll_url` izlenirken önerilir

Bu uç nokta yalnızca video, müzik ve 3B ile sınırlı değildir. Bazı görsel görevleri de resmi sorgulama yolu olarak /v1/tasks/{id} kullanabilir.

Müzik

Uç Nokta	Yöntem	Açıklama
`/v1/music/generations`	POST	Müzik üretim görevi oluşturma
`/v1/music/generations/{id}`	GET	Müzik'e özgü durum yolu

Yeni istemciler için öncelikle döndürülen poll_url'u tercih edin. Sabit bir görev-durum uç noktasına ihtiyacınız varsa /v1/tasks/{id} kullanın; müzik'e özgü uyumluluk yolları için /v1/music/generations/{id}'i koruyun.

3B Üretimi

Uç Nokta	Yöntem	Açıklama
`/v1/3d/generations`	POST	3B model üretim görevi oluşturma
`/v1/3d/generations/{id}`	GET	3B'ye özgü durum yolu

Yeni istemciler için öncelikle döndürülen poll_url'u tercih edin. Sabit bir görev-durum uç noktasına ihtiyacınız varsa /v1/tasks/{id} kullanın; 3B'ye özgü uyumluluk yolları için /v1/3d/generations/{id}'i koruyun.

Modeller

Uç Nokta	Yöntem	Açıklama
`/v1/models`	GET	Mevcut tüm modelleri listele
`/v1/models/{model}`	GET	Belirli model bilgilerini al

Gemini (v1beta)

Yerel Google Gemini API formatı desteği:

Uç Nokta	Yöntem	Açıklama
`/v1beta/models/{model}:generateContent`	POST	İçerik oluşturma (Gemini formatı)
`/v1beta/models/{model}:streamGenerateContent`	POST	Akışlı içerik oluşturma (Gemini formatı)

Gemini uç noktaları, standart Bearer token'a ek olarak ?key= sorgu parametresi ile kimlik doğrulamayı da destekler.

Yanıt Formatı

Her uç nokta kendi API biçimini korur. Aşağıdaki başarı ve hata örnekleri Chat Completions biçimindedir.

Başarılı Yanıt

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-5.6-terra",
  "choices": [{"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

Yönlendirme Şeffaflığı

TokenLab, herkese açık yanıt gövdelerinde sağlayıcı, kanal, ilke veya kimlik bilgisi ayrıntılarını göstermez. _routing veya diğer dahili yönlendirme alanlarına herkese açık API sözleşmesinin bir parçası olarak güvenmeyin.

Hata ayıklama ve destek için, mevcut olduklarında herkese açık yanıt başlıklarını kullanın:

Başlık	Açıklama
`X-Routing-Time-MS`	Rota seçimi süresi, mevcutsa
`X-Request-ID`	Destek ve hata ayıklama için istek tanımlayıcısı, mevcutsa
`X-Task-ID`	Görev tabanlı yanıtlar için herkese açık asenkron görev tanımlayıcısı, mevcutsa
`X-Billing-Transaction-ID`	Nihai faturalandırmadan sonra faturalandırma işlem tanımlayıcısı, mevcutsa

Hata Yanıtı

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

Hız Sınırları

Hız sınırları role dayalıdır ve yöneticiler tarafından yapılandırılabilir. Varsayılan değerler:

Rol	İstek/dakika
Kullanıcı	1,000
Ortak	10,000
VIP	10,000

Özel hız sınırları için destek ile iletişime geçin. Kesin değerler hesap yapılandırmasına göre değişebilir.

Hız sınırları aşıldığında, API beklemeniz gereken süreyi belirten bir Retry-After başlığı ile birlikte 429 durum kodu döndürür.

OpenAPI Spesifikasyonu

Tam OpenAPI 3.1 spesifikasyonunu indir

API Referansı

Genel BakışCopy Anchor Link

Temel URLCopy Anchor Link

Kimlik DoğrulamaCopy Anchor Link

Desteklenen Uç NoktalarCopy Anchor Link

Sohbet & Metin ÜretimiCopy Anchor Link

Embeddings & Yeniden SıralamaCopy Anchor Link

GörsellerCopy Anchor Link

SesCopy Anchor Link

Gerçek zamanlıCopy Anchor Link

VideoCopy Anchor Link

Asenkron GörevlerCopy Anchor Link

MüzikCopy Anchor Link

3B ÜretimiCopy Anchor Link

ModellerCopy Anchor Link

Gemini (v1beta)Copy Anchor Link

Yanıt FormatıCopy Anchor Link

Başarılı YanıtCopy Anchor Link

Yönlendirme ŞeffaflığıCopy Anchor Link

Hata YanıtıCopy Anchor Link

Hız SınırlarıCopy Anchor Link

OpenAPI SpesifikasyonuCopy Anchor Link

OpenAPI Spesifikasyonu

Bu sayfada

Genel Bakış

Temel URL

Kimlik Doğrulama

Desteklenen Uç Noktalar

Sohbet & Metin Üretimi

Embeddings & Yeniden Sıralama

Görseller

Ses

Gerçek zamanlı

Video

Asenkron Görevler

Müzik

3B Üretimi

Modeller

Gemini (v1beta)

Yanıt Formatı

Başarılı Yanıt

Yönlendirme Şeffaflığı

Hata Yanıtı

Hız Sınırları

OpenAPI Spesifikasyonu