OpenAI
Halaman ini diterjemah oleh mesin. Lihat artikel asal dalam bahasa Inggeris.

Mengurus projek dalam Platform API

Ketahui cara membuat dan mengurus projek API OpenAI, termasuk ahli, peranan, akaun perkhidmatan, kunci API, had penggunaan dan belanjawan.

Dikemas kini: 16 days ago

Projek bertujuan memberi pelanggan keupayaan untuk mengatur kerja mereka. Organisasi boleh mengurus akses dan had, menyediakan akaun perkhidmatan (melalui UI) serta menjejaki penggunaan dalam skop terhad sesebuah projek (misalnya model, keupayaan, urutan, pembantu, penalaan halus, storan dan sebagainya). Aktiviti penggunaan boleh dipecahkan mengikut projek, manakala pengguna boleh melihat pengebilan dan menetapkan had perbelanjaan bagi setiap projek.

Pemilik organisasi boleh melihat semua projek Aktif dan Diarkibkan mereka pada halaman Projek. Ketahui lebih lanjut tentang peranan dan kebenaran pengguna dalam Platform API.

Image

Siapakah yang boleh membuat projek?

Hanya pemilik organisasi boleh membuat projek. Rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut.

Untuk bertukar antara organisasi, tuding pada nama organisasi anda di bahagian atas kiri halaman dan pilih organisasi daripada senarai:

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

Bagi organisasi yang menggunakan pelan pengebilan disatukan, suborganisasi dikenal pasti secara berasingan. Projek tidak boleh dibuat dalam suborganisasi.

Image

Bagaimanakah projek berfungsi?

Setiap organisasi merangkumi “Projek lalai” yang tidak boleh dipadamkan. Anda boleh mengkonfigurasikan had kadar, kebenaran model maya dan had perbelanjaan (setakat November 2024). Projek ini mewarisi konfigurasi penuh organisasi, jadi anda tidak boleh menambahkan ahli atau akaun perkhidmatan secara terus padanya.

Bagaimanakah cara membuat projek?

Mula-mula, tuding pada nama projek di sudut kiri halaman dan pilih Buat projek.

API platform project menu with Create project highlighted under Default project

Berikan nama, penerangan dan laman web untuk projek anda, kemudian pilih Buat.

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

Bagaimanakah cara menambahkan pengguna pada projek?

Ahli organisasi yang baru ditambahkan tidak ditambahkan secara automatik pada “Projek lalai”. Ahli baharu boleh dijemput menyertai projek sama ada ketika mereka dijemput menyertai organisasi (dengan menandai kotak pilihan "Jemput ke projek lalai") atau selepas ahli menerima jemputan organisasi.

Pengguna yang dijemput melalui API Pentadbir tertakluk pada peraturan yang diterangkan oleh titik akhir /organization/invites.

Jika ralat berlaku semasa menjemput pengguna menyertai projek melalui UI atau API Pentadbir, pastikan dahulu projek sasaran wujud dan belum diarkibkan sebelum menghantar semula jemputan.

Pemilik organisasi ditambahkan secara automatik sebagai pemilik projek baharu yang dibuat dalam organisasi.

Apakah peranan pengguna yang berbeza dalam organisasi dan projek, serta apakah kebenaran yang diberikan oleh setiap peranan?

Walaupun organisasi mempunyai peranan ‘pemilik’ dan ‘pembaca’, projek mempunyai peranan ‘pemilik’ dan ‘ahli’. Ahli projek adalah setara dengan pembaca organisasi. Rujuk jadual di bawah untuk mendapatkan penerangan yang lebih terperinci tentang kebenaran bagi setiap peranan pengguna.

PerananSkopPenerangan
PemilikOrganisasiBoleh membuat dan melihat semua projek, semua pengguna serta semua kunci API. Boleh memantau semua projek dalam organisasi melalui

