OpenAI
Kaca iki diterjemahake nganggo mesin. Deleng artikel asli basa Inggris.

Ngatur proyek ing platform API

Pembaruan: 22 days ago

Proyek ditujokake kanggo menehi pelanggan kemampuan ngatur pakaryané. Organisasi bisa ngatur akses lan watesan, nyedhiyakake akun layanan (liwat UI), lan nglacak panggunaan marang cakupan sing diwatesi ing proyek (umpamane model, kemampuan, thread, assistant, fine tuning, panyimpenan, lsp.). Aktivitas panggunaan bisa dirinci miturut proyek, lan panganggo bisa ndeleng tagihan lan nyetel anggaran saben proyek.

Pamilik organisasi bisa ndeleng kabeh proyek Aktif lan Diarsipake ing kaca Proyek. Sinau luwih lengkap babagan peran lan idin panganggo ing Platform API.

Image

Sapa sing bisa nggawe proyek?

Mung pamilik organisasi sing bisa nggawe proyek. Mangga deleng peran lan idin kanggo informasi luwih lengkap.

Kanggo ngalih antar organisasi, arahaké kursor ing jeneng organisasi sampeyan ing sisih kiwa ndhuwur kaca banjur pilih organisasi saka dhaptar:

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

Kanggo organisasi sing ana ing rencana tagihan gabungan, sub-org diidentifikasi kanthi kapisah. Proyek ora bisa digawe ing sub-org.

Image

Kepiye cara kerja proyek?

Saben organisasi kalebu “Proyek gawan” sing ora bisa dibusak. Sampeyan bisa ngatur rate limit, idin model virtual, lan anggaran belanja (wiwit November 2024). Proyek iki nampa warisan konfigurasi lengkap saka organisasi, mula sampeyan ora bisa langsung nambah anggota utawa akun layanan menyang kono.

Kepiye cara nggawe proyek?

Pisanan, arahna kursor menyang jeneng proyek ing pojok kiwa kaca banjur pilih Create project.

API platform project menu with Create project highlighted under Default project

Wenehana jeneng, katrangan, lan situs web kanggo proyek sampeyan banjur pilih Create.

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

Kepiye carane nambah panganggo menyang proyek?

Anggota organisasi sing anyar ditambahake ora otomatis ditambahake menyang “Proyek default”. Anggota anyar bisa diundang menyang proyek nalika diundang menyang organisasi (kanthi ngaktifake kothak centhang “Undang menyang proyek default”) utawa sawisé anggota nampa undhangan organisasi.

Panganggo sing diundang liwat Admin API ngetutake aturan sing diterangake dening titik pungkasan /organization/invites.

Yen sampeyan nemoni kesalahan nalika ngundang panganggo menyang proyek liwat UI utawa Admin API, dhisik pasthekake proyek tujuane ana lan ora diarsipake sadurunge ngirim maneh undhangan.

Pamilik organisasi otomatis ditambahake minangka pamilik menyang proyek anyar sing digawe ing organisasi.

Apa wae peran panganggo sing beda ing organisasi lan proyek, lan idin apa sing kalebu?

Nalika Organisasi duwe peran ‘owner’ lan ‘reader’, proyek duwe peran ‘owner’ lan ‘member’. Anggota proyek padha karo pembaca organisasi. Mangga deleng tabel ing ngisor iki kanggo katrangan luwih rinci babagan idin sing ana ing saben peran panganggo.

PeranCakupanKatrangan
PamilikOrganisasiBisa nggawe/ndeleng kabeh proyek, kabeh panganggo, kabeh kunci API. Duwe kemampuan ngawasi kabeh proyek ing organisasi nganggo kaca Proyek. Bisa nyetel anggaran organisasi lan anggaran proyek. Bisa menehi idin kanggo ndeleng informasi panggunaan kanggo wong liya ing org. Bisa ngarsipake proyek.
PembacaOrganisasiBisa nindakake inferensi, nggunakake sumber daya, lan nggawe kunci ing proyeké. Bisa ditambahake menyang proyek.
Ora bisa nggawe proyek lan ngatur panganggo.
PamilikProyekBisa nambah panganggo liya menyang proyek lan ngganti jeneng proyek, uga kabeh kemampuan Anggota. Bisa nyetel anggaran proyek. Bisa ngarsipake proyek kasebut.
AnggotaProyekBisa nindakake inferensi, nggunakake sumber daya, lan nggawe kunci ing tingkat proyek.

Yen aku dudu Pamilik ing organisasi, apa sing bisa dakakses?

Panganggo sing dudu Pamilik ing organisasi mung bisa ndeleng proyek sing dadi anggotané. Mung pamilik organisasi sing bisa ndeleng kabeh proyek, anggota, lan kunci API ing tingkat proyek, lan duwe akses menyang kaca Proyek.

  • Mung anggota proyek (lan pamilik organisasi) sing bisa ndeleng model fine-tuned sing wis digawe ing proyek kasebut, thread saka Assistant apa wae sing digawe, utawa berkas apa wae sing wis ditambahake.

  • Anggota proyek bisa ndeleng sapa wae anggota liya ing proyek kasebut lan perané (yaiku Pamilik utawa Anggota).

