Başlarken
Kimlik Doğrulama
TokenLab API isteklerinizi API anahtarlarıyla güvence altına alın
API Anahtarları
Model çağrıları ve özel kaynaklar API anahtarı gerektirir. GET /v1/models ve GET /v1/models/{model} gibi genel uç noktalar anahtarsız çalışır. Keşif sorgusunun başarılı olması anahtarın çalıştığını doğrulamaz; hızlı başlangıçtaki adımlarla bir model isteği gönderin. Listedeki önek yerine kaydettiğiniz tam anahtarı kullanın.
OpenAI uyumlu endpoint'ler için bunu şu şekilde gönderin:
Authorization: Bearer sk-your-api-keyAnthropic uyumlu /v1/messages istekleri için şunu da kullanabilirsiniz:
x-api-key: sk-your-api-keyYönetim tokenları
Yönetim API uç noktaları ayrı bir token türü kullanır:
Authorization: Bearer mt-your-management-tokenYönetim tokenlarını yalnızca /v1/management/* uç noktalarıyla kullanın. Seçili çalışma alanında token oluşturmak veya değiştirmek için API → Tokens sayfasını açın. Tam token oluşturma veya değiştirme sonrasında yalnızca bir kez gösterilir; bu sırada güvenli bir yere kaydedin.
Yönetim tokenları model çıkarımı için, normal sk-... API anahtarları ise Yönetim API için kullanılamaz.
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
Ortam değişkenleri ve ilk tam istek için hızlı başlangıca bakın. Seçilen API biçimine uygun SDK kullanın ve anahtarları sunucuda tutun.
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.
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 | API anahtarının süresi doldu |
| 402 | insufficient_balance | insufficient_balance | Hesap bakiyesi yetersiz |
| 402 | quota_exceeded | quota_exceeded | API anahtarı kullanım limitine ulaşıldı |
Örnek:
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}