Mengelola project di platform API

Gambaran umum

Proyek membantu menata pekerjaan dalam organisasi API. Gunakan proyek untuk mengelola akses, mengonfigurasi batas model dan batas laju, membuat akun layanan, serta melacak penggunaan, penagihan, dan batas pengeluaran untuk sekumpulan sumber daya tertentu, seperti model, kapabilitas, utas, asisten, fine-tuning, dan penyimpanan.

Pemilik organisasi dapat melihat semua proyek aktif dan yang diarsipkan di halaman Proyek.

Sebelum memulai

Anda memerlukan peran pemilik organisasi untuk membuat proyek. Secara default, organisasi dapat membuat hingga 2.000 proyek.

Jika organisasi Anda menggunakan penagihan gabungan, suborganisasi ditampilkan secara terpisah di pemilih organisasi. Anda tidak dapat membuat proyek di dalam suborganisasi.

Untuk beralih organisasi, buka pemilih organisasi dan pilih organisasi yang ingin Anda gunakan.

Proyek Bawaan

Setiap organisasi memiliki proyek Bawaan yang tidak dapat dihapus. Proyek ini mewarisi seluruh konfigurasi organisasi. Anda dapat mengonfigurasi batas laju, izin model virtual, dan batas pengeluarannya.

Anda tidak dapat menambahkan anggota atau akun layanan langsung ke proyek Bawaan. Anda dapat menyertakan akses ke proyek Bawaan saat mengundang seseorang ke organisasi dengan mengikuti langkah-langkah undangan organisasi dalam artikel ini.

Buat proyek

1. Buka pemilih proyek dan pilih Buat proyek.

2. Masukkan nama, deskripsi, dan situs web untuk proyek Anda.

3. Pilih Buat.

Pemilik organisasi secara otomatis ditambahkan sebagai pemilik proyek baru.

Pahami peran dan akses

Tabel ini merangkum peran pemilik dan pembaca organisasi serta peran pemilik dan anggota proyek yang digunakan dalam langkah-langkah ini. Anggota proyek memiliki izin yang serupa dengan pembaca organisasi.

Untuk detail peran organisasi, lihat: peran organisasi. Untuk peran tambahan, peran khusus, dan daftar izin lengkap, lihat panduan peran dan izin API.

Visibilitas proyek

Dengan peran standar ini, pengguna yang bukan pemilik organisasi hanya dapat melihat proyek yang mereka ikuti. Pemilik organisasi dapat melihat semua proyek, anggota, dan kunci API tingkat proyek, serta mengakses halaman Proyek.

Anggota proyek dapat melihat anggota lain dalam proyek mereka beserta peran masing-masing. Hanya anggota proyek dan pemilik organisasi yang dapat melihat model yang telah di-fine-tune, utas asisten, serta file yang dibuat atau ditambahkan dalam proyek tersebut.

Anda dapat bergabung dengan sebanyak mungkin proyek sesuai kebutuhan. Kunci API pribadi yang dibuat dalam suatu proyek hanya berlaku untuk proyek tersebut dan sumber dayanya.

Batas cakupan sumber daya

File, asisten, penyimpanan, dan utas hanya berlaku dalam proyek masing-masing. Anggota non-admin di luar proyek tersebut tidak dapat mengakses sumber dayanya, dan sumber daya tidak dapat dipindahkan antarproyek.

Pengecualian berlaku untuk model yang telah di-fine-tune dalam proyek Bawaan: model tersebut dapat diakses dari proyek lain.

Kelola anggota proyek

Undang seseorang ke organisasi Anda

Saat mengundang seseorang ke organisasi, Anda dapat menyertakan akses ke proyek Bawaan dengan memilih opsi tersebut di formulir undangan. Biarkan opsi tersebut tidak dipilih jika Anda tidak ingin memberikan akses ke proyek Bawaan. Anggota baru organisasi tidak otomatis ditambahkan ke proyek Bawaan.

Anda tidak perlu membuat proyek lain sebelum mengundang seseorang. Anda juga dapat menambahkan seseorang ke proyek setelah mereka menerima undangan organisasi.

Undangan yang dikirim melalui API Admin mengikuti aturan untuk endpoint /organization/invites.

Tambahkan anggota organisasi ke proyek

