Kimlik Doğrulama

Anahtar oluşturma

API anahtarları, console.artfical.com üzerindeki bir çalışma alanından, API anahtarları sayfasından verilir. Bir anahtar edinmenin tek yolu orada bir tane oluşturmaktır; API'nin kendisi üzerinden bir anahtar üretmenin veya döndürmenin bir yolu yoktur ve bu kasıtlıdır: anahtar oluşturma hassas, düşük sıklıkta yapılan bir işlemdir ve bunu konsolun kendi oturum tabanlı girişinin arkasına koymak, işlemi yalnızca API düzeyinde erişimi olan hiçbir şeyin ulaşamayacağı bir yerde tutar.

Bir anahtar şöyle görünür, her zaman aynı önekle:

tai-sk-bSL2q4ja-skivx5JVNaJyyDVtKgiBAxuq8yRzsb6-e8

Anahtarın tam değeri yalnızca bir kez, oluşturduğunuz anda gösterilir. Bundan sonra konsol, tanımlama amacıyla yalnızca kısaltılmış bir biçim gösterir (ilk birkaç karakter ve son birkaç karakter, ortası maskelenmiş). Tam değeri kaybederseniz, onu kurtarmanın bir yolu yoktur; tek seçenek o anahtarı iptal edip yenisini oluşturmaktır. Bir anahtara bir veritabanı şifresiyle aynı şekilde davranın: kaynak kodunda değil bir ortam değişkeninde veya bir sırlar yöneticisinde saklayın ve bir son kullanıcının tarayıcısının okuyabileceği bir istemci tarafı uygulamada asla kullanmayın.

Anahtarı bir istekte gönderme

/v1/chat/completions ve /v1/models adreslerine yapılan her istek, anahtarı Bearer şemasını kullanarak standart bir Authorization başlığında içermelidir:

Authorization: Bearer tai-sk-bSL2q4ja-skivx5JVNaJyyDVtKgiBAxuq8yRzsb6-e8

Bu, OpenAI'nin kendi API'sinin kullandığı başlık biçimiyle birebir aynıdır; bu yüzden mevcut bir openai SDK tabanlı istemciyi tAI'ye yönlendirmek genellikle tek satırlık bir değişikliktir: base_url'i https://api.artfical.com/v1 olarak, api_key'i de tAI anahtarınız olarak ayarlayın; SDK'nın kendi istek kodunun değişmesine gerek kalmaz.

# Python, using the official openai package
from openai import OpenAI

client = OpenAI(
    base_url="https://api.artfical.com/v1",
    api_key="tai-sk-...",
)

response = client.chat.completions.create(
    model="tai-4.1",
    messages=[{"role": "user", "content": "Merhaba"}],
)
print(response.choices[0].message.content)

Başlığı hiç içermeyen bir istek, ya da onu yanlış biçimde gönderen bir istek (Bearer önekinin eksik olması, boş bir değer, ayrıştırılamayan bir anahtar), düpedüz geçersiz bir anahtarla aynı şekilde reddedilir: 401 durum kodu ve authentication_error türü. Tam yanıt biçimi için Hatalar sayfasına bakın.

Çalışma alanları ve kapsam

Bir anahtar tam olarak bir çalışma alanına aittir ve yalnızca o çalışma alanı adına istek göndermek için kullanılabilir. Birden fazla çalışma alanına yayılan bir anahtar kavramı yoktur ve tek bir anahtara yalnızca belirli modellere veya belirli bir hız sınırı katmanına kısmi erişim vermenin bir yolu yoktur; bir çalışma alanındaki her anahtar, Modeller sayfasında listelenen her modele aynı erişime sahiptir. İki farklı proje arasında kullanımı veya faturalandırmayı ayırmanız gerekiyorsa, çözüm kendi anahtarlarına sahip iki ayrı çalışma alanıdır, aralarında paylaşılan tek bir anahtar değil.

Belirli bir anahtarla yapılan kullanım (istek sayıları, token sayıları ve tahmini maliyet) o anahtara atfedilir ve konsolun Kullanım sayfasında, anahtarın ait olduğu çalışma alanıyla sınırlı olarak görünür. Bu yalnızca sizin görebilmeniz içindir; bir isteğin nasıl işlendiğini etkilemez.

Son kullanma tarihi

Bir anahtar isteğe bağlı olarak bir son kullanma tarihiyle (7, 30 veya 90 gün sonra, ya da hiç son kullanmayacak şekilde, anahtar oluşturulurken seçilir) oluşturulabilir. Bir anahtar son kullanma tarihini geçtiğinde, onunla yapılan her istek, dışarıdan ayırt edilemeyecek şekilde geçersiz bir anahtarla aynı 401 authentication_error hatasıyla reddedilir. Daha önce çalışan bir anahtarla yapılan istekler aniden 401 ile başarısız olmaya başlarsa, başka bir şeyin bozulduğunu varsaymadan önce kontrol edilmesi gereken ilk şey, API anahtarları sayfasında süresi dolmuş bir anahtar olup olmadığıdır.

Otomatik yenileme yoktur. Son kullanma tarihine yaklaşan bir anahtarın, yeni oluşturulan bir anahtarla değiştirilmesi gerekir; konsol, mevcut bir anahtarın ömrünü yerinde uzatmaz.

Bir anahtarı iptal etme

Bir anahtar, API anahtarları sayfasından her zaman, anında ve geri döndürülemez şekilde iptal edilebilir. İptal edilmiş bir anahtar, API açısından süresi dolmuş bir anahtarla birebir aynı şekilde davranır: bundan sonraki her istek 401 alır. İptal, sızdırılmış bir anahtar için doğru tepkidir; bir anahtarın gizli değerini yerinde döndürmenin bir yolu yoktur, yalnızca eskisini iptal edip yerine yenisini oluşturabilirsiniz.

Bir anahtarın tek başına vermediği şeyler

Geçerli bir API anahtarına sahip olmak, sohbet tamamlama istekleri göndermek ve modelleri listelemek için yeterlidir. Konsol arayüzünün kendisine, çalışma alanı ayarlarına, faturalandırma bilgilerine veya diğer üyelerin etkinliğine erişim vermez; bunlar, API anahtarlarından tamamen ayrı olan konsolun kendi oturum tabanlı girişiyle korunur. Sızdırılmış bir API anahtarı gerçek bir sorundur, çünkü birinin çalışma alanınız adına istek göndermesine (ve buna bağlı kullanımı üstlenmesine) olanak tanır; ancak tek başına konsol hesabınızı açığa çıkarmaz ya da birinin sizin yerinize oturum açmasına izin vermez.