Kişisel API anahtarları

Kişisel API anahtarları, üyelerin paylaşılan bir çalışma alanı anahtarı dağıtmadan çalışma alanınızın modellerini kodlama araçlarından ve kendi projelerinden kullanmasına olanak tanır. Her anahtar onu oluşturan üyeye aittir, yalnızca completion uç noktalarına erişir ve o üyenin kullanım bütçesini harcar; böylece kimlerin erişim alacağını ve ne kadar harcayabileceğini siz belirlersiniz.

Personal API keys sekmesi yalnızca özellik çalışma alanınız için etkinleştirildikten sonra görünür. Üyeler, siz onlara erişim verdikten sonra hesap ayarlarında API keys öğesini görür.

Üyelere erişim verme

Kişisel API anahtarı ayarlarını açın

Settings > Workspace > Products > API sayfasına gidin, ardından Personal API keys öğesini açın.

Kimlerin erişim alacağını seçin

Tüm çalışma alanına açın veya ihtiyacı olanlarla sınırlı tutun:

Herkesin kişisel API anahtarı oluşturabilmesi için General access öğesini açın.

General access kapalı bırakın ve Allow specific members or groups to create personal API keys öğesini açın; ardından ihtiyacı olan üye ve grupları ekleyin.

Harcayacakları bütçeyi verin

Kişisel API kullanımı, üyenin sohbet ve temsilci kullanımıyla aynı bütçeden çekilir. Settings > Workspace > Usage altında extra usage etkinleştirin ve erişim verdiğiniz her üye için sıfırın üzerinde etkili bir limit belirleyin. Çalışma alanı harcama limitinin de kişisel API kullanımı için yer bıraktığından emin olun.

Erişimi olup kullanılabilir bütçesi olmayan bir üye kişisel API anahtarı sayfasını açabilir ama anahtar oluşturamaz. Kişisel API istekleri, üyenin etkili bütçesi tükendiğinde yedek model kullanmak yerine hata döndürür. Kullanım istekleri etkinse oradan daha yüksek bireysel limit isteyebilirler. Çalışma alanı harcama limiti aşıldığında üyenin limitini artırmak API erişimini geri getirmez. Kişisel API istekleri, çalışma alanı limitini yükseltene, Unlimited yapana veya geçerli fatura dönemi sıfırlanana kadar hata döndürmeye devam eder.

BYOK ve ayrılmış dağıtımlarda bunun yerine her üye için sıfırın üzerinde bireysel Extra Usage limiti belirleyin. Orada plan ve grup limitleri kişisel anahtarlara uygulanmaz ve Extra Usage'ın etkin olması gerekmez. Limitlerin nasıl bir araya geldiği için BYOK kullanım limitleri sayfasına bakın.

Kullanımı izleme ve anahtarları iptal etme

Usage insights geçerli ayın API harcamasını, kaç anahtarın aktif olduğunu, kaç üyenin anahtarı olduğunu ve son 14 günde üye başına günlük harcamayı gösterir.

All personal keys bireysel anahtarları incelediğiniz yerdir. Üyeye göre arayın, harcama veya etkinliğe göre filtreleyin, her anahtarın sahibini, son kullanımını, aylık harcamasını ve durumunu kontrol edin ve gerektiğinde bir anahtarı iptal edin.

İptal hemen geçerli olur ve geri alınamaz. Bir üyenin kişisel API anahtarı erişimini kaldırdığınızda veya çalışma alanı üyeliğini devre dışı bıraktığınızda kişisel anahtar da çalışmayı durdurur.

Ne zaman kişisel anahtar kullanmalıyım?

Bir üyenin kendi kimliği ve kullanım bütçesi altında API erişimine ihtiyacı olduğunda kişisel API anahtarına başvurun. Tek bir kişinin hesabına bağlı olmaması gereken paylaşılan uygulamalar ve otomasyonlar için çalışma alanı API anahtarı kullanın.

Bir çalışma alanı API anahtarı servis hesabı olarak çalışır. Onu oluşturan kişinin kişisel bağlantılarını kullanmaz. Çalışma alanı API anahtarıyla çağrılan temsilciler için bir bağlantıyı önceden seçin veya bağlantıyı o anahtarla paylaşın. Bir eylem tüm çalışma alanına açık değilse o eylemi anahtarla paylaşın.

Ayrılmış dağıtımlarda çalışma alanı API anahtarları hâlâ onları oluşturan kişi olarak çalışır.