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

Ngatur proyek ing platform API

Sinau carané nggawe lan ngatur proyek API OpenAI, kalebu anggota, peran, akun layanan, kunci API, wates panggunaan, lan anggaran.

Pembaruan: 17 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 sawijining proyek (contone model, kapabilitas, thread, asisten, fine tuning, panyimpenan, lan liya-liyané). Aktivitas panggunaan bisa dirinci miturut proyek, lan pangguna bisa ndeleng tagihan lan nyetel watesan belanja saben proyek.

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

Image

Sapa sing bisa nggawe proyek?

Mung pamilik organisasi sing bisa nggawe proyek. Waca peran lan idin kanggo katrangan luwih akèh.

Kanggo ngalih organisasi, arahké kursor menyang jeneng organisasi 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 nganggo paket tagihan gabungan, suborganisasi ditandhani kanthi kapisah. Proyek ora bisa digawé ing suborganisasi.

Image

Kepiyé cara kerjané proyek?

Saben organisasi nyakup “Proyek gawan” sing ora bisa dibusak. Sampeyan bisa ngatur wates laju, idin model virtual, lan wates pangeluaran (wiwit November 2024). Proyek iki marisi kabèh konfigurasi organisasi, mula sampeyan ora bisa langsung nambah anggota utawa akun layanan menyang proyek kasebut.

Kepiyé carané nggawe proyek?

Pisanan, arahké kursor menyang jeneng proyek ing pojok kiwa kaca banjur pilih Gawe proyek.

API platform project menu with Create project highlighted under Default project

Lebokaké jeneng, katrangan, lan situs web proyek, banjur pilih Gawe.

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

Kepiyé carané nambah pangguna menyang proyek?

Anggota organisasi sing lagi ditambahaké ora otomatis ditambahaké menyang “Proyek gawan”. Anggota anyar bisa diundang menyang proyek nalika diundang menyang organisasi (kanthi ngaktifaké kothak centhang "Undang menyang proyek gawan") utawa sawisé anggota nampa undhangan organisasi.

Pangguna sing diundang liwat API Admin manut aturan sing diterangaké ing titik pungkasan /organization/invites.

Yèn ana kasalahan nalika ngundang pangguna menyang proyek liwat UI utawa API Admin, priksa dhisik manawa proyek sing dituju ana lan ora diarsipaké sadurungé ngirim ulang undhangan.

Pamilik organisasi otomatis ditambahaké minangka pamilik ing proyek anyar sing digawé ing organisasi.

Apa waé peran pangguna ing organisasi lan proyek, lan idin apa sing diduwèni saben peran?

Nalika organisasi nduwèni peran ‘pamilik’ lan ‘pamaca’, proyek nduwèni peran ‘pamilik’ lan ‘anggota’. Anggota proyek padha karo pamaca organisasi. Delengen tabel ing ngisor iki kanggo katrangan luwih rinci babagan idin sing diduwèni saben peran pangguna.

PeranCakupanKatrangan
PamilikOrganisasiBisa nggawe lan ndeleng kabèh proyek, pangguna, lan kunci API. Bisa ngawasi kabèh proyek ing organisasi liwat

kaca Proyek
. Bisa nyetel wates pangeluaran organisasi lan proyek. Bisa mènèhi idin marang wong liya ing organisasi kanggo ndeleng informasi panggunaan. Bisa ngarsipaké proyek.
PamacaOrganisasiBisa nindakake inferensi, nganggo sumber daya, lan nggawe kunci ing proyeke. Bisa ditambahaké menyang proyek.
Ora bisa nggawe proyek lan ngatur pangguna.
PamilikProyekBisa nambah pangguna liya menyang proyek, ngganti jeneng proyek, lan nindakake kabèh sing bisa ditindakake Anggota. Bisa nyetel wates pangeluaran proyek. Bisa ngarsipaké proyek.
AnggotaProyekBisa nindakake inferensi, nganggo sumber daya, lan nggawe kunci ing tingkat proyek.

Yèn aku dudu Pamilik ing organisasi, apa waé sing bisa dakakses?

Pangguna sing dudu Pamilik ing organisasi mung bisa ndeleng proyek sing didaftar dadi anggotané. Mung pamilik organisasi sing bisa ndeleng kabèh proyek, anggota, lan kunci API ing tingkat proyek, sarta ngakses kaca Proyek.

  • Mung anggota proyek (lan pamilik organisasi) sing bisa ndeleng model sing wis diselarasaké ing proyek kasebut, utas saka Asisten sing digawé, utawa berkas sing ditambahaké.

  • Anggota proyek bisa ndeleng kabèh anggota liya ing proyek kasebut lan perané (yaiku Pamilik utawa Anggota).

