OpenAI
Halaman ini diterjemahkan oleh mesin. Lihat artikel asli dalam bahasa Inggris.

Mengelola project di platform API

Diperbarui: 8 days ago

Proyek bertujuan memberi pelanggan kemampuan untuk mengatur pekerjaan mereka. Organisasi dapat mengelola akses dan batas, menyediakan akun layanan (melalui UI), dan melacak penggunaan terhadap cakupan terbatas dalam proyek (mis. model, kapabilitas, thread, assistant, fine-tuning, penyimpanan, dll.). Aktivitas penggunaan dapat diuraikan berdasarkan proyek, dan pengguna dapat melihat penagihan serta menetapkan anggaran per proyek.

Pemilik organisasi dapat melihat semua proyek Aktif dan Diarsipkan mereka di halaman Proyek. Pelajari selengkapnya tentang peran pengguna dan izin di Platform API.

Image

Siapa yang dapat membuat proyek?

Hanya pemilik organisasi yang dapat membuat proyek. Lihat peran dan izin untuk informasi selengkapnya.

Untuk beralih antarorganisasi, arahkan kursor ke nama organisasi Anda di kiri atas halaman dan pilih organisasi dari daftar:

Projects page with the organization switcher open, listing Personal and Staging organizations

Untuk organisasi yang menggunakan paket penagihan terkonsolidasi, sub-org diidentifikasi secara terpisah. Proyek tidak dapat dibuat dalam sub-org.

Image

Bagaimana cara kerja project?

Setiap organisasi menyertakan “Project default” yang tidak dapat dihapus. Anda dapat mengonfigurasi rate limit, izin model virtual, dan anggaran pengeluaran (per November 2024). Project ini mewarisi konfigurasi lengkap organisasi, sehingga Anda tidak dapat langsung menambahkan anggota atau service account ke dalamnya.

Bagaimana cara membuat project?

Pertama, arahkan kursor ke nama project di sudut kiri halaman lalu pilih Create project.

API platform project menu with Create project highlighted under Default project

Berikan nama, deskripsi, dan situs web untuk project Anda lalu pilih Create.

Create a new project dialog in the API platform with fields for project name, use case, and business website

Bagaimana cara menambahkan pengguna ke proyek?

Anggota organisasi yang baru ditambahkan tidak otomatis ditambahkan ke “Proyek default”. Anggota baru dapat diundang ke proyek baik saat mereka diundang ke organisasi (dengan mengaktifkan kotak centang “Undang ke proyek default”) maupun setelah anggota menerima undangan organisasi.

Pengguna yang diundang melalui Admin API mengikuti aturan yang dijelaskan oleh endpoint /organization/invites.

Jika Anda mengalami kesalahan saat mengundang pengguna ke proyek melalui UI atau Admin API, pastikan terlebih dahulu bahwa proyek target ada dan tidak diarsipkan sebelum mengirim ulang undangan.

Pemilik organisasi otomatis ditambahkan sebagai pemilik ke proyek baru yang dibuat dalam organisasi.

Apa saja peran pengguna yang berbeda dalam organisasi dan proyek, dan izin apa yang dimilikinya?

Sementara Organisasi memiliki peran ‘pemilik’ dan ‘pembaca’, proyek memiliki peran ‘pemilik’ dan ‘anggota’. Anggota proyek serupa dengan pembaca organisasi. Lihat tabel di bawah untuk deskripsi yang lebih terperinci tentang izin yang menyertai setiap peran pengguna.

PeranCakupanDeskripsi
PemilikOrganisasiDapat membuat/melihat semua proyek, semua pengguna, semua kunci API. Memiliki kemampuan untuk memantau semua proyek dalam organisasi melalui

