Başlarken
Hızlı Başlangıç
cURL, Python, JavaScript, Go veya PHP kullanarak ilk TokenLab API isteğinizi yapın. API anahtarınızı ayarlayın, uç noktayı yapılandırın ve bir Chat Completions yanıtını doğrulayın.
Bir API anahtarı alın
Bir hesap oluşturun
E-posta, Google veya GitHub hesabınızı kullanarak tokenlab.sh adresinden kaydolun.
Bir API anahtarı oluşturun ve kaydedin
Çalışma alanınızda API Keys sayfasını açın. Bir anahtar oluşturun ve tam değerini hemen kaydedin; bu değer yalnızca bir kez gösterilir. Eğer tam bir anahtarı zaten kaydettiyseniz, o değeri kullanın. Listeden gösterilen veya kopyalanan önek (prefix), isteklerin kimliğini doğrulayamaz.
Çalışma alanı bakiyesini kontrol edin
Billing sayfasından bakiyenizi kontrol edin. Yeni bir hesap tek seferlik bir deneme kredisi alabilir; aksi takdirde bakiye $0 ile başlar ve ilk istekten önce bir yükleme (minimum $5) yapılması gerekir. İstek, seçilen modelin güncel fiyatı üzerinden ücretlendirilir.
API anahtarını gizli tutun. İstemci tarafındaki kodlara veya herkese açık bir depoya eklemeyin.
Anahtarı bu terminal için ayarlayın
Aşağıdaki komutlar, anahtarı komutun kendisinden uzak tutar. Anahtarı yalnızca mevcut terminal ve onun alt süreçleri için ayarlarlar. Dağıtılmış uygulamalar için bir gizli yönetim aracı (secret manager) kullanın.
printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEYBir istemci yükleyin
pip install openaiİlk isteğinizi gönderin
Çoğu yeni entegrasyon için POST /v1/chat/completions adresindeki Chat Completions ile başlayın.
curl https://api.tokenlab.sh/v1/chat/completions \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'Bir SDK örneğini quickstart.py, quickstart.mjs, main.go veya quickstart.php olarak kaydedin, ardından python quickstart.py, node quickstart.mjs, go run . veya php quickstart.php komutunu çalıştırın. Python, JavaScript ve Go resmi OpenAI SDK'larını kullanır; PHP ise topluluk tarafından desteklenen OpenAI PHP client (PHP 8.2+) kullanır.
POST /v1/responses uç noktasını yalnızca Responses'a özgü davranışlara ihtiyaç duyduğunuzda kullanın. Yalnızca Responses'a özgü alanlar için destek, seçilen modele bağlıdır.
Sonucu doğrulayın
Başarılı bir istek, boş olmayan bir yanıt döndürür. Modelini, durumunu ve kullanımını kontrol etmek için aynı çalışma alanında Runs sayfasını açın. Hatalar için sorun giderme kılavuzunu takip edin. Modeli değiştirmek veya streaming eklemek, SDK kılavuzundaki ayrı bir sonraki adımdır.
İlk çağrım neden 402 hatası veriyor?
İlk çağrınızın çalışıp çalışmayacağı, Billing sayfasında gösterilen bakiyeye bağlıdır. Deneme kredisi teklifi devam ederken, uygun yeni bir hesap 7 gün içinde 10 çağrıya kadar bir kez $0.25 alır; on birinci çağrı 402 hatası döndürür ve az miktarda kredi kalsa bile ücretsiz deneme çağrılarının tükendiğini belirtir. $0 bakiyesi olan bir hesap, insufficient_balance hata koduyla HTTP 402 alır. Billing sayfasından en az $5 yükleme yapın; $5 minimum yükleme tutarıdır. Ardından aynı isteği tekrar gönderin. Yeni bir API anahtarına ihtiyacınız yoktur: oluşturduğunuz anahtar, bakiye isteği karşıladığı sürece çalışmaya devam eder.
İlk test çağrısı çok az maliyetlidir. deepseek-v4.1-flash modeline yapılan örnek bir istek $0.01'in çok altındadır.
Eğer zaten bir bakiyeniz varsa, 402 mesajı isteğin ne kadar tutara ihtiyaç duyduğunu ve bakiyenizin ne kadar olduğunu belirtir. TokenLab, çağrı başlamadan önce tam max_tokens maliyetini tutar, bu nedenle uzun bir girdi veya büyük bir max_tokens değeri, küçük bir bakiyeden daha fazlasına ihtiyaç duyabilir. /v1/chat/completions ve /v1/messages uç noktalarında, daha küçük bir max_tokens değeri uygun olduğunda, mesaj ayrıca değeri düşürmeniz için bir öneri sunar. Yalnızca girdinin maliyeti bakiyenizden fazlaysa, girdiyi kısaltmanız gerektiğini belirtir.
Kendi harcama limitine ulaşan bir anahtar da quota_exceeded koduyla 402 hatası döndürür. Limiti API Keys sayfasından yükseltebilir veya kaldırabilirsiniz. Kod içerisinde 402 hatasını yönetmek için hata yönetimi bölümüne bakın.