Kepiye carane nganyari peran proyek panganggo utawa mbusak panganggo saka proyek?

Mung Pamilik proyek sing bisa nganyari peran proyek panganggo utawa mbusak panganggo saka proyek. Mangga deleng peran lan idin kanggo informasi luwih lengkap.

Kanggo nganyari panganggo ing proyek, bukak setelan organisasi sampeyan, pilih proyek, banjur klik Members. Sampeyan duwe pilihan kanggo nyetel peran saben anggota dadi Member utawa Owner. Sampeyan uga bisa milih Remove kanggo mbusak panganggo saka proyek.

Apa iku akun layanan, lan apa bedane karo akun pangguna biasa?

Akun layanan tumindak minangka pangguna semu sing dirancang kanggo akses sistem, beda karo akun pangguna individu. Mung pamilik organisasi lan proyek sing bisa nggawe akun layanan.

Akun layanan mung diwatesi kanggo proyek.

Nambah anggota menyang proyek

Yen sampeyan ngeklik tombol + Add member, sampeyan bakal ndeleng dhaptar panganggo ing organisasi sampeyan kanthi peran Reader. Yen sampeyan pengin nambah panganggo sing saiki durung ana ing organisasi sampeyan, sampeyan kudu nambahake dhisik menyang organisasi (sampeyan bisa tetep ora nyenthang kothak centhang “Tambah menyang Proyek Default” yen ora pengin menehi akses luwih jembar marang panganggo iki). Dhaptar iki ora bakal kalebu akun layanan. Ing langkah iki sampeyan bisa milih apa perané Owner utawa Member:

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

Nalika nambah anggota tim, sampeyan kudu menehi peran Member utawa Owner. Anggota proyek bisa nggawe panjaluk API sing maca utawa ngowahi data, dene pamilik proyek uga bisa ngowahi setelan lan anggaran proyek lan ngatur anggota proyek. Mangga deleng peran lan idin kanggo informasi luwih lengkap.

Carane nggawe akun layanan kanggo proyek

Pisanan, navigasi menyang proyek sing pengin digawekake akun layanan kanthi milih saka dropdown ing bilah navigasi:

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

Banjur, bukak setelan organisasi sampeyan -> Project -> Members -> klik + Service account:

Akun layanan sing digawe ing level proyek iku unik kanggo proyek kasebut lan ora bisa digunakake ing njaba proyek panggonan akun kasebut digawe.

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

Menehi jeneng akun layanan

Apa wae manawa sampeyan nggawe akun layanan ing level organisasi utawa nggawe sing unik kanggo proyek, nalika nggawe akun layanan sampeyan bisa nggawe ID akun layanan unik sing dumadi saka huruf, angka, lan tanda hubung supaya akun layanan gampang diidentifikasi.

Simpen kunci API akun layanan

Sawisé milih tombol Create, kunci API langsung digawe kanggo akun layanan lan kunci rahasia bakal ditampilake. Simpen kunci rahasia iki ing papan sing aman lan terlindungi. Amarga alasan keamanan, sampeyan ora bakal bisa ndeleng maneh liwat akun OpenAI sampeyan. Yen sampeyan kelangan kunci rahasia iki, sampeyan kudu ngasilake sing anyar.

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

Idin kunci API akun layanan kanthi gawan disetel kanggo maca lan nulis kabeh sumber daya API proyek. Idin iki bisa dianyari ing setelan API Keys proyek sampeyan.

Akun layanan didhaptar bebarengan karo anggota proyek ing kaca setelan anggota proyek sampeyan. Mangga deleng kene kanggo sinau luwih lengkap babagan nganyari utawa mbusak akses akun layanan ing kaca setelan anggota proyek sampeyan.

Kabeh akun layanan ing proyek lan organisasi bakal ditampilake bebarengan karo panganggo manungsa sampeyan ing kaca anggota tingkat organisasi.

Akun layanan dikelola kaya akun biasa. Saka Organisasi -> menu Anggota, sampeyan bisa Mbusak akun layanan utawa nganyari perané:

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

Kepiye carane ngatur kunci API ing proyek organisasi?

Sampeyan bisa nggawe lan ngatur kunci API kanggo saben proyek ing kaca setelan proyek kasebut. Ing setelan organisasi sampeyan, pilih proyek, banjur klik API Keys.

Kanggo nggawe kunci rahasia anyar, pilih + Create new secret key. Sampeyan uga bisa milih ikon Owahi ing jejere kunci rahasia kanggo ngowahi idiné.

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

Sampeyan bisa nyetel idin kanggo saben kunci API nalika nggawe kunci rahasia anyar utawa kanthi ngowahi kunci sing wis ana.

Kasedhiya telung tingkat idin: Kabeh, Diwatesi, lan Mung Waca.

  • Kabeh — Idin lengkap disetel kanggo kunci rahasia. Iki setelan gawan.

  • Diwatesi — Ngidini panganggo nyetel idin Ora Ana, Waca, lan Tulis kanggo saben titik pungkasan.

    • Contone, sampeyan nggawe kunci API sing khusus ora duwe idin kanggo Waca utawa Tulis menyang titik pungkasan /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Mung Waca — Idin waca disetel kanggo kabeh titik pungkasan.