halaman Proyek
. Dapat menetapkan anggaran organisasi dan anggaran proyek. Dapat memberikan izin untuk melihat informasi penggunaan bagi orang lain di org. Dapat mengarsipkan proyek.
PembacaOrganisasiDapat melakukan inferensi, menggunakan sumber daya, dan membuat kunci dalam proyek mereka. Dapat ditambahkan ke proyek.
Tidak dapat membuat proyek dan mengelola pengguna.
PemilikProyekDapat menambahkan pengguna lain ke proyek dan mengganti nama proyek, serta memiliki semua kemampuan Anggota. Dapat menetapkan anggaran proyek. Dapat mengarsipkan proyek.
AnggotaProyekDapat melakukan inferensi, menggunakan sumber daya, dan membuat kunci di tingkat proyek.

Jika saya bukan Pemilik dalam organisasi, apa yang dapat saya akses?

Pengguna yang bukan Pemilik dalam organisasi hanya dapat melihat proyek tempat mereka menjadi anggota. Hanya pemilik organisasi yang dapat melihat semua proyek, anggota, dan kunci API di tingkat proyek, serta memiliki akses ke halaman Proyek.

  • Hanya anggota proyek (dan pemilik organisasi) yang dapat melihat model fine-tuned yang telah dibuat dalam proyek tersebut, thread dari Assistant yang dibuat, atau file apa pun yang telah ditambahkan.

  • Anggota proyek dapat melihat siapa saja anggota lain dari proyek tersebut dan peran mereka (yaitu Pemilik atau Anggota).

Bagaimana cara memperbarui peran proyek pengguna atau menghapus pengguna dari proyek?

Hanya Pemilik proyek yang dapat memperbarui peran proyek pengguna atau menghapus pengguna dari proyek. Lihat peran dan izin untuk informasi selengkapnya.

Untuk memperbarui pengguna dalam proyek, buka pengaturan organisasi Anda, pilih proyek, lalu klik Anggota. Anda memiliki opsi untuk menetapkan peran setiap anggota sebagai Anggota atau Pemilik. Anda juga dapat memilih Hapus untuk menghapus pengguna dari proyek.

Apa itu service account, dan apa bedanya dengan akun pengguna biasa?

Service account bertindak sebagai pseudo-user yang dirancang untuk akses sistem, berbeda dari akun pengguna individual. Hanya owner organisasi dan project yang dapat membuat service account.

Service account hanya dicakup ke project.

Menambahkan anggota ke proyek

Jika Anda mengklik tombol + Add member, Anda akan melihat daftar pengguna di organisasi Anda dengan peran Reader. Jika Anda ingin menambahkan pengguna yang saat ini belum berada dalam organisasi Anda, Anda perlu menambahkannya ke organisasi terlebih dahulu (Anda dapat membiarkan kotak centang “Tambahkan ke Proyek Default” tidak dicentang jika Anda tidak ingin memberi pengguna ini akses yang lebih luas). Daftar ini tidak akan mencakup akun layanan. Pada langkah ini, Anda dapat memilih apakah peran mereka adalah Owner atau Member:

Project members with Add team members dialog assigning a user the Member role

Saat menambahkan anggota tim, Anda harus menetapkan peran Anggota atau Pemilik kepada mereka. Anggota proyek dapat membuat permintaan API yang membaca atau mengubah data, sedangkan pemilik proyek juga dapat mengubah pengaturan proyek dan anggaran proyek serta mengelola anggota proyek. Lihat peran dan izin untuk informasi selengkapnya.

Cara membuat akun layanan untuk proyek

Pertama, buka proyek yang ingin Anda buatkan akun layanan dengan memilih dari menu dropdown yang ada di bilah navigasi:

API platform project switcher open with options to create a project or manage projects

Kemudian, buka pengaturan organisasi Anda -> Proyek -> Anggota -> klik + Service account:

Service account yang dibuat di tingkat project bersifat unik untuk project tersebut dan tidak dapat digunakan di luar project tempat service account itu dibuat.

Project Members page with Create a service account dialog after selecting the Service account option

Menamai service account