halaman Projek
. Boleh menetapkan had perbelanjaan organisasi dan projek. Boleh memberikan kebenaran kepada pengguna lain dalam organisasi untuk melihat maklumat penggunaan. Boleh mengarkibkan projek.
PembacaOrganisasiBoleh melakukan inferens, menggunakan sumber dan membuat kunci dalam projek mereka. Boleh ditambahkan pada projek.
Tidak boleh membuat projek dan mengurus pengguna.
PemilikProjekBoleh menambahkan pengguna lain pada projek dan menamakan semula projek, serta mempunyai semua keupayaan Ahli. Boleh menetapkan had perbelanjaan projek. Boleh mengarkibkan projek.
AhliProjekBoleh melakukan inferens, menggunakan sumber dan membuat kunci pada peringkat projek.

Jika saya bukan Pemilik dalam organisasi, apakah yang boleh saya akses?

Pengguna yang bukan Pemilik dalam organisasi hanya boleh melihat projek yang mereka sertai. Hanya pemilik organisasi boleh melihat semua projek, ahli dan kunci API pada peringkat projek serta mengakses halaman Projek.

  • Hanya ahli projek (dan pemilik organisasi) boleh melihat model yang ditala halus yang dibuat dalam projek tersebut, urutan daripada mana-mana Pembantu yang dibuat atau fail yang ditambahkan.

  • Ahli projek boleh melihat semua ahli lain dalam projek tersebut dan peranan mereka (iaitu Pemilik atau Ahli).

Bagaimanakah cara mengemas kini peranan projek pengguna atau mengalih keluar pengguna daripada projek?

Hanya Pemilik projek boleh mengemas kini peranan projek pengguna atau mengalih keluar pengguna daripada projek. Rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut.

Untuk mengemas kini pengguna dalam projek, pergi ke tetapan organisasi anda, pilih projek dan klik Ahli. Anda boleh menetapkan peranan setiap ahli sebagai Ahli atau Pemilik. Anda juga boleh memilih Alih keluar untuk mengalih keluar pengguna daripada projek.

Apakah itu akaun perkhidmatan dan bagaimanakah akaun tersebut berbeza daripada akaun pengguna biasa?

Akaun perkhidmatan bertindak sebagai pengguna semu yang direka untuk akses sistem dan berbeza daripada akaun pengguna individu. Hanya pemilik organisasi dan projek boleh membuat akaun perkhidmatan.

Akaun perkhidmatan hanya terhad kepada projek.

Tambahkan ahli pada projek

Jika anda mengklik butang + Tambah ahli, anda akan melihat senarai pengguna dalam organisasi anda yang mempunyai peranan Pembaca. Jika anda mahu menambahkan pengguna yang belum berada dalam organisasi anda, anda perlu menambahkan mereka pada organisasi terlebih dahulu (anda boleh membiarkan kotak pilihan "Tambah pada Projek Lalai" tidak ditandai jika anda tidak mahu memberikan akses yang lebih luas kepada pengguna ini). Senarai ini tidak menyertakan akaun perkhidmatan. Dalam langkah ini, anda boleh memilih sama ada peranan mereka ialah Pemilik atau Ahli:

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

Apabila menambahkan ahli pasukan, anda mesti memberikan peranan Ahli atau Pemilik kepada mereka. Ahli projek boleh membuat permintaan API yang membaca atau mengubah suai data, manakala pemilik projek juga boleh mengubah suai tetapan dan had perbelanjaan projek serta mengurus ahli projek. Rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut.

Cara membuat akaun perkhidmatan untuk projek

Mula-mula, pergi ke projek yang ingin dibuatkan akaun perkhidmatan dengan memilihnya daripada menu juntai bawah dalam bar navigasi:

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

Kemudian, pergi ke tetapan organisasi anda -> Projek -> Ahli -> klik + Akaun perkhidmatan:

Akaun perkhidmatan yang dibuat pada peringkat projek adalah khusus untuk projek tersebut dan tidak boleh digunakan di luar projek tempat akaun itu dibuat.

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

Menamakan akaun perkhidmatan

Sama ada anda membuat akaun perkhidmatan pada peringkat organisasi atau akaun yang khusus untuk sesuatu projek, semasa membuatnya anda boleh mencipta ID akaun perkhidmatan unik yang terdiri daripada huruf, nombor dan tanda sempang agar akaun tersebut mudah dikenal pasti.

