Temel

API Referansı

Uç noktalar, kimlik doğrulama, yanıt başlıkları ve hatalar

Genel Bakış

TokenLab, OpenAI uyumlu uç noktaların yanı sıra Anthropic ve Gemini istek formatlarını da destekler. Mevcut OpenAI istemcileri /v1 yolunu kullanabilir; başka bir formatı yalnızca uygulamanızın o API'ye özgü bir davranışa ihtiyaç duyması durumunda seçin. POST /v1/responses isteğe bağlıdır ve model desteğine bağlıdır.

Temel URL

https://api.tokenlab.sh

Kimlik Doğrulama

Model istekleri bir 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}, GET /v1/models/{model}/pricing ve GET /v1/pricing herkese açıktır ve anahtar gerektirmez. Anthropic Messages ayrıca x-api-key kabul eder; Gemini ise Bearer kimlik doğrulamasının yanı sıra x-goog-api-key veya ?key= parametrelerini de kabul eder. /v1/management/* uç noktaları bir yönetim belirteci (mt-...) gerektirir.

API anahtarınızı Konsol üzerinden alabilirsiniz.

Teslimat politikası

Üretim istekleri X-TokenLab-Delivery-Policy: auto | verified | official başlığını kabul eder. İstek başlığı, API anahtarı ayarını geçersiz kılar; bu da Çalışma Alanı (Workspace) varsayılanını geçersiz kılar.

  • Auto, mevcut olduğunda TokenLab Verified'ı, gerekirse Official'ı kullanır. İsteğinizi tamamlayan seçenek için ödeme yaparsınız.
  • TokenLab Verified, TokenLab tarafından doğrulanmış teslimattır. Verified fiyatı uygulanır.
  • Official, model üreticisinin yayınladığı fiyat olan Official fiyatı üzerinden faturalandırılır.
  • Gerçek zamanlı oturumlar API anahtarını veya Çalışma Alanı ayarını kullanır ve istek geçersiz kılmayı kabul etmez.

Geçersiz bir başlık 400 hatası döndürür. İstenen seçenek mevcut değilse, TokenLab 503 delivery_tier_unavailable hatası ve bir istek kimliği döndürür. retryable değerini okuyun: seçilen işlemin arzı yoksa bu değer false olur. Aynı isteği değiştirmeden tekrarlamayın.

İstek formu içeren API sayfaları, TokenLab API anahtarınızı kabul eder ve gerçek istekler gönderir. Bu istekler hesap bakiyenizi ve limitlerinizi kullanır. Ayrıca cURL, Postman veya bir SDK da kullanabilirsiniz.

Desteklenen Uç Noktalar

Sohbet & Metin Üretimi

Uç NoktaMetotAçıklama
/v1/chat/completionsPOSTOpenAI uyumlu sohbet tamamlama
/v1/messagesPOSTAnthropic uyumlu Mesajlar
/v1/messages/count_tokensPOSTBir Mesaj isteğinin girdi tokenlarını sayma
/v1/messages/batchesPOST, GETMesaj Grupları oluşturma ve listeleme
/v1/messages/batches/{message_batch_id}GET, DELETEMesaj Grubu alma veya silme
/v1/messages/batches/{message_batch_id}/resultsGETSonuçları okuma
/v1/messages/batches/{message_batch_id}/cancelPOSTMesaj Grubunu iptal etme
/v1/responsesPOSTOpenAI Yanıtlar API'si
/v1/responses/{id}GET, DELETEDepolanan bir yanıtı alma veya silme
/v1/responses/compactPOSTYanıtlar konuşmasının bağlamını sıkıştırma
/v1/translationsPOSTMetinden metne çeviri

Gömme (Embeddings) & Yeniden Sıralama (Rerank)

Uç NoktaMetotAçıklama
/v1/embeddingsPOSTMetin gömmeleri oluşturma
/v1/multimodal/embeddingsPOSTÇok modlu bir gömme modeliyle gömmeler oluşturma
/v1/rerankPOSTBelgeleri yeniden sıralama

Kararlar

Uç NoktaMetotAçıklama
/v1/systemonePOSTTürlendirilmiş karar sorularını değerlendirme

Dosyalar & Gruplar

Uç NoktaMetotAçıklama
/v1/filesPOST, GETDosya yükleme ve listeleme
/v1/files/{file_id}GET, DELETEDosya alma veya silme
/v1/files/{file_id}/contentGETDosya içeriğini indirme
/v1/batchesPOST, GETGruplar oluşturma ve listeleme
/v1/batches/{batch_id}GETGrup alma
/v1/batches/{batch_id}/cancelPOSTGrup iptal etme

Görseller

Uç NoktaMetotAçıklama
/v1/images/generationsPOSTMetinden görsel oluşturma
/v1/images/editsPOSTGörsel düzenleme
/v1/images/variationsPOSTGörsel varyasyonları oluşturma
/v1/images/generations/{id}GETGörev tabanlı görsel yanıtları için uyumluluk durum yolu

Görsel modelleri tamamlanmış bir görsel veya eşzamansız bir görev döndürebilir. Yanıt status: "pending" veya bir görev kimliği içeriyorsa, GET /v1/tasks/{id} uç noktasını sorgulayın.

Ses

Uç NoktaMetotAçıklama
/v1/audio/speechPOSTMetinden sese (TTS)
/v1/audio/transcriptionsPOSTSesten metne (STT)
/v1/audio/translationsPOSTKonuşmayı İngilizce metne çevirme

Gerçek Zamanlı

Uç NoktaMetotAçıklama
/v1/realtime?model={model}WSGerçek zamanlı WebSocket oturumları

WebSocket yükseltmeleri için /v1/realtime kullanın. Düz bir GET /v1/realtime uç nokta meta verilerini döndürür. Bu, OpenAI Realtime REST yüzeyi değildir; client-secret, Calls ve eski beta oturum uç noktaları mevcut değildir.

Video

Uç NoktaMetotAçıklama
/v1/videos/generationsPOSTVideo oluşturma görevi oluşturma
/v1/videos/generations/{id}GETUyumluluk durum yolu
/v1/videos/assetsPOST, GETSeedance materyal varlıkları oluşturma ve listeleme
/api/v3/contents/generations/tasksPOST, GETVolcengine istek formatıyla Seedance görevleri

Görev id'si ile GET /v1/tasks/{id} uç noktasını sorgulayın. /v1/videos/generations/{id} mevcut entegrasyonlar için kullanılabilir durumdadır.

Eşzamansız Görevler

Uç NoktaMetotAçıklama
/v1/tasks/{id}GETHerhangi bir eşzamansız görev için durum
/v1/tasks/{id}DELETEEşzamansız görevi iptal etme

Görseller, video, müzik, 3D, Worlds ve eşzamansız ses transkripsiyonu gibi her eşzamansız görev için GET /v1/tasks/{id} uç noktasını sorgulayın. Oluşturma yanıtındaki id veya task_id değerini kullanın. Bir Worlds oluşturma yanıtı /v1/worlds/generations/{id} altında bir poll_url döndürür; oradaki /v1/tasks/{id} adresini de sorgulayın. Bu sayfadaki mod bazlı durum yolları, mevcut entegrasyonlar için uyumluluk uç noktalarıdır.

Müzik

Uç NoktaMetotAçıklama
/v1/music/generationsPOSTMüzik oluşturma görevi oluşturma
/v1/music/generations/{id}GETUyumluluk durum yolu

3D Oluşturma

Uç NoktaMetotAçıklama
/v1/3d/generationsPOST3D model oluşturma görevi oluşturma
/v1/3d/generations/{id}GETUyumluluk durum yolu

Worlds

Uç NoktaMetotAçıklama
/v1/worlds/generationsPOSTDünya oluşturma görevi oluşturma
/v1/worlds/listPOSTDünyaları listeleme
/v1/worlds/{id}GET, DELETEDünya alma veya silme
/v1/worlds/media-assets/prepare-uploadPOSTMedya varlığı yüklemesi hazırlama

Modeller & Fiyatlandırma

Uç NoktaMetotAçıklama
/v1/modelsGETTüm mevcut modelleri listeleme
/v1/models/{model}GETBelirli model bilgisini alma
/v1/models/{model}/pricingGETBir modelin fiyatlarını alma
/v1/pricingGETModel fiyatlarını listeleme

Gemini (v1beta)

Yerel Google Gemini API format desteği:

Uç NoktaMetotAçıklama
/v1beta/modelsGETGemini isteklerini kabul eden modelleri listeleme
/v1beta/models/{model}GETModel alma
/v1beta/models/{model}:generateContentPOSTİçerik oluşturma
/v1beta/models/{model}:streamGenerateContentPOSTAkışlı içerik oluşturma
/v1beta/models/{model}:countTokensPOSTToken sayma
/v1beta/files, /v1beta/cachedContentsPOST, GET, DELETEGemini Dosyaları ve önbelleğe alınmış içerik

Gemini uç noktaları, standart Bearer belirtecinin yanı sıra ?key= sorgu parametresi kimlik doğrulamasını da destekler.

Yönetim

/v1/management/* uç noktaları, bir yönetim belirteci ile bakiye, API anahtarları ve web kancalarını yönetir. Yönetim API'sine bakın.

Yanıt Formatı

Her uç nokta kendi API formatını korur. Aşağıdaki başarı ve hata örnekleri Sohbet Tamamlama formatını kullanır.

Başarı 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
  }
}

Yanıt başlıkları

Bu başlıklar mevcut olduğunda kullanın.

BaşlıkAçıklama
X-Request-IDDestek ve hata ayıklama için istek tanımlayıcısı
X-Routing-Time-MSAkışsız: yukarı akış yanıtı gelene kadar geçen toplam süre (milisaniye; yukarı akıştaki sıraya alma ve çıkarım dahil). Akışlı: her zaman 0. Yönlendirme veya kuyruk ölçümü değildir.
X-Task-IDGörev tabanlı yanıtlar için genel eşzamansız görev tanımlayıcısı
X-Billing-Transaction-IDNihai faturalandırmadan sonra fatura işlem tanımlayıcısı

Resmi istek reddetmeleri, hizmetin bildirdiği hata ve genel hizmet adı ile birlikte upstream içerebilir. API hatalarını yönetme bölümüne bakın.

Hata Yanıtı

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

Hız Limitleri

Limitler hesap katmanına bağlıdır ve API anahtarı başına uygulanır. Bir 429 yanıtı Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıklarını taşır. Katmanlar ve nasıl yeniden deneneceği hakkında bilgi için Hız limitleri bölümüne bakın.

OpenAPI Spesifikasyonu

OpenAPI Spesifikasyonu

Tam OpenAPI 3.1 spesifikasyonunu indirin

Bu sayfada