Kepiyé carané nganyari peran proyek pangguna utawa mbusak pangguna saka proyek?

Mung Pamilik proyek sing bisa nganyari peran proyek pangguna utawa mbusak pangguna saka proyek. Waca peran lan idin kanggo katrangan luwih akèh.

Kanggo nganyari pangguna ing proyek, bukak setelan organisasi, pilih proyèk, banjur klik Anggota. Sampeyan bisa nyetel peran saben anggota minangka Anggota utawa Pamilik. Sampeyan uga bisa milih Busak kanggo mbusak pangguna saka proyek.

Apa iku akun layanan, lan apa bédané karo akun pangguna biasa?

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

Akun layanan mung diwatesi kanggo proyek.

Tambah anggota menyang proyek

Yèn ngeklik tombol + Tambah anggota, sampeyan bakal ndeleng dhaptar pangguna ing organisasi sing nduwèni peran Pamaca. Yèn arep nambah pangguna sing durung ana ing organisasi, sampeyan kudu nambahaké dhèwèké menyang organisasi luwih dhisik (kothak centhang “Tambah menyang Proyek Gawan” bisa tetep ora dicenthang yèn sampeyan ora péngin mènèhi pangguna kasebut akses sing luwih amba). Dhaptar iki ora nyakup akun layanan. Ing langkah iki, sampeyan bisa milih perané minangka Pamilik utawa Anggota:

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

Nalika nambah anggota tim, sampeyan kudu mènèhi peran Anggota utawa Pamilik. Anggota proyek bisa ngirim panjaluk API kanggo maca utawa ngowahi data, déné pamilik proyek uga bisa ngowahi setelan lan wates pangeluaran proyek, sarta ngatur anggota proyek. Waca peran lan idin kanggo katrangan luwih akèh.

Cara nggawe akun layanan kanggo proyek

Pisanan, bukak proyek sing arep digawèkaké akun layanan kanthi milih saka menu tarik mudhun ing bilah navigasi:

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

Banjur, bukak setelan organisasi -> Proyek -> Anggota -> klik + Akun layanan:

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

Mènèhi jeneng akun layanan

Ora preduli akun layanan digawé ing tingkat organisasi utawa khusus kanggo sawijining proyek, nalika nggawe akun layanan sampeyan bisa nggawe ID akun layanan unik sing kasusun saka aksara, angka, lan tandha pisah supaya akun kasebut gampang dingertèni.

Simpen kunci API akun layanan

Sawisé milih tombol Gawe, kunci API bakal langsung digawé kanggo akun layanan lan kunci rahasiané bakal ditampilaké. Simpen kunci rahasia iki ing panggonan sing aman. Amarga alasan keamanan, sampeyan ora bakal bisa ndeleng kunci iki manèh liwat akun OpenAI. Yèn kunci rahasia iki ilang, sampeyan kudu nggawé kunci anyar.

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

Kanthi gawan, kunci API akun layanan nduwèni idin kanggo maca lan nulis kabèh sumber daya API proyek. Idin iki bisa dianyari ing setelan Kunci API proyek.

Akun layanan didhaptar bebarengan karo anggota proyek ing kaca setelan anggota proyek. Waca ing kéné kanggo mangertèni luwih akèh babagan nganyari utawa mbusak akses akun layanan ing kaca setelan anggota proyek.

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

Kepiyé carané ngatur kunci API ing proyek organisasi?

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

Kanggo nggawe kunci rahasia anyar, pilih + Gawe kunci rahasia anyar. Sampeyan uga bisa milih lambang 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 ngowahi kunci sing wis ana.

Ana telung tingkat idin: Kabèh, Diwatesi, lan Mung Maca.

  • Kabèh — Kunci rahasia diwènèhi idin lengkap. Iki setelan gawan.

  • Diwatesi — Ngidini pangguna nyetel idin Ora Ana, Maca, lan Nulis kanggo saben titik pungkasan.

  • Contoné, sampeyan nggawe kunci API sing khusus ora nduwèni idin Maca utawa Nulis menyang titik pungkasan /v1/assistants:

Create new secret key dialog in the API platform with Restricted permissions selected
  • Mung Maca — Idin maca disetel kanggo kabèh titik pungkasan.

Kepiyé akses diatur kanggo pangguna sing dadi anggota luwih saka siji proyek utawa organisasi?