Simpan kunci API akaun perkhidmatan

Selepas memilih butang Buat, kunci API akan dibuat serta-merta untuk akaun perkhidmatan dan kunci rahsia akan dipaparkan. Simpan kunci rahsia ini di tempat yang selamat dan terjamin. Atas sebab keselamatan, anda tidak akan dapat melihatnya lagi melalui akaun OpenAI anda. Jika kunci rahsia ini hilang, anda perlu menjana kunci baharu.

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

Secara lalai, kunci API akaun perkhidmatan mempunyai kebenaran untuk membaca dan menulis semua sumber API projek. Kebenaran ini boleh dikemas kini dalam tetapan Kunci API projek anda.

Akaun perkhidmatan disenaraikan bersama ahli projek pada halaman tetapan ahli projek anda. Rujuk di sini untuk mengetahui lebih lanjut tentang cara mengemas kini atau mengalih keluar akses akaun perkhidmatan pada halaman tetapan ahli projek anda.

Semua akaun perkhidmatan daripada projek dan organisasi akan dipaparkan bersama pengguna manusia anda pada halaman ahli peringkat organisasi.

Akaun perkhidmatan diurus seperti akaun biasa. Daripada Organisasi -> menu Ahli, anda boleh Mengalih keluar akaun perkhidmatan atau mengemas kini peranannya:

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

Bagaimanakah cara mengurus kunci API dalam projek organisasi saya?

Anda boleh membuat dan mengurus kunci API bagi setiap projek pada halaman tetapan projek tersebut. Dalam tetapan organisasi anda, pilih projek dan klik Kunci API.

Untuk membuat kunci rahsia baharu, pilih + Buat kunci rahsia baharu. Anda juga boleh memilih ikon Edit di sebelah kunci rahsia untuk mengedit kebenarannya.

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

Anda boleh menetapkan kebenaran bagi setiap kunci API semasa membuat kunci rahsia baharu atau dengan mengedit kunci sedia ada.

Terdapat tiga peringkat kebenaran: Semua, Terhad dan Baca Sahaja.

  • Semua — Kebenaran penuh ditetapkan untuk kunci rahsia. Ini ialah tetapan lalai.

  • Terhad — Membolehkan pengguna menetapkan kebenaran Tiada, Baca dan Tulis bagi setiap titik akhir.

  • Sebagai contoh, anda membuat kunci API yang secara khusus tidak mempunyai kebenaran Baca atau Tulis untuk titik akhir /v1/assistants:

Create new secret key dialog in the API platform with Restricted permissions selected
  • Baca Sahaja — Kebenaran membaca ditetapkan untuk semua titik akhir.

Bagaimanakah akses diurus untuk pengguna yang tergolong dalam berbilang projek atau organisasi?

Pengguna boleh menjadi ahli sebanyak mana projek yang diperlukan. Dalam projek, pengguna boleh menjana kunci API peribadi yang skopnya terhad kepada akses projek tersebut dan sumbernya.

Bagaimanakah cara menetapkan dan mengurus had kadar untuk projek organisasi saya?

Hanya Pemilik organisasi boleh menetapkan dan mengurus had kadar pada peringkat projek. Rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut.

Dalam tetapan organisasi anda, klik projek yang ingin dikemas kini dan pilih Had dalam bahagian Projek pada senarai navigasi. Anda boleh mengemas kini Penggunaan Model pada halaman ini.

Penggunaan model membolehkan anda mengkonfigurasikan model yang boleh digunakan oleh projek, manakala had kadar boleh ditetapkan bagi setiap model mengikut keperluan.

Bagaimanakah cara menetapkan dan mengurus had perbelanjaan untuk projek organisasi saya?

Hanya Pemilik organisasi dan Pemilik projek boleh menetapkan serta mengurus had perbelanjaan projek. Rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut. Untuk mengubah had pada peringkat organisasi, dalam tetapan organisasi anda, klik Had, kemudian tatal ke bawah kepada Had penggunaan.

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

