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

Ngatur proyek ing platform API

Pembaruan: 11 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. 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 proyek bisa digunakake?

Saben organisasi nyakup “Proyek default” sing ora bisa dibusak. Sampeyan bisa ngonfigurasi watesan laju, idin model virtual, lan watesan belanja (wiwit November 2024). Proyek iki marisi konfigurasi lengkap saka organisasi, mula sampeyan ora bisa langsung nambah anggota utawa akun layanan menyang proyek iki.

Kepiye carane nggawe proyek?

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

API platform project menu with Create project highlighted under Default project

Lebokake 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

Kepiye carane nambah pangguna menyang proyek?

Anggota organisasi sing mentas ditambahake ora otomatis ditambahake menyang “Proyek gawan”. Anggota anyar bisa diundang menyang proyek nalika diundang menyang organisasi (kanthi ngaktifake kothak centhang "Undang menyang proyek gawan") utawa sawise anggota kasebut nampa undhangan organisasi.

Pangguna sing diundang liwat API Admin kudu manut aturan sing dijlentrehake ing titik pungkasan /organization/invites.

Yen ana masalah nalika ngundang pangguna menyang proyek liwat UI utawa API Admin, priksa dhisik manawa proyek sing dituju ana lan ora diarsipake sadurunge ngirim maneh undhangan.

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

Apa waé peran pangguna sing béda ing organisasi lan proyek, lan idin apa sing ana ing saben peran?

Déné Organisasi nduwèni peran “pemilik” lan “pamaca”, proyek nduwèni peran “pemilik” lan “anggota”. Anggota proyek padha fungsiné karo pamaca organisasi. Mangga deleng tabel ing ngisor iki kanggo katrangan sing luwih rinci babagan idin sing ana ing saben peran pangguna.

PeranCakupanKatrangan
PemilikOrganisasiBisa nggawe/ndeleng kabeh proyek, kabeh pangguna, lan kabeh kunci API. Nduwèni kemampuan kanggo ngawasi kabeh proyek ing organisasi liwat

kaca Proyek
. Bisa nyetel watesan belanja organisasi lan watesan belanja proyek. Bisa menehi idin kanggo ndeleng informasi panggunaan kanggo wong liya ing organisasi. Bisa ngarsipake proyek.
PamacaOrganisasiBisa nindakake inferensi, nggunakake sumber daya, lan nggawe kunci ing proyeké. Bisa ditambahake menyang proyek.
Ora bisa nggawe proyek lan ngatur pangguna.
PemilikProyekBisa nambah pangguna liya menyang proyek lan ngganti jeneng proyek, uga nduwèni kabeh kemampuan Anggota. Bisa nyetel watesan belanja proyek. Bisa ngarsipake proyek kasebut.
AnggotaProyekBisa nindakake inferensi, nggunakake sumber daya, lan nggawe kunci ing tingkat proyek.

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

Pangguna sing dudu Pamilik organisasi mung bisa ndeleng proyek sing dianggo minangka anggota. Mung pamilik organisasi sing bisa ndeleng kabeh proyek, anggota, lan kunci API ing tingkat proyek, sarta nduweni akses menyang kaca Proyek.

  • Mung anggota proyek (lan pamilik organisasi) sing bisa ndeleng model sing wis diselarasake ing proyek kasebut, utas saka Asisten sing digawe, utawa berkas sing wis ditambahake.

  • Anggota proyek bisa ndeleng sapa wae anggota liyane ing proyek kasebut lan perane (yaiku Pamilik utawa Anggota).

Kepiye carane nganyari peran pangguna ing proyek utawa mbusak pangguna saka proyek?

Mung Pamilik proyek sing bisa nganyari peran pangguna ing proyek utawa mbusak pangguna saka proyek. Waca peran lan idin kanggo katrangan luwih lengkap.