Pemilik organisasi dan proyek dapat menambahkan anggota:

1. Buka pengaturan organisasi.

2. Pilih proyek, lalu buka Anggota.

3. Pilih + Tambahkan anggota.

4. Pilih pengguna dan tetapkan peran Anggota atau Pemilik.

Daftar pengguna menampilkan pengguna organisasi dengan peran Pembaca. Daftar ini tidak mencakup akun layanan.

Jika undangan gagal dikirim melalui antarmuka pengguna atau API Admin, pastikan proyek tujuan ada dan tidak diarsipkan sebelum mengirim ulang undangan.

Ubah peran atau hapus anggota

Pemilik organisasi dan proyek dapat mengubah peran pengguna dalam proyek atau menghapus pengguna dari proyek tersebut.

1. Buka pengaturan organisasi.

2. Pilih proyek, lalu buka Anggota.

3. Tetapkan peran pengguna menjadi Anggota atau Pemilik, atau pilih Hapus untuk menghapusnya.

Buat dan kelola akun layanan

Akun layanan menyediakan akses untuk sistem, bukan mewakili pengguna perorangan. Cakupan akun layanan terbatas pada proyek.

Pembuatan akun layanan memerlukan izin pengelolaan akun layanan. Pemilik organisasi dan proyek memiliki izin ini.

Buat akun layanan

1. Pilih proyek di pemilih proyek.

2. Buka pengaturan organisasi dan pilih proyek.

3. Buka Anggota dan pilih + Akun layanan.

4. Masukkan ID akun layanan yang unik menggunakan huruf, angka, dan tanda hubung.

5. Pilih Buat.

Format ID yang sama berlaku baik saat Anda membuat akun layanan dari pengaturan tingkat organisasi maupun proyek.

Akun layanan yang dibuat untuk suatu proyek hanya berlaku untuk proyek tersebut dan tidak dapat digunakan di luar proyek itu.

Simpan kunci rahasia

Pembuatan akun layanan langsung menghasilkan kunci API dan menampilkan kunci rahasianya. Simpan kunci rahasia dengan aman. Anda tidak dapat melihatnya lagi melalui akun OpenAI Anda. Jika kunci tersebut hilang, buat kunci baru.

Secara default, kunci akun layanan dapat membaca dan menulis semua sumber daya API dalam proyeknya. Anda dapat mengubah izin tersebut nanti di pengaturan Kunci API proyek.

Akun layanan ditampilkan bersama pengguna di pengaturan Anggota proyek. Kelola akses akun layanan ke proyek dengan langkah perubahan peran dan penghapusan yang sama seperti anggota proyek lainnya.

Semua akun layanan juga ditampilkan bersama pengguna di halaman Anggota organisasi, termasuk akun yang dibuat dari pengaturan tingkat organisasi dan proyek.

Dari menu Anggota organisasi, Anda dapat mengubah peran akun layanan atau memilih Hapus.

Buat dan kelola kunci API

Setiap proyek memiliki kunci API sendiri:

1. Buka pengaturan organisasi.

2. Pilih proyek, lalu buka Kunci API.

3. Pilih + Buat kunci rahasia baru untuk membuat kunci, atau pilih ikon edit di samping kunci yang ada untuk mengubah izinnya.

Pilih izin kunci

Untuk kunci milik pengguna, Anda dapat menetapkan izin saat membuat kunci atau mengeditnya nanti:

• Semua: Izin penuh. Ini adalah pengaturan default.

• Terbatas: Pilih cakupan untuk sumber daya atau endpoint tertentu. Opsi yang tersedia bergantung pada sumber daya dan dapat mencakup Tidak Ada, Baca, Tulis, atau izin khusus untuk permintaan tertentu.

• Hanya Baca: Izin baca untuk semua endpoint.

Misalnya, kunci terbatas dapat diatur tanpa akses baca dan tulis ke endpoint /v1/assistants.

Pembuatan kunci akun layanan memerlukan izin pengelolaan akun layanan. Jika opsi tersebut tidak terlihat, mintalah pemilik organisasi atau proyek untuk membuat kunci akun layanan. Dialog pembuatan kunci tidak menampilkan kontrol izin ini untuk kunci akun layanan; ubah izinnya setelah pembuatan melalui pengaturan Kunci API proyek.