Pangguna bisa dadi anggota proyek sapira waé manut kabutuhan. Ing sawijining proyek, pangguna bisa nggawe kunci API pribadi sing cakupan lan aksesé diwatesi mung kanggo proyek kasebut lan sumber dayané.

Kepiyé carané nyetel lan ngatur wates laju kanggo proyek organisasi?

Mung Pamilik organisasi sing bisa nyetel lan ngatur wates laju tingkat proyek. Waca peran lan idin kanggo katrangan luwih akèh.

Ing setelan organisasi, klik proyek sing arep dianyari banjur pilih Wates ing bagean Proyek ing dhaptar navigasi. Sampeyan bisa nganyari Panggunaan Model ing kaca iki.

Panggunaan model ngidini sampeyan ngatur model sing bisa digunakaké proyek, lan wates laju bisa disetel kanggo saben model manut kabutuhan.

Kepiyé carané nyetel lan ngatur wates pangeluaran kanggo proyek organisasi?

Mung Pamilik organisasi lan Pamilik proyek sing bisa nyetel lan ngatur wates pangeluaran proyek. Waca peran lan idin kanggo katrangan luwih akèh. Kanggo ngganti wates ing tingkat organisasi, bukak setelan organisasi, klik Wates, banjur gulung mudhun menyang Wates panggunaan.

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

Kanggo nyetel wates proyek, bukak setelan organisasi, klik proyek sing arep dianyari, banjur pilih Wates. Sampeyan bisa nganyari Wates pangeluaran saben sasi, Ambang kabar, lan Panggunaan Model.

Nyetel wates pangeluaran saben sasi ngidini sampeyan netepaké ambang pangeluaran alus kanggo proyek. Nalika panggunaan ngluwihi wates iki sajroning sasi tanggalan tartamtu (UTC), panjaluk API bakal tetep diproses tanpa kendhat. Fitur iki dirancang kanggo mbantu ngawasi panggunaan liwat tandha wates pangeluaran, nanging ora ngetrapaké wates pangeluaran sing ketat. Nalika wates pangeluaran proyek digawé, kanthi gawan tandha bakal digawé ing ambang 100%. Tandha tambahan kanthi ambang sing béda bisa disetel kanthi ngeklik Tambah Tandha.

Elinga, pamilik organisasi lan pamilik proyek bakal tansah nampa pesen iki lan bab iki ora bisa diatur dhéwé.

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

Kepiyé carané nyetel wates pangeluaran kanggo organisasi utawa proyek?

Saiki OpenAI ndhukung wates pangeluaran API saben sasi ing tingkat organisasi lan proyek. Wates pangeluaran bisa ngawasi pangeluaran tanpa ngetrapaké wates, utawa bisa dileksanakaké minangka wates ketat supaya panjaluk API gagal sawisé pangeluaran tekan wates. Kanggo langkah konfigurasi lan prilaku paling anyar, delengen Wates pangeluaran ing dokumentasi pangembang.

Kepiyé carané mbusak utawa ngarsipaké proyek?

Proyek bisa diarsipaké liwat kaca dhaptar proyek anyar utawa setelan saben proyek. Sawisé diarsipaké, proyek ora bisa dipulihaké. Nalika nerusaké pangarsipan, sampeyan bakal dijaluk ngetik jeneng proyek kanggo nerusaké.

Sampeyan bisa ndeleng dhaptar kabèh proyek sing diarsipaké liwat tab “Diarsipaké” ing kaca dhaptar proyek sing padha.

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

Proyek ora bisa dibusak. Kita nyimpen riwayat kabèh proyek supaya pelacakan panggunaan lan tagihan tetep sinambung.

Apa ana wates cacah proyek sing bisa diduwèni organisasiku?

Kanthi gawan, organisasi bisa nggawe nganti 2.000 proyek.

Apa sumber daya bisa dienggo bareng antarproyek?

Sumber daya proyek (kayata berkas, asisten, panyimpenan, utawa utas) diwatesi ing proyek kasebut lan ora bisa diakses 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 berkas saben proyek?

Saiki OpenAI ndhukung kuota panyimpenan berkas nganti 100 GB saben proyek.

Yèn kuota iki diluwihi, sampeyan bakal ndeleng kasalahan 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, nanging kena apa ora bisa ndeleng Dasbor Panggunaan proyekku?

Katone Dasbor Panggunaan proyek ora ana gandhèngané karo peran pangguna ing proyek. Nanging, iki ditemtokaké déning 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

Yèn ora bisa ndeleng Dasbor Panggunaan, setelan iki kamungkinan disetel dadi "Katone kanggo pamilik organisasi".

Apa artikel iki migunani kanggo sampeyan?