Kanggo nganyari pangguna ing proyek, bukak setelan organisasi, pilih proyek, banjur klik Anggota. Sampeyan bisa nyetel peran saben anggota dadi Anggota utawa Pamilik. Sampeyan uga bisa milih Busak kanggo mbusak pangguna 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 + Tambah anggota, bakal katon dhaptar pangguna ing organisasi sampeyan sing nduweni peran Pamaca. Yen sampeyan pengin nambah pangguna sing durung dadi anggota organisasi, tambahake dhisik menyang organisasi (kothak centhang 'Tambah menyang Proyek Gawan" bisa tetep ora dicenthang yen sampeyan ora pengin menehi akses sing luwih amba marang pangguna kasebut). Dhaptar iki ora ngemot akun layanan. Ing langkah iki, sampeyan bisa milih perane minangka Pamilik utawa Anggota:

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

Nalika nambah anggota tim, sampeyan kudu menehi peran Anggota utawa Pamilik. Anggota proyek bisa nggawe panjaluk API kanggo maca utawa ngowahi data, dene pamilik proyek uga bisa ngowahi setelan proyek lan wates pangeluaran proyek, sarta ngatur anggota proyek. Waca peran lan idin kanggo katrangan luwih lengkap.

Carane nggawe akun layanan kanggo proyek

Pisanan, bukak proyek sing arep digawekake 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

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

Sawise milih tombol Gawe, kunci API langsung digawe kanggo akun layanan lan kunci rahasia bakal ditampilake. Simpen kunci rahasia iki ing panggonan sing aman. Amarga alasan keamanan, sampeyan ora bakal bisa ndeleng maneh liwat akun OpenAI. Yen kunci rahasia iki ilang, sampeyan kudu nggawe kunci anyar.

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

Kanthi gawan, kunci API akun layanan nduweni idin maca lan nulis kabeh sumber daya API proyek. Idin kasebut bisa dianyari ing setelan Kunci API proyek.

Akun layanan kadhaptar bebarengan karo anggota proyek ing kaca setelan anggota proyek. Waca ing kene kanggo mangerteni luwih lengkap 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

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, 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 idine.

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.

Ana telung tingkat idin: Kabeh, Diwatesi, lan Mung Maca.

  • Kabeh — Kunci rahasia diwenehi idin lengkap. Iki setelan gawan.

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

  • Contone, sampeyan nggawe kunci API sing khusus ora nduweni 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 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 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 lengkap. Kanggo ngowahi 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 wulan, Ambang kabar, lan Panggunaan Model.

Nyetel wates pangeluaran saben wulan ngidini sampeyan nemtokake ambang pangeluaran fleksibel kanggo proyek. Nalika panggunaan ngluwihi wates iki sajrone sasi tanggalan tartamtu (UTC), panjaluk API bakal terus diproses tanpa kendhat. Fitur iki dirancang kanggo mbantu sampeyan ngawasi panggunaan liwat tandha wates pangeluaran, nanging ora ngetrapake wates maksimal pangeluaran. Nalika wates pangeluaran proyek digawe, tandha ing ambang 100% bakal digawe kanthi gawan. Tandha tambahan kanthi ambang sing beda bisa disetel kanthi ngeklik Tambah Tandha.

Elinga yen pamilik organisasi lan pamilik proyek mesthi bakal nampa pesen kasebut lan iki ora bisa dikustomisasi.

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

Kepiye carané nyetel watesan belanja kanggo organisasi utawa proyekku?

OpenAI saiki ndhukung watesan belanja API saben wulan ing tingkat organisasi lan proyek. Watesan belanja bisa ngawasi belanja tanpa ngetrapake watesan, utawa sampeyan bisa ngetrapake minangka watesan atos supaya panjaluk API gagal sawisé belanja tekan watesan. Kanggo langkah konfigurasi lan prilaku paling anyar, deleng Watesan belanja ing dokumentasi pangembang.

Kepiye carane mbusak utawa ngarsipake proyek?

Proyek bisa diarsipake liwat kaca dhaptar proyek anyar utawa liwat setelan proyek kasebut. Sawise proyek diarsipake, proyek kasebut ora bisa dipulihake. Nalika nerusake proses 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

Proyek ora bisa dibusak. Kita nyimpen riwayat kabeh proyek kanggo njaga 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 berkas saben proyek?

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

Yen kuota iki diluwihi, sampeyan bakal ndeleng pesen masalah 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 Dasbor Panggunaan kanggo proyekku?

Visibilitas Dasbor Panggunaan proyek ora ana gandhengane karo peran pangguna ing proyek kasebut. Visibilitas kasebut 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 Dasbor Panggunaan, setelan iki kamungkinan disetel dadi "Katon kanggo pamilik organisasi".

Apa artikel iki migunani kanggo sampeyan?