Terlepas dari apakah Anda membuat service account di tingkat organisasi atau membuat yang unik untuk project, saat Anda membuat service account, Anda dapat membuat ID service account unik yang terdiri dari huruf, angka, dan tanda hubung agar service account mudah diidentifikasi.

Simpan kunci API akun layanan

Setelah memilih tombol Buat, kunci API segera dibuat untuk akun layanan dan kunci rahasia akan ditampilkan. Simpan kunci rahasia ini di tempat yang aman dan terlindungi. Demi alasan keamanan, Anda tidak akan dapat melihatnya lagi melalui akun OpenAI Anda. Jika Anda kehilangan kunci rahasia ini, Anda perlu membuat yang baru.

Members page with Save your key modal after creating a service account

Izin kunci API akun layanan secara default adalah membaca dan menulis semua sumber daya API proyek. Izin ini dapat diperbarui di pengaturan Kunci API proyek Anda.

Akun layanan dicantumkan bersama anggota proyek di halaman pengaturan anggota proyek Anda. Lihat di sini untuk mempelajari lebih lanjut cara memperbarui atau menghapus akses akun layanan di halaman pengaturan anggota proyek Anda.

Semua akun layanan di seluruh proyek dan organisasi akan ditampilkan bersama pengguna manusia Anda di halaman anggota tingkat organisasi.

Akun layanan dikelola seperti akun biasa. Dari menu Organisasi -> Anggota, Anda dapat Menghapus akun layanan atau memperbarui perannya:

OpenAI API Members settings with a service account role menu open for Reader or Owner

Bagaimana cara mengelola kunci API dalam proyek organisasi saya?

Anda dapat membuat dan mengelola kunci API untuk setiap proyek di halaman pengaturan proyek tersebut. Di pengaturan organisasi Anda, pilih proyek, lalu klik Kunci API.

Untuk membuat kunci rahasia baru, pilih + Create new secret key. Anda juga dapat memilih ikon Edit di samping kunci rahasia untuk mengedit izinnya.

API keys page for a project with the Create new secret key button highlighted

Anda dapat menetapkan izin untuk setiap kunci API saat membuat kunci rahasia baru atau dengan mengedit kunci yang ada.

Tersedia tiga tingkat izin: Semua, Dibatasi, dan Hanya Baca.

  • Semua — Izin penuh ditetapkan untuk kunci rahasia. Ini adalah pengaturan default.

  • Dibatasi — Memungkinkan pengguna menetapkan izin Tidak Ada, Baca, dan Tulis untuk setiap endpoint.

    • Misalnya, Anda membuat kunci API yang secara khusus tidak memiliki izin untuk Membaca atau Menulis ke endpoint /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Hanya Baca — Izin baca ditetapkan untuk semua endpoint.

Bagaimana akses dikelola untuk pengguna yang termasuk dalam beberapa project atau organisasi?

Pengguna dapat menjadi anggota sebanyak mungkin project yang diperlukan. Dalam sebuah project, pengguna dapat membuat kunci API pribadi yang dicakup dan dibatasi untuk mengakses project tersebut beserta resource-nya.

Bagaimana cara menetapkan dan mengelola batas laju untuk proyek organisasi saya?

Hanya Pemilik organisasi yang dapat menetapkan dan mengelola batas laju tingkat proyek. Lihat peran dan izin untuk informasi selengkapnya.

Di pengaturan organisasi Anda, klik proyek yang ingin Anda perbarui dan pilih Batas di bagian Proyek pada daftar navigasi. Anda dapat memperbarui Penggunaan Model Anda di halaman ini.

Penggunaan model memungkinkan Anda mengonfigurasi model mana yang dapat digunakan oleh proyek, dan batas laju dapat ditetapkan untuk setiap model sesuai kebutuhan.

Bagaimana cara menetapkan dan mengelola anggaran untuk proyek organisasi saya?

