API Anahtarları
Tüm TokenLab API istekleri bir API anahtarı gerektirir.
OpenAI uyumlu endpoint’ler için bunu şu şekilde gönderin:
Authorization: Bearer sk-your-api-key
/v1/messages istekleri için şunu da kullanabilirsiniz:
x-api-key: sk-your-api-key
API Anahtarınızı Alma
- TokenLab Dashboard hesabınıza giriş yapın
- API Keys bölümünü açın
- Yeni bir anahtar oluşturun
- Buna açıklayıcı bir ad verin
- Hemen kopyalayın çünkü yalnızca bir kez gösterilir
- API anahtarlarını asla istemci tarafı kodunda açığa çıkarmayın
- API anahtarlarını asla sürüm kontrolüne commit etmeyin
- Ortam değişkenleri veya bir secret manager kullanın
- Anahtarları periyodik olarak döndürün
- Kullanılmayan anahtarları silin
API Anahtarlarını Kullanma
curl https://api.tokenlab.sh/v1/responses \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"input": "Hello!"
}'
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("TOKENLAB_API_KEY"),
base_url="https://api.tokenlab.sh/v1"
)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.TOKENLAB_API_KEY,
baseURL: 'https://api.tokenlab.sh/v1'
});
API Anahtarı Özellikleri
Kullanım Limitleri
Her API anahtarı için bir kullanım limiti ayarlayabilirsiniz:
| Ayar | Açıklama |
|---|
| No Limit | Anahtar, hesabınızın bakiyesini kısıtlama olmadan kullanır |
| Fixed Limit | Anahtar, belirtilen tutara ulaştıktan sonra çalışmayı durdurur |
Anahtar Öneki
Tüm TokenLab API anahtarları sk- ile başlar.
Anthropic Uyumluluğu
/v1/messages endpoint’i için Anthropic tarzı header beklendiği gibi çalışır:
curl https://api.tokenlab.sh/v1/messages \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
/v1/responses, /v1/chat/completions, /v1/models ve diğer TokenLab rotalarının çoğu gibi OpenAI uyumlu endpoint’ler için Authorization: Bearer ... kullanın.
Hata Yanıtları
| Durum Kodu | Tür | Kod | Açıklama |
|---|
| 401 | invalid_api_key | invalid_api_key | Eksik veya geçersiz API anahtarı |
| 401 | expired_api_key | expired_api_key | API anahtarı iptal edildi |
| 402 | insufficient_balance | insufficient_balance | Hesap bakiyesi yetersiz |
| 402 | quota_exceeded | quota_exceeded | API anahtarı kullanım limitine ulaşıldı |
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}