Untuk menetapkan had projek, dalam tetapan organisasi anda, klik projek yang ingin dikemas kini dan pilih Had. Anda boleh mengemas kini Had perbelanjaan bulanan, Ambang pemberitahuan dan Penggunaan Model.

Penetapan had perbelanjaan bulanan membolehkan anda menetapkan ambang perbelanjaan fleksibel untuk projek anda. Apabila penggunaan melebihi had ini dalam bulan kalendar tertentu (UTC), permintaan API akan terus diproses tanpa gangguan. Ciri ini direka untuk membantu anda memantau penggunaan melalui makluman had perbelanjaan, tetapi tidak menguatkuasakan had mutlak pada perbelanjaan. Apabila had perbelanjaan projek dibuat, secara lalai makluman akan dibuat pada ambang 100%. Makluman tambahan pada ambang yang berbeza boleh ditetapkan dengan mengklik Tambah Makluman.

Harap maklum bahawa pemilik organisasi dan pemilik projek akan sentiasa menerima mesej ini dan perkara ini tidak boleh disesuaikan.

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

Bagaimanakah cara menetapkan had perbelanjaan untuk organisasi atau projek saya?

OpenAI kini menyokong had perbelanjaan API bulanan pada peringkat organisasi dan projek. Had perbelanjaan boleh memantau perbelanjaan tanpa penguatkuasaan, atau anda boleh menguatkuasakannya sebagai had mutlak supaya permintaan API gagal selepas perbelanjaan mencapai had tersebut. Untuk langkah konfigurasi dan tingkah laku terkini, lihat Had perbelanjaan dalam dokumentasi pembangun.

Bagaimanakah cara memadamkan atau mengarkibkan projek?

Projek boleh diarkibkan melalui halaman senarai projek baharu atau melalui tetapan projek berkenaan. Selepas projek diarkibkan, projek tersebut tidak boleh dipulihkan. Apabila meneruskan proses pengarkiban, anda akan diminta memasukkan nama projek untuk meneruskan.

Anda boleh melihat senarai semua projek yang diarkibkan melalui tab “Diarkibkan” pada halaman senarai projek yang sama.

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

Projek tidak boleh dipadamkan. Kami menyimpan sejarah semua projek bagi memastikan kesinambungan penjejakan penggunaan dan pengebilan.

Adakah terdapat had bilangan projek yang boleh dimiliki dalam organisasi saya?

Secara lalai, organisasi boleh membuat sehingga 2,000 projek.

Bolehkah sumber dikongsi antara projek?

Sumber projek (seperti fail, pembantu, storan atau urutan) terhad kepada projek tersebut dan tidak boleh diakses oleh ahli bukan pentadbir dari luar projek. Selain itu, sumber tidak boleh dipindahkan antara projek.

Satu-satunya pengecualian ialah model yang ditala halus dalam "Projek lalai" boleh diakses daripada projek lain.

Berapakah kuota storan fail bagi setiap projek?

OpenAI kini menyokong kuota storan fail sebanyak 100 GB bagi setiap projek.

Jika kuota ini dilampaui, anda akan melihat ralat berikut:

Anda telah melebihi kuota storan fail. Organisasi dihadkan kepada 100 GB fail. Sila kurangkan saiz fail atau hubungi sokongan.

Kami mengesyorkan agar anda memadamkan fail tidak digunakan yang disimpan dalam akaun anda. Sebagai rujukan, anda boleh melihat dan menyenaraikan fail menggunakan API.

Saya pemilik projek. Mengapakah saya tidak dapat melihat Papan Pemuka Penggunaan projek saya?

Keterlihatan Papan Pemuka Penggunaan sesuatu projek tidak berkaitan dengan peranan pengguna dalam projek tersebut. Sebaliknya, keterlihatan ditentukan oleh peranan anda dalam organisasi dan tetapan 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 Papan Pemuka Penggunaan, tetapan ini mungkin ditetapkan kepada "Kelihatan kepada pemilik organisasi".

Adakah artikel ini membantu?