Başlarken
Kimlik Doğrulama
TokenLab API isteklerinin bir API anahtarı ile kimlik doğrulaması
API Anahtarları
Model çağrıları ve özel kaynaklar bir API anahtarı gerektirir. GET /v1/models ve GET /v1/models/{model} gibi genel keşif uç noktaları anahtarsız çalışır. Başarılı bir keşif yanıtı, anahtarınızın çalıştığını doğrulamaz; bir model isteği göndermek için Hızlı Başlangıç (Quickstart) kılavuzunu takip edin. Kaydedilen anahtarın tamamını kullanın; anahtar listesindeki ön ek kimlik doğrulaması yapamaz.
OpenAI uyumlu uç noktalar için şu şekilde gönderin:
Authorization: Bearer sk-your-api-keyAnthropic uyumlu /v1/messages istekleri için şunları da kullanabilirsiniz:
x-api-key: sk-your-api-keyGemini uyumlu /v1beta/* istekleri de x-goog-api-key: sk-your-api-key kabul eder. URL'ler genellikle günlüklerde (log) göründüğü için ?key= sorgu parametresi yerine bir başlık (header) kullanmayı tercih edin.
Yönetim Token'ları
Yönetim API uç noktaları ayrı bir token türü kullanır:
Authorization: Bearer mt-your-management-tokenYönetim token'larını yalnızca /v1/management/* uç noktalarıyla kullanın. Bir token oluşturmak veya değiştirmek için seçili çalışma alanı için API → Tokens sayfasını açın. Token'ı oluşturulduktan veya değiştirildikten sonra yalnızca bir kez görüntülendiği için tam halini kaydedin.
Yönetim token'ları model çıkarımı için kullanılamaz ve standart sk-... API anahtarları Yönetim API'si için kullanılamaz.
Bir API anahtarı alın
- TokenLab Console adresine giriş yapın
- API Keys kısmını açın
- Yeni bir anahtar oluşturun
- Açıklayıcı bir isim verin
- Yalnızca bir kez gösterildiği için hemen kopyalayın
- API anahtarlarını asla istemci tarafındaki kodlarda açık etmeyin
- API anahtarlarını asla sürüm kontrol sistemine (version control) işlemeyin
- Ortam değişkenlerini veya bir gizli yönetim aracı (secret manager) kullanın
- Anahtarları periyodik olarak yenileyin
- Kullanılmayan anahtarları silin
Bir API anahtarı kullanın
Ortam değişkenleri ve ilk tam istek için Hızlı Başlangıç bölümüne bakın. Seçtiğiniz API formatına uygun SDK'yı kullanın; anahtarları sunucuda tutun.
Anahtar ayarları
Bunları her API anahtarı için Console üzerinden ve Yönetim API'si aracılığıyla ayarlayabilirsiniz:
| Ayar | Açıklama |
|---|---|
| Harcama limiti | No limit, anahtarın Çalışma Alanı bakiyesini kullanmasına izin verir. Fixed limit, anahtar belirlenen tutara ulaştığında 402 quota_exceeded hatası döndürür. |
| İzin verilen modeller | Anahtar yalnızca bu modelleri çağırabilir. Diğer modeller 403 model_not_allowed hatası döndürür. Boş bırakılması, anahtar düzeyinde bir kısıtlama olmadığı anlamına gelir. |
| Teslimat seçeneği | Bu anahtardan gelen istekler için Auto, Verified veya Official. Boş bırakılması Çalışma Alanı varsayılanını kullanır. Bkz: Faturalandırma ve fiyatlandırma. |
| Son kullanma tarihi | Bu süreden sonra anahtar 401 expired_api_key hatası döndürür. |
| Durum | inactive (duraklatılmış) bir anahtar 401 invalid_api_key döndürür. revoked (iptal edilmiş) bir anahtar tekrar etkinleştirilemez. |
Anahtar ön eki
Tüm TokenLab API anahtarları sk- ile başlar.
Hata Yanıtları
| Durum Kodu | Tür | Kod | Açıklama |
|---|---|---|---|
| 401 | invalid_api_key | invalid_api_key | API anahtarı eksik, geçersiz, etkin değil veya iptal edilmiş |
| 401 | expired_api_key | expired_api_key | Anahtarın süresi dolmuş |
| 402 | insufficient_balance | insufficient_balance | Hesap bakiyesi yetersiz |
| 402 | quota_exceeded | quota_exceeded | API anahtarı kullanım limitine ulaşıldı |
| 403 | permission_error | model_not_allowed | Anahtarın istenen modeli kullanma izni yok |
| 403 | permission_error | user_suspended, account_restricted | Hesap API'yi kullanamaz |
| 429 | rate_limit_exceeded | rate_limit_exceeded | Tek bir IP adresinden çok fazla başarısız kimlik doğrulama denemesi yapıldı. Retry-After süresini bekleyin ve anahtarı düzeltin; 401 hatasında döngüye girmeyin |
Örnek:
{
"error": {
"message": "Invalid API key",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}