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.shKimlik Doğrulama
Model istekleri bir TokenLab API anahtarı kullanır. Standart kimlik doğrulama başlığı şöyledir:
Authorization: Bearer sk-your-api-keyGET /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ç Nokta | Metot | Açıklama |
|---|---|---|
/v1/chat/completions | POST | OpenAI uyumlu sohbet tamamlama |
/v1/messages | POST | Anthropic uyumlu Mesajlar |
/v1/messages/count_tokens | POST | Bir Mesaj isteğinin girdi tokenlarını sayma |
/v1/messages/batches | POST, GET | Mesaj Grupları oluşturma ve listeleme |
/v1/messages/batches/{message_batch_id} | GET, DELETE | Mesaj Grubu alma veya silme |
/v1/messages/batches/{message_batch_id}/results | GET | Sonuçları okuma |
/v1/messages/batches/{message_batch_id}/cancel | POST | Mesaj Grubunu iptal etme |
/v1/responses | POST | OpenAI Yanıtlar API'si |
/v1/responses/{id} | GET, DELETE | Depolanan bir yanıtı alma veya silme |
/v1/responses/compact | POST | Yanıtlar konuşmasının bağlamını sıkıştırma |
/v1/translations | POST | Metinden metne çeviri |
Gömme (Embeddings) & Yeniden Sıralama (Rerank)
| Uç Nokta | Metot | Açıklama |
|---|---|---|
/v1/embeddings | POST | Metin gömmeleri oluşturma |
/v1/multimodal/embeddings | POST | Çok modlu bir gömme modeliyle gömmeler oluşturma |
/v1/rerank | POST | Belgeleri yeniden sıralama |
Kararlar
| Uç Nokta | Metot | Açıklama |
|---|---|---|
/v1/systemone | POST | Türlendirilmiş karar sorularını değerlendirme |
Dosyalar & Gruplar
| Uç Nokta | Metot | Açıklama |
|---|---|---|
/v1/files | POST, GET | Dosya yükleme ve listeleme |
/v1/files/{file_id} | GET, DELETE | Dosya alma veya silme |
/v1/files/{file_id}/content | GET | Dosya içeriğini indirme |
/v1/batches | POST, GET | Gruplar oluşturma ve listeleme |
/v1/batches/{batch_id} | GET | Grup alma |
/v1/batches/{batch_id}/cancel | POST | Grup iptal etme |
Görseller
| Uç Nokta | Metot | Açıklama |
|---|---|---|
/v1/images/generations | POST | Metinden görsel oluşturma |
/v1/images/edits | POST | Görsel düzenleme |
/v1/images/variations | POST | Görsel varyasyonları oluşturma |
/v1/images/generations/{id} | GET | Gö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ç Nokta | Metot | Açıklama |
|---|---|---|
/v1/audio/speech | POST | Metinden sese (TTS) |
/v1/audio/transcriptions | POST | Sesten metne (STT) |
/v1/audio/translations | POST | Konuşmayı İngilizce metne çevirme |
Gerçek Zamanlı
| Uç Nokta | Metot | Açıklama |
|---|---|---|
/v1/realtime?model={model} | WS | Gerç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ç Nokta | Metot | Açıklama |
|---|---|---|
/v1/videos/generations | POST | Video oluşturma görevi oluşturma |
/v1/videos/generations/{id} | GET | Uyumluluk durum yolu |
/v1/videos/assets | POST, GET | Seedance materyal varlıkları oluşturma ve listeleme |
/api/v3/contents/generations/tasks | POST, GET | Volcengine 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ç Nokta | Metot | Açıklama |
|---|---|---|
/v1/tasks/{id} | GET | Herhangi bir eşzamansız görev için durum |
/v1/tasks/{id} | DELETE | Eş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ç Nokta | Metot | Açıklama |
|---|---|---|
/v1/music/generations | POST | Müzik oluşturma görevi oluşturma |
/v1/music/generations/{id} | GET | Uyumluluk durum yolu |
3D Oluşturma
| Uç Nokta | Metot | Açıklama |
|---|---|---|
/v1/3d/generations | POST | 3D model oluşturma görevi oluşturma |
/v1/3d/generations/{id} | GET | Uyumluluk durum yolu |
Worlds
| Uç Nokta | Metot | Açıklama |
|---|---|---|
/v1/worlds/generations | POST | Dünya oluşturma görevi oluşturma |
/v1/worlds/list | POST | Dünyaları listeleme |
/v1/worlds/{id} | GET, DELETE | Dünya alma veya silme |
/v1/worlds/media-assets/prepare-upload | POST | Medya varlığı yüklemesi hazırlama |
Modeller & Fiyatlandırma
| Uç Nokta | Metot | Açıklama |
|---|---|---|
/v1/models | GET | Tüm mevcut modelleri listeleme |
/v1/models/{model} | GET | Belirli model bilgisini alma |
/v1/models/{model}/pricing | GET | Bir modelin fiyatlarını alma |
/v1/pricing | GET | Model fiyatlarını listeleme |
Gemini (v1beta)
Yerel Google Gemini API format desteği:
| Uç Nokta | Metot | Açıklama |
|---|---|---|
/v1beta/models | GET | Gemini isteklerini kabul eden modelleri listeleme |
/v1beta/models/{model} | GET | Model alma |
/v1beta/models/{model}:generateContent | POST | İçerik oluşturma |
/v1beta/models/{model}:streamGenerateContent | POST | Akışlı içerik oluşturma |
/v1beta/models/{model}:countTokens | POST | Token sayma |
/v1beta/files, /v1beta/cachedContents | POST, GET, DELETE | Gemini 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ık | Açıklama |
|---|---|
X-Request-ID | Destek ve hata ayıklama için istek tanımlayıcısı |
X-Routing-Time-MS | Akış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-ID | Görev tabanlı yanıtlar için genel eşzamansız görev tanımlayıcısı |
X-Billing-Transaction-ID | Nihai 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