Hanya Pemilik organisasi dan Pemilik proyek yang dapat menetapkan dan mengelola anggaran proyek. Lihat peran dan izin untuk informasi selengkapnya. Untuk mengubah batas di tingkat organisasi, di pengaturan organisasi Anda, klik Batas, lalu gulir ke bawah ke Batas penggunaan.

Project Limits page with organization budget controls, usage alerts, and model rate limits table

Untuk menetapkan batas proyek Anda, di pengaturan organisasi Anda, klik proyek yang ingin Anda perbarui dan pilih Batas. Anda dapat memperbarui Anggaran bulanan, Ambang notifikasi, dan Penggunaan Model Anda.

Menetapkan anggaran bulanan memungkinkan Anda membuat ambang pengeluaran lunak untuk proyek Anda. Saat penggunaan melebihi batas ini dalam bulan kalender tertentu (UTC), permintaan API akan tetap diproses tanpa gangguan. Fitur ini dirancang untuk membantu Anda memantau penggunaan melalui peringatan anggaran, tetapi tidak memberlakukan batas keras pada pengeluaran. Saat anggaran proyek dibuat, secara default, peringatan akan dibuat pada ambang 100%. Anggaran tambahan pada ambang yang berbeda dapat ditetapkan dengan mengklik Tambahkan Peringatan.

Harap diperhatikan bahwa pemilik organisasi dan pemilik proyek akan selalu menerima pesan ini dan hal ini tidak dapat disesuaikan.

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

Bagaimana cara menghapus atau mengarsipkan proyek?

Proyek dapat diarsipkan melalui halaman daftar proyek baru atau di pengaturan proyek individual. Setelah proyek diarsipkan, proyek tidak dapat dipulihkan. Saat melanjutkan pengarsipan, Anda akan diminta memasukkan nama proyek untuk melanjutkan.

Anda dapat melihat daftar semua proyek yang diarsipkan melalui tab “Diarsipkan” di halaman daftar proyek yang sama.

API platform Projects page with the Archived tab selected to view archived projects

Menghapus proyek tidak dimungkinkan; kami menyimpan riwayat semua proyek untuk memastikan kesinambungan pelacakan penggunaan dan penagihan.

Apakah ada batas jumlah project yang dapat saya miliki dalam organisasi saya?

Secara default, organisasi dapat membuat hingga 2.000 project.

Bisakah resource dibagikan antar project?

Resource project (seperti file, assistants, penyimpanan, atau thread) dicakup ke project dan tidak dapat diakses oleh anggota non-admin di luar project. Selain itu, resource tidak dapat dipindahkan antar project.

Satu-satunya pengecualian adalah fine-tune di "Project default" dapat diakses dari project lain.

Berapa kuota penyimpanan file per project?

OpenAI saat ini mendukung kuota penyimpanan file sebesar 100 GB file per project.

Jika kuota ini terlampaui, Anda akan melihat error berikut:

Anda telah melampaui kuota penyimpanan file. Organisasi dibatasi hingga 100 GB file. Harap kurangi ukuran file atau hubungi dukungan.

Kami menyarankan Anda menghapus file yang tidak digunakan yang tersimpan di akun Anda. Sebagai referensi, Anda dapat melihat dan mencantumkan file dengan API.

Saya adalah pemilik proyek, mengapa saya tidak dapat melihat Dasbor Penggunaan untuk proyek saya?

Visibilitas Dasbor Penggunaan proyek tidak terkait dengan peran pengguna dalam proyek. Sebaliknya, hal ini ditentukan oleh peran Anda dalam organisasi dan pengaturan di https://platform.openai.com/settings/organization/data-controls/visibility

Project setting for Usage dashboard visibility with Visible to organization owners selected

Jika Anda tidak dapat melihat Dasbor Penggunaan, pengaturan ini kemungkinan disetel ke “Terlihat oleh pemilik organisasi”.

Apakah artikel ini membantu?