Konfigurasikan akses model dan batas laju

Pengelolaan batas laju proyek memerlukan izin administratif. Pemilik organisasi memiliki izin ini, dan pemilik proyek juga dapat mengelola batas laju proyek melalui API pengelolaan.

1. Buka pengaturan organisasi.

2. Pilih proyek, lalu buka Batas.

3. Gunakan Penggunaan model untuk memilih model yang dapat digunakan proyek.

4. Tetapkan batas laju untuk setiap model sesuai kebutuhan.

Tetapkan batas dan peringatan pengeluaran

Batas pengeluaran API bulanan tersedia di tingkat organisasi maupun proyek. Anda memerlukan izin untuk mengelola pengaturan organisasi atau proyek terkait sebelum mengubah batas.

Batas pengeluaran dapat digunakan untuk memantau pengeluaran tanpa menghentikan permintaan. Aktifkan Terapkan batas tegas jika Anda ingin permintaan API gagal setelah pengeluaran yang terlacak mencapai batas. Penerapan batas tidak berlangsung seketika, sehingga pengeluaran yang tercatat bisa sedikit melebihi jumlah yang ditetapkan.

Peringatan pengeluaran memberi tahu Anda saat ambang batas tercapai; peringatan ini tidak menghentikan permintaan.

Tetapkan batas pengeluaran organisasi

1. Buka pengaturan organisasi.

2. Buka Batas dan cari Pengeluaran.

Tetapkan batas pengeluaran proyek

1. Buka pengaturan organisasi.

2. Pilih proyek, lalu buka Batas.

3. Tetapkan nilai Batas pengeluaran bulanan dan Beri peringatan saat pengeluaran mencapai.

4. Aktifkan Terapkan sebuah batas tegas jika Anda ingin menghentikan lalu lintas API setelah pengeluaran yang terlacak mencapai batas.

Anda juga dapat mengubah Penggunaan model di halaman ini.

Kelola peringatan pengeluaran

Saat Anda membuat batas pengeluaran proyek, secara default peringatan juga dibuat pada 100% dari batas tersebut. Pilih Tambahkan Peringatan untuk menambahkan peringatan pada ambang batas lain.

Pemilik organisasi dan proyek menerima peringatan pengeluaran proyek. Anda dapat menambahkan penerima email lain di pengaturan peringatan.

Untuk langkah konfigurasi dan cara penerapan batas terkini, lihat panduan batas pengeluaran.

Lihat penggunaan dan penagihan

Aktivitas penggunaan dapat dirinci berdasarkan proyek, dan Anda dapat melihat tagihan serta menetapkan batas pengeluaran untuk setiap proyek.

Akses ke Dasbor Penggunaan proyek bergantung pada peran Anda di organisasi dan pengaturan visibilitas Dasbor Penggunaan. Menjadi pemilik proyek saja tidak otomatis memberikan akses.

Jika Anda tidak dapat melihat Dasbor Penggunaan proyek, periksa apakah visibilitas diatur ke Terlihat oleh pemilik organisasi.

Kelola penyimpanan file

Setiap proyek memiliki kuota penyimpanan file sebesar 100 GB. Jika kuota terlampaui, Anda mungkin melihat pesan kesalahan ini:

Anda telah melampaui kuota penyimpanan file. Penyimpanan file organisasi dibatasi hingga 100 GB. Kurangi ukuran file atau hubungi dukungan.

Hapus file yang tidak digunakan untuk mengosongkan ruang penyimpanan. Anda dapat melihat daftar file tersimpan melalui API untuk menemukan file yang tidak lagi diperlukan.

Arsipkan proyek

Pemilik organisasi dan proyek dapat mengarsipkan proyek dari halaman Proyek atau pengaturan proyek masing-masing. Masukkan nama proyek saat diminta untuk mengonfirmasi.

Pengarsipan bersifat permanen: proyek yang telah diarsipkan tidak dapat dipulihkan.

Untuk melihat proyek yang diarsipkan, buka tab Diarsipkan di halaman Proyek.

Proyek tidak dapat dihapus. OpenAI menyimpan riwayat proyek untuk melacak penggunaan dan penagihan.