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-key

Anthropic uyumlu /v1/messages istekleri için şunları da kullanabilirsiniz:

x-api-key: sk-your-api-key

Gemini 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-token

Yö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

  1. TokenLab Console adresine giriş yapın
  2. API Keys kısmını açın
  3. Yeni bir anahtar oluşturun
  4. Açıklayıcı bir isim verin
  5. 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:

AyarAçıklama
Harcama limitiNo 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 modellerAnahtar 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ğiBu 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 tarihiBu süreden sonra anahtar 401 expired_api_key hatası döndürür.
Duruminactive (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 KoduTürKodAçıklama
401invalid_api_keyinvalid_api_keyAPI anahtarı eksik, geçersiz, etkin değil veya iptal edilmiş
401expired_api_keyexpired_api_keyAnahtarın süresi dolmuş
402insufficient_balanceinsufficient_balanceHesap bakiyesi yetersiz
402quota_exceededquota_exceededAPI anahtarı kullanım limitine ulaşıldı
403permission_errormodel_not_allowedAnahtarın istenen modeli kullanma izni yok
403permission_erroruser_suspended, account_restrictedHesap API'yi kullanamaz
429rate_limit_exceededrate_limit_exceededTek 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"
  }
}

Bu sayfada