Genel bakış
Projeler, bir API kuruluşundaki çalışmaları düzenlemeyi sağlar. Modeller, yetenekler, konuşma dizileri, asistanlar, ince ayar ve depolama gibi belirli bir kaynak grubu için erişimi yönetmek, model ve işlem limitlerini yapılandırmak, hizmet hesapları oluşturmak, kullanımı, faturalandırmayı ve harcama limitlerini takip etmek üzere projeleri kullanın.
Kuruluş sahipleri, Projeler sayfasında tüm etkin ve arşivlenmiş projeleri görüntüleyebilir.
Başlamadan önce
Proje oluşturmak için kuruluş sahibi rolüne sahip olmanız gerekir. Kuruluşlar varsayılan olarak en fazla 2.000 proje oluşturabilir.
Kuruluşunuz birleştirilmiş faturalandırma kullanıyorsa alt kuruluşlar, kuruluş seçicide ayrı ayrı görünür. Alt kuruluş içinde proje oluşturamazsınız.
Kuruluş değiştirmek için kuruluş seçiciyi açın ve kullanmak istediğiniz kuruluşu seçin.
Varsayılan proje
Her kuruluşta silinemeyen bir Varsayılan proje bulunur. Bu proje, kuruluşun tüm yapılandırmasını devralır. Projenin işlem limitlerini, sanal model izinlerini ve harcama limitlerini yapılandırabilirsiniz.
Varsayılan projeye doğrudan üye veya hizmet hesabı ekleyemezsiniz. Bu makaledeki kuruluşa davet etme adımlarını kullanarak birini kuruluşa davet ederken Varsayılan projeye erişim de verebilirsiniz.
Proje oluşturma
Proje seçiciyi açın ve Proje oluştur seçeneğini seçin.
Projeniz için bir ad, açıklama ve web sitesi girin.
Oluştur seçeneğini seçin.
Kuruluş sahipleri, yeni projelere otomatik olarak sahip rolüyle eklenir.
Rolleri ve erişimi anlama
Tablo, bu adımlarda kullanılan kuruluş sahibi ve okuyucu rollerini ve proje sahibi ve üye rollerini özetler. Proje üyeleri, kuruluş okuyucularına benzer izinlere sahiptir.
| Rol | Kapsam | İzinler |
|---|---|---|
| Sahip | Kuruluş | Tüm projeleri, kullanıcıları ve API anahtarlarını oluşturma ve görüntüleme. Projeler sayfasında projeleri izleme. Kuruluş ve proje harcama limitlerini belirleme. Diğer kullanıcıların kullanım bilgilerine erişim verme. Projeleri arşivleme. |
| Okuyucu | Kuruluş | Projelere eklenebilme, bu projelerde çıkarım yapma, kaynakları kullanma ve anahtar oluşturma. Proje oluşturamaz veya kullanıcıları yönetemez. |
| Sahip | Proje | Tüm üye izinlerine ek olarak kullanıcı ekleme, proje üyelerini ve ayarlarını yönetme, projeyi yeniden adlandırma, harcama limitlerini belirleme ve projeyi arşivleme. |
| Üye | Proje | Çıkarım yapma, kaynakları kullanma, proje düzeyinde anahtar oluşturma ve veri okuyan veya değiştiren API istekleri gönderme. |
Kuruluş rollerine ilişkin ayrıntılar için kuruluş rolleri makalesine bakın. Ek roller, özel roller ve tüm izinler için API rolleri ve izinleri kılavuzuna bakın.
Proje görünürlüğü
Bu standart rollerde, kuruluş sahibi olmayan kullanıcılar yalnızca üyesi oldukları projeleri görebilir. Kuruluş sahipleri tüm projeleri, üyeleri ve proje düzeyindeki API anahtarlarını görebilir ve Projeler sayfasına erişebilir.
Proje üyeleri, projelerindeki diğer üyeleri ve her üyenin rolünü görebilir. Bir projede oluşturulan veya projeye eklenen ince ayar yapılmış modelleri, asistan konuşma dizilerini ve dosyaları yalnızca o projenin üyeleri ve kuruluş sahipleri görebilir.
İhtiyaç duyduğunuz kadar projeye üye olabilirsiniz. Bir projede oluşturulan kişisel API anahtarı, o proje ve projenin kaynaklarıyla sınırlıdır.
Kaynakların kapsam sınırları
Dosyalar, asistanlar, depolama alanı ve konuşma dizileri kendi projeleriyle sınırlıdır. Proje dışındaki yönetici olmayan üyeler projenin kaynaklarına erişemez ve kaynaklar projeler arasında taşınamaz.
Varsayılan projede ince ayar yapılmış modeller bu kuralın dışındadır: Bu modellere diğer projelerden erişilebilir.
Proje üyelerini yönetme
Kuruluşunuza birini davet etme
Birini projeye ekleyebilmeniz için önce kuruluşunuza üye olması gerekir.
Birini kuruluşa davet ederken davet formundaki ilgili seçeneği işaretleyerek Varsayılan projeye erişim de verebilirsiniz. Varsayılan projeye erişim vermek istemiyorsanız bu seçeneği işaretlemeyin. Kuruluşun yeni üyeleri Varsayılan projeye otomatik olarak eklenmez.
Birini davet etmeden önce başka bir proje oluşturmanız gerekmez. Kuruluş davetini kabul eden birini daha sonra da bir projeye ekleyebilirsiniz.
Yönetici API'si üzerinden gönderilen davetler, /organization/invites uç noktası kurallarına tabidir.
Bir kuruluş üyesini projeye ekleme
Kuruluş ve proje sahipleri üye ekleyebilir:
Kuruluş ayarlarına gidin.
Projeyi seçin, ardından Üyeler bölümünü açın.
+ Üye ekle seçeneğini seçin.
Kullanıcıyı seçin ve Üye veya Sahip rolünü atayın.
Kullanıcı listesinde, Okuyucu rolüne sahip kuruluş kullanıcıları gösterilir. Hizmet hesapları bu listede yer almaz.
Kullanıcı arayüzünde veya Yönetici API'sinde bir davet gönderilemezse daveti yeniden göndermeden önce hedef projenin mevcut olduğunu ve arşivlenmediğini doğrulayın.
Rol değiştirme veya üye kaldırma
Kuruluş ve proje sahipleri, bir kullanıcının projedeki rolünü değiştirebilir veya kullanıcıyı projeden kaldırabilir.
Kuruluş ayarlarına gidin.
Projeyi seçin, ardından Üyeler bölümünü açın.
Kullanıcının rolünü Üye veya Sahip olarak belirleyin ya da kullanıcıyı kaldırmak için Kaldır seçeneğini seçin.
Hizmet hesaplarını oluşturma ve yönetme
Hizmet hesabı, bireysel bir kullanıcıyı temsil etmek yerine sistem erişimi sağlar. Hizmet hesaplarının kapsamı projelerle sınırlıdır.
Hizmet hesapları oluşturmak için hizmet hesabı yönetim izinleri gerekir. Kuruluş ve proje sahipleri bu izinlere sahiptir.
Hizmet hesabı oluşturma
Proje seçiciden projeyi seçin.
Kuruluş ayarlarına gidin ve projeyi seçin.
Üyeler bölümünü açın ve + Hizmet hesabı seçeneğini seçin.
Harf, rakam ve kısa çizgiler kullanarak benzersiz bir hizmet hesabı kimliği girin.
Oluştur seçeneğini seçin.
Proje düzeyinde oluşturulan hizmet hesapları projeye özeldir ve oluşturuldukları projenin dışında kullanılamaz.
Hizmet hesabını kuruluş veya proje düzeyindeki ayarlardan oluşturmanız fark etmeksizin aynı kimlik biçimi geçerlidir.
Bir proje için oluşturulan hizmet hesabı o projeye özeldir ve proje dışında kullanılamaz.
Gizli anahtarı kaydetme
Hizmet hesabını oluşturduğunuzda hemen bir API anahtarı oluşturulur ve bu anahtarın gizli değeri gösterilir. Gizli anahtarı güvenli bir yerde saklayın. Bu anahtarı OpenAI hesabınız üzerinden tekrar görüntüleyemezsiniz. Kaybederseniz yeni bir anahtar oluşturun.
Hizmet hesabı anahtarı, varsayılan olarak projesindeki tüm API kaynakları için okuma ve yazma yetkisine sahiptir. Bu izinleri daha sonra projenin API Anahtarları ayarlarından değiştirebilirsiniz.
Hizmet hesabını güncelleme veya kaldırma
Hizmet hesapları, projenin Üyeler ayarlarında kullanıcılarla birlikte görünür. Hizmet hesaplarının projeye erişimini yönetmek için diğer proje üyeleriyle aynı rol değiştirme ve kaldırma adımlarını kullanın.
Kuruluş ve proje düzeyindeki ayarlardan oluşturulan hesaplar da dahil olmak üzere tüm hizmet hesapları, kuruluşun Üyeler sayfasında kullanıcılarla birlikte görünür.
Kuruluşun Üyeler menüsünden bir hizmet hesabının rolünü değiştirebilir veya Kaldır seçeneğini seçebilirsiniz.
API anahtarlarını oluşturma ve yönetme
Her projenin kendi API anahtarları vardır:
Kuruluş ayarlarına gidin.
Projeyi seçin, ardından API Anahtarları bölümünü açın.
Anahtar oluşturmak için + Yeni gizli anahtar oluştur seçeneğini seçin. Mevcut bir anahtarın izinlerini değiştirmek için yanındaki düzenleme simgesini seçin.
Anahtar izinlerini seçme
Kullanıcılara ait anahtarların izinlerini anahtarı oluştururken belirleyebilir veya daha sonra düzenleyebilirsiniz:
Tümü: Tüm izinler. Bu, varsayılan seçenektir.
Kısıtlı: Belirli kaynaklar veya uç noktalar için izin kapsamlarını seçin. Kullanılabilir seçenekler kaynağa bağlıdır ve Yok, Okuma, Yazma veya isteğe özel izinleri içerebilir.
Salt Okunur: Tüm uç noktalar için okuma izinleri.
Örneğin, kısıtlı bir anahtar /v1/assistants uç noktasına okuma ve yazma erişimini engelleyebilir.
Hizmet hesabı anahtarları oluşturmak için hizmet hesabı yönetim izinleri gerekir. Bu seçeneği göremiyorsanız bir kuruluş veya proje sahibinden hizmet hesabı anahtarını oluşturmasını isteyin. Anahtar oluşturma iletişim kutusunda, hizmet hesabı anahtarları için bu izin kontrolleri gösterilmez. Bu anahtarların izinlerini daha sonra projenin API Anahtarları ayarlarından değiştirin.
Model erişimini ve işlem limitlerini yapılandırma
Proje işlem limitlerini yönetmek için yönetici izinleri gerekir. Kuruluş sahipleri bu izinlere sahiptir. Proje sahipleri de yönetim API'si üzerinden proje işlem limitlerini yönetebilir.
Kuruluş ayarlarına gidin.
Projeyi seçin, ardından Limitler bölümünü açın.
Projenin hangi modelleri kullanabileceğini seçmek için Model kullanımı bölümünü kullanın.
Gerektiğinde her model için bir işlem limiti belirleyin.
Harcama limitlerini ve uyarılarını ayarlama
Aylık API harcama limitleri hem kuruluş hem de proje düzeyinde kullanılabilir. Bir limiti değiştirmek için ilgili kuruluşun veya projenin ayarlarını yönetme iznine sahip olmanız gerekir.
Harcama limiti, istekleri durdurmadan harcamaları izlemek için kullanılabilir. İzlenen harcama limite ulaştığında API isteklerinin başarısız olmasını istiyorsanız Kesin bir limit uygula seçeneğini açın. Limitin uygulanması anında gerçekleşmez. Bu nedenle kaydedilen harcama, belirlenen tutarı biraz aşabilir.
Harcama uyarıları, bir eşiğe ulaşıldığında size bildirim gönderir; istekleri durdurmaz.
Kuruluş harcama limiti belirleme
Kuruluş ayarlarına gidin.
Limitler bölümünü açın ve Harcama bölümünü bulun.
Proje harcama limiti belirleme
Kuruluş ayarlarına gidin.
Projeyi seçin, ardından Limitler bölümünü açın.
Aylık harcama limiti ve Harcama şu tutara ulaştığında uyar değerlerini belirleyin.
İzlenen harcama limite ulaştığında API trafiğini durdurmak istiyorsanız Kesin bir limit uygula seçeneğini açın.
Bu sayfada Model kullanımı ayarını da değiştirebilirsiniz.
Harcama uyarılarını yönetme
Bir proje harcama limiti oluşturduğunuzda varsayılan olarak limitin %100'üne ulaşıldığında gönderilecek bir uyarı da oluşturulur. Diğer eşikler için uyarı eklemek üzere Uyarı ekle seçeneğini seçin.
Proje harcama uyarıları kuruluş ve proje sahiplerine gönderilir. Uyarı ayarlarında başka e-posta alıcıları da ekleyebilirsiniz.
Güncel yapılandırma adımları ve limitlerin nasıl uygulandığı hakkında bilgi için harcama limitleri kılavuzuna bakın.
Kullanım ve faturalandırma bilgilerini görüntüleme
Kullanım etkinliğini proje bazında inceleyebilir, her projenin faturalandırma bilgilerini görüntüleyebilir ve harcama limitlerini belirleyebilirsiniz.
Bir projenin Kullanım Panosuna erişim, kuruluşunuzdaki rolünüze ve Kullanım Panosu görünürlük ayarlarına bağlıdır. Proje sahibi olmak tek başına erişim sağlamaz.
Bir projenin Kullanım Panosunu göremiyorsanız görünürlüğün Kuruluş sahiplerine görünür olarak ayarlanıp ayarlanmadığını kontrol edin.
Dosya depolama alanını yönetme
Her projenin dosya depolama kotası 100 GB'tır. Bu kotayı aşarsanız şu hatayı görebilirsiniz:
Dosya depolama kotanızı aştınız. Kuruluşlar en fazla 100 GB dosya depolayabilir. Lütfen dosya boyutunu küçültün veya destek ekibiyle iletişime geçin.
Depolama alanı açmak için kullanılmayan dosyaları silin. Artık ihtiyaç duymadığınız dosyaları belirlemek için depolanan dosyaları API üzerinden listeleyebilirsiniz.
Proje arşivleme
Kuruluş ve proje sahipleri, Projeler sayfasından veya ilgili projenin ayarlarından projeleri arşivleyebilir. Onaylamanız istendiğinde projenin adını girin.
Arşivleme kalıcıdır: Arşivlenen bir proje geri yüklenemez.
Arşivlenen projeleri görüntülemek için Projeler sayfasındaki Arşivlenenler sekmesini açın.
Tek istisna, “Varsayılan proje” içindeki fine-tune'lara diğer projelerden erişilebilmesidir.
Dosya depolama kotanızı aştınız. Kuruluşlar 100 GB dosya ile sınırlıdır. Lütfen dosya boyutunu azaltın veya destek ekibiyle iletişime geçin.Projeler silinemez. OpenAI, kullanım ve faturalandırma takibi için projelerin geçmişini saklar.