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

Tüm API uç noktaları Bearer token kullanılarak kimlik doğrulaması gerektirir:

Authorization: Bearer sk-your-api-key

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

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

Bazı görsel modeller sonuçları doğrudan döndürebilir, bazıları görev tabanlı yanıtlar verebilir ve bazıları yönlendirilen sağlayıcı yoluna bağlı olarak her iki şekilde davranabilir. Create yanıtı poll_url içeriyorsa, tam olarak onu izleyin.

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ı

Tüm yanıtlar tutarlı bir format izler:

Başarılı Yanıt

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

Yönlendirme Şeffaflığı

Tüm yanıtlar kanal bilgilerini içeren bir _routing alanı içerir:

{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai"
    },
    "cached": false,
    "retryCount": 0
  }
}

Alan	Açıklama
`channel.id`	Kullanılan kanal tanımlayıcısı
`channel.provider`	Üst akış sağlayıcısı (openai, anthropic, vb.)
`cached`	Yanıtın önbellekten servis edilip edilmediği
`retryCount`	Yeniden deneme sayısı (varsa)

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.0 spesifikasyonunu indir

Temel

Metin

Dosyalar ve toplu işler

Görseller

Ses ve gerçek zamanlı

Müzik

Video ve materyaller

Worlds

3D

Asenkron işler

Gemini yerel

Yönetim

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

OpenAPI Spesifikasyonu

​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

OpenAPI Spesifikasyonu

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