Kepiye akses dikelola kanggo pangguna sing melu ing pirang-pirang proyek utawa organisasi?

Pangguna bisa dadi anggota sakakehe proyek sing dibutuhake. Ing njero proyek, pangguna bisa nggawe kunci API pribadi sing diwatesi lan mung kanggo ngakses proyek kasebut lan sumber dayané.

Kepiye carane nyetel lan ngatur watesan laju kanggo proyek organisasi?

Mung Pamilik organisasi sing bisa nyetel lan ngatur watesan laju tingkat proyek. Mangga deleng peran lan idin kanggo informasi luwih lengkap.

Ing setelan organisasi sampeyan, klik proyek sing pengin dianyari banjur pilih Limits ing bagean Proyek saka dhaptar navigasi. Sampeyan bisa nganyari Model Usage ing kaca iki.

Panggunaan model ngidini sampeyan ngonfigurasi model endi sing bisa digunakake proyek, lan watesan laju bisa disetel kanggo saben model yen perlu.

Kepiye carane nyetel lan ngatur anggaran kanggo proyek organisasi?

Mung Pamilik organisasi lan Pamilik proyek sing bisa nyetel lan ngatur anggaran proyek. Mangga deleng peran lan idin kanggo informasi luwih lengkap. Kanggo ngganti watesan ing tingkat organisasi, ing setelan organisasi sampeyan, klik Limits, banjur gulung mudhun menyang Usage limits.

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

Kanggo nyetel watesan proyek, ing setelan organisasi sampeyan, klik proyek sing pengin dianyari banjur pilih Limits. Sampeyan bisa nganyari Monthly budget, Notification threshold, lan Model Usage.

Nyetel anggaran saben wulan ngidini sampeyan nemtokake ambang belanja alus kanggo proyek sampeyan. Nalika panggunaan ngluwihi watesan iki sajrone sasi tanggalan tartamtu (UTC), panjaluk API bakal terus diproses tanpa gangguan. Fitur iki dirancang kanggo mbantu sampeyan ngawasi panggunaan liwat tandha anggaran, nanging ora ngetrapake watesan keras kanggo belanja. Nalika anggaran proyek digawe, kanthi gawan, tandha bakal digawe ing ambang 100%. Anggaran tambahan ing ambang sing beda bisa disetel kanthi ngeklik Add Alert.

Elinga manawa pamilik organisasi lan pamilik proyek bakal tansah nampa pesen iki lan iki ora bisa dikustomisasi.

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

Kepiye carane mbusak utawa ngarsipake proyek?

Proyek bisa diarsipake liwat kaca dhaptar proyek anyar utawa ing setelan proyek individu. Sawisé proyek diarsipake, proyek kasebut ora bisa dipulihake. Nalika nerusake arsip, sampeyan bakal dijaluk ngetik jeneng proyek kanggo nerusake.

Sampeyan bisa ndeleng dhaptar kabeh proyek sing diarsipake liwat tab “Diarsipake” ing kaca dhaptar proyek sing padha.

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

Mbusak proyek ora bisa ditindakake; kita njaga riwayat kabeh proyek kanggo njamin kesinambungan pelacakan panggunaan lan tagihan.

Apa ana watesan kanggo jumlah proyek ing organisasi saya?

Kanthi gawan, organisasi bisa nggawe nganti 2.000 proyek.

Apa sumber daya bisa dienggo bareng antarproyek?

Sumber daya proyek (kayata file, assistant, panyimpenan, utawa thread) diwatesi kanggo proyek kasebut lan ora bisa diakses dening anggota non-admin saka njaba proyek. Kajaba iku, sumber daya ora bisa dipindhah antarproyek.

Siji-sijine pangecualian yaiku fine-tune ing “Proyek gawan” bisa diakses saka proyek liyane.

Pira kuota panyimpenan file saben proyek?

OpenAI saiki ndhukung kuota panyimpenan file 100 GB file saben proyek.

Yen kuota iki dilanggar, sampeyan bakal weruh kesalahan ing ngisor iki:

Sampeyan wis ngluwihi kuota panyimpenan file. Organisasi diwatesi nganti 100 GB file. Mangga suda ukuran file utawa hubungi dhukungan.

Disaranake sampeyan mbusak berkas sing ora digunakake sing disimpen ing akun sampeyan. Minangka rujukan, sampeyan bisa ndeleng lan ndhaptar berkas nganggo API.

Aku pamilik proyek, kenapa ora bisa ndeleng Dashboard Panggunaan kanggo proyekku?

Visibilitas Dashboard Panggunaan proyek ora ana gandhengane karo peran panganggo ing proyek. Nanging, iki ditemtokake dening peran sampeyan ing organisasi lan setelan ing https://platform.openai.com/settings/organization/data-controls/visibility

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

Yen sampeyan ora bisa ndeleng Dashboard Panggunaan, setelan iki kemungkinan disetel dadi “Katon kanggo pamilik organisasi”.

Apa artikel iki migunani kanggo sampeyan?