Projeler, müşterilere çalışmalarını düzenleme olanağı sunmak için tasarlanmıştır. Kuruluşlar erişimi ve limitleri yönetebilir, hizmet hesapları hazırlayabilir (kullanıcı arayüzü üzerinden) ve bir proje içinde sınırlandırılmış bir kapsamda (ör. modeller, özellikler, iş parçacıkları, asistanlar, ince ayar, depolama vb.) kullanımı izleyebilir. Kullanım etkinliği projeye göre ayrıştırılabilir; kullanıcılar faturalandırmayı görüntüleyebilir ve proje başına harcama limitleri belirleyebilir.
Kuruluş sahipleri, tüm Aktif ve Arşivlenmiş projelerini Projeler sayfasında görüntüleyebilir. API Platformu’ndaki kullanıcı rolleri ve izinler hakkında daha fazla bilgi edinin.
Kimler proje oluşturabilir?
Yalnızca kuruluş sahipleri proje oluşturabilir. Daha fazla bilgi için roller ve izinler bölümüne bakın.
Kuruluşlar arasında geçiş yapmak için sayfanın sol üst kısmındaki kuruluş adının üzerine gelin ve listeden kuruluşu seçin:
Birleştirilmiş faturalandırma planındaki kuruluşlarda alt kuruluşlar ayrı olarak tanımlanır. Alt kuruluşlarda proje oluşturulamaz.
Projeler nasıl çalışır?
Her kuruluşta silinemeyen bir “Varsayılan proje” bulunur. Hız limitlerini, sanal model izinlerini ve harcama limitlerini yapılandırabilirsiniz (Kasım 2024 itibarıyla). Kuruluşun tüm yapılandırmasını devraldığından bu projeye doğrudan üye veya hizmet hesabı ekleyemezsiniz.
Nasıl proje oluştururum?
Önce sayfanın sol köşesindeki proje adının üzerine gelin ve Proje oluştur'u seçin.
Projeniz için bir ad, açıklama ve web sitesi girip Oluştur'u seçin.
Bir projeye nasıl kullanıcı eklerim?
Yeni eklenen kuruluş üyeleri, “Varsayılan proje”ye otomatik olarak eklenmez. Yeni üyeler, kuruluşa davet edilirken “Varsayılan projeye davet et” kutusu işaretlenerek veya kuruluş davetini kabul ettikten sonra projeye davet edilebilir.
Admin API aracılığıyla davet edilen kullanıcılar, /organization/invites uç noktasında belirtilen kurallara tabidir.
Kullanıcıları kullanıcı arayüzü veya Admin API üzerinden bir projeye davet ederken hata alırsanız daveti yeniden göndermeden önce hedef projenin mevcut ve arşivlenmemiş olduğunu doğrulayın.
Kuruluş sahipleri, kuruluş içinde oluşturulan yeni projelere otomatik olarak sahip rolüyle eklenir.
Kuruluş ve projelerdeki farklı kullanıcı rolleri nelerdir ve hangi izinleri sağlarlar?
Kuruluşlarda “sahip” ve “okuyucu” rolleri bulunurken projelerde “sahip” ve “üye” rolleri bulunur. Proje üyeleri, kuruluş okuyucularına karşılık gelir. Her kullanıcı rolünün sağladığı izinlerin daha ayrıntılı açıklaması için aşağıdaki tabloya bakın.
| Rol | Kapsam | Açıklama |
|---|---|---|
| Sahip | Kuruluş | Tüm projeleri, kullanıcıları ve API anahtarlarını oluşturabilir ve görüntüleyebilir. Projeler sayfası üzerinden kuruluştaki tüm projeleri izleyebilir. Kuruluş ve proje harcama limitlerini belirleyebilir. Kuruluştaki diğer kişilere kullanım bilgilerini görüntüleme izni verebilir. Projeleri arşivleyebilir. |
| Okuyucu | Kuruluş | Projelerinde çıkarım yapabilir, kaynakları kullanabilir ve anahtar oluşturabilir. Projelere eklenebilir. Proje oluşturamaz ve kullanıcıları yönetemez. |
| Sahip | Proje | Üyenin tüm yetkilerine ek olarak projeye başka kullanıcılar ekleyebilir ve projenin adını değiştirebilir. Proje harcama limitlerini belirleyebilir. Projeyi arşivleyebilir. |
| Üye | Proje | Proje düzeyinde çıkarım yapabilir, kaynakları kullanabilir ve anahtar oluşturabilir. |
Kuruluşta Sahip değilsem nelere erişebilirim?
Kuruluşta Sahip olmayan kullanıcılar yalnızca üyesi oldukları projeleri görebilir. Proje düzeyindeki tüm projeleri, üyeleri ve API anahtarlarını yalnızca kuruluş sahibi görebilir ve Projeler sayfasına erişebilir.
Bir projede oluşturulan ince ayarlı modelleri, oluşturulan Asistanlara ait ileti dizilerini veya eklenen dosyaları yalnızca proje üyeleri ve kuruluş sahipleri görebilir.
Proje üyeleri, projedeki diğer tüm üyeleri ve rollerini (ör. Sahip veya Üye) görebilir.
Bir kullanıcının proje rolünü nasıl günceller veya kullanıcıyı projeden nasıl kaldırırım?
Bir kullanıcının proje rolünü yalnızca proje sahibi güncelleyebilir veya kullanıcıyı projeden kaldırabilir. Daha fazla bilgi için roller ve izinler bölümüne bakın.
Bir projedeki kullanıcıyı güncellemek için kuruluş ayarlarınıza gidin, projeyi seçin ve Üyeler'e tıklayın. Her üyenin rolünü Üye veya Sahip olarak belirleyebilirsiniz. Kullanıcıyı projeden çıkarmak için Kaldır'ı da seçebilirsiniz.
Hizmet hesabı nedir ve normal bir kullanıcı hesabından farkı nedir?
Hizmet hesabı, sistem erişimi için tasarlanmış sözde bir kullanıcı işlevi görür ve bireysel kullanıcı hesaplarından farklıdır. Yalnızca kuruluş ve proje sahipleri hizmet hesabı oluşturabilir.
Hizmet hesapları yalnızca projelerle sınırlıdır.
Projeye üye ekleme
+ Üye ekle düğmesine tıkladığınızda kuruluşunuzdaki Okuyucu rolüne sahip kullanıcıların listesini görürsünüz. Şu anda kuruluşunuzda bulunmayan bir kullanıcıyı eklemek istiyorsanız önce kuruluşa eklemeniz gerekir. Bu kullanıcılara daha geniş erişim vermek istemiyorsanız “Varsayılan Projeye Ekle” kutusunu işaretlemeden bırakabilirsiniz. Bu listede hizmet hesapları yer almaz. Bu adımda kullanıcının rolünü Sahip veya Üye olarak seçebilirsiniz:
Bir ekip üyesi eklerken ona Üye veya Sahip rolünü atamanız gerekir. Proje üyeleri verileri okuyan veya değiştiren API istekleri gönderebilir. Proje sahipleri ayrıca proje ayarlarını ve harcama limitlerini değiştirebilir ve proje üyelerini yönetebilir. Daha fazla bilgi için roller ve izinler bölümüne bakın.
Bir proje için hizmet hesabı oluşturma
Önce gezinme çubuğundaki açılır listeden seçim yaparak hizmet hesabı oluşturmak istediğiniz projeye gidin:
Ardından kuruluş ayarları -> Proje -> Üyeler yolunu izleyin ve + Hizmet hesabı'na tıklayın:
Proje düzeyinde oluşturulan hizmet hesapları projeye özeldir ve oluşturuldukları projenin dışında kullanılamaz.
Hizmet hesabını adlandırma
Hizmet hesabını kuruluş düzeyinde veya belirli bir projeye özel oluşturmanız fark etmeksizin, hesabı kolayca tanımak için harf, rakam ve kısa çizgilerden oluşan benzersiz bir hizmet hesabı kimliği oluşturabilirsiniz.
Hizmet hesabının API anahtarını kaydetme
Oluştur düğmesini seçtiğinizde hizmet hesabı için hemen bir API anahtarı oluşturulur ve gizli anahtar görüntülenir. Bu gizli anahtarı güvenli bir yere kaydedin. Güvenlik nedeniyle bu anahtarı OpenAI hesabınızda yeniden görüntüleyemezsiniz. Bu gizli anahtarı kaybederseniz yeni bir anahtar oluşturmanız gerekir.
Hizmet hesabı API anahtarı, varsayılan olarak projenin tüm API kaynaklarını okuma ve yazma iznine sahiptir. Bu izinler projenizin API Anahtarları ayarlarından güncellenebilir.
Hizmet hesapları, projenizin üye ayarları sayfasında proje üyeleriyle birlikte listelenir. Projenizin üye ayarları sayfasında bir hizmet hesabının erişimini güncelleme veya kaldırma hakkında daha fazla bilgi için buraya bakın.
Hem projeler hem de kuruluşlar genelindeki tüm hizmet hesapları, kuruluş düzeyi üyeler sayfasında insan kullanıcılarınızla birlikte görüntülenir.
Hizmet hesapları normal hesaplar gibi yönetilir. Kuruluş -> Üyeler menüsü üzerinden bir hizmet hesabını Kaldırabilir veya rolünü güncelleyebilirsiniz:
Kuruluşumun projelerindeki API anahtarlarını nasıl yönetirim?
Her projenin API anahtarlarını o projenin ayarlar sayfasından oluşturabilir ve yönetebilirsiniz. Kuruluş ayarlarınızda projeyi seçin ve API Anahtarları'na tıklayın.
Yeni bir gizli anahtar oluşturmak için + Yeni gizli anahtar oluştur'u seçin. Bir gizli anahtarın izinlerini düzenlemek için yanındaki Düzenle simgesini de seçebilirsiniz.
Yeni bir gizli anahtar oluştururken veya mevcut bir anahtarı düzenlerken her API anahtarı için izin belirleyebilirsiniz.
Üç izin düzeyi vardır: Tümü, Kısıtlı ve Salt Okunur.
Tümü — Gizli anahtara tam izin verilir. Bu, varsayılan ayardır.
Kısıtlı — Kullanıcının her uç nokta için Yok, Okuma ve Yazma izinlerini belirlemesini sağlar.
Örneğin, özellikle /v1/assistants uç noktasında Okuma veya Yazma izni bulunmayan bir API anahtarı oluşturabilirsiniz:
Salt Okunur — Tüm uç noktalar için okuma izni verilir.
Birden fazla projeye veya kuruluşa bağlı kullanıcıların erişimi nasıl yönetilir?
Kullanıcılar gerektiği kadar projeye üye olabilir. Kullanıcılar bir projede yalnızca o projeye ve kaynaklarına erişimle sınırlı kişisel bir API anahtarı oluşturabilir.
Kuruluşumun projeleri için hız limitlerini nasıl belirler ve yönetirim?
Proje düzeyindeki hız limitlerini yalnızca kuruluş sahibi belirleyip yönetebilir. Daha fazla bilgi için roller ve izinler bölümüne bakın.
Kuruluş ayarlarınızda güncellemek istediğiniz projeye tıklayın ve gezinme listesinin Proje bölümünden Limitler'i seçin. Bu sayfada Model Kullanımı ayarınızı güncelleyebilirsiniz.
Model kullanımı projenin hangi modelleri kullanabileceğini yapılandırmanızı sağlar; ayrıca her model için gerektiği şekilde hız limitleri belirlenebilir.
Kuruluşumun projeleri için harcama limitlerini nasıl belirler ve yönetirim?
Proje harcama limitlerini yalnızca kuruluş sahipleri ve proje sahipleri belirleyip yönetebilir. Daha fazla bilgi için roller ve izinler bölümüne bakın. Kuruluş düzeyindeki limitleri değiştirmek için kuruluş ayarlarınızda Limitler'e tıklayın ve Kullanım limitleri bölümüne ilerleyin.
Proje limitlerinizi belirlemek için kuruluş ayarlarınızda güncellemek istediğiniz projeye tıklayın ve Limitler'i seçin. Aylık harcama limiti, Bildirim eşiği ve Model Kullanımı ayarlarını güncelleyebilirsiniz.
Aylık harcama limiti belirleyerek projeniz için esnek harcama eşikleri oluşturabilirsiniz. Belirli bir takvim ayında (UTC) kullanım bu limiti aşarsa API istekleri kesintisiz olarak işlenmeye devam eder. Bu özellik, harcama limiti uyarılarıyla kullanımı izlemenize yardımcı olur ancak harcamaya kesin bir üst sınır uygulamaz. Bir proje harcama limiti oluşturulduğunda varsayılan olarak %100 eşiğinde bir uyarı oluşturulur. Farklı eşiklerde ek uyarılar belirlemek için Uyarı Ekle'ye tıklayabilirsiniz.
Kuruluş sahiplerinin ve proje sahiplerinin bu iletileri her zaman alacağını ve bunun özelleştirilemeyeceğini unutmayın.
Kuruluşum veya projem için harcama limitlerini nasıl belirlerim?
OpenAI artık hem kuruluş hem de proje düzeyinde aylık API harcama limitlerini destekliyor. Harcama limiti, harcamayı kısıtlamadan izleyebilir veya kesin limit olarak uygulanabilir; böylece harcama limite ulaştıktan sonra API istekleri başarısız olur. En güncel yapılandırma adımları ve çalışma biçimi için geliştirici belgelerindeki Harcama limitleri bölümüne bakın.
Bir projeyi nasıl siler veya arşivlerim?
Projeler, yeni proje listesi sayfasından veya ilgili projenin ayarlarından arşivlenebilir. Bir proje arşivlendikten sonra geri yüklenemez. Arşivleme işlemine devam ederken projenin adını girmeniz istenir.
Arşivlenmiş tüm projelerin listesini aynı proje listesi sayfasındaki “Arşivlenenler” sekmesinde görebilirsiniz.
Projeler silinemez. Kullanım ve faturalandırma takibinin sürekliliğini sağlamak için tüm projelerin geçmişini saklarız.
Kuruluşumda bulunabilecek proje sayısının bir sınırı var mı?
Kuruluşlar varsayılan olarak en fazla 2.000 proje oluşturabilir.
Kaynaklar projeler arasında paylaşılabilir mi?
Proje kaynakları (dosyalar, asistanlar, depolama veya ileti dizileri gibi) yalnızca ilgili proje kapsamındadır ve proje dışındaki yönetici olmayan üyeler bunlara erişemez. Ayrıca kaynaklar projeler arasında taşınamaz.
Tek istisna, “Varsayılan proje” içindeki fine-tune'lara diğer projelerden erişilebilmesidir.
Proje başına dosya depolama kotası nedir?
OpenAI şu anda proje başına 100 GB dosya depolama kotasını desteklemektedir.
Bu kota aşılırsa aşağıdaki hatayı görürsünüz:
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.Hesabınızda depolanan kullanılmayan dosyaları silmenizi öneririz. Referans olarak, API ile dosyaları görüntüleyebilir ve listeleyebilirsiniz.
Proje sahibiyim; projemin Kullanım Panosu'nu neden göremiyorum?
Bir projenin Kullanım Panosu'nun görünürlüğü, kullanıcının projedeki rolüyle ilgili değildir. Bunun yerine kuruluş içindeki rolünüze ve https://platform.openai.com/settings/organization/data-controls/visibility adresindeki ayarlara göre belirlenir.
Kullanım Panosu'nu göremiyorsanız bu ayar büyük olasılıkla “Kuruluş sahiplerine görünür” olarak belirlenmiştir.