OpenAI
Ukurasa huu ulitafsiriwa na mashine. Tazama makala asili ya Kiingereza.

Kusimamia miradi katika jukwaa la API

Jifunze kuunda na kusimamia miradi ya API ya OpenAI, ikijumuisha wanachama, majukumu, akaunti za huduma, funguo za API, vikomo vya matumizi na bajeti.

Ilisasishwa: 5 days ago

Miradi inalenga kuwapa wateja uwezo wa kupanga kazi yao. Mashirika yanaweza kudhibiti ufikiaji na vikomo, kutoa akaunti za huduma (kupitia kiolesura cha mtumiaji), na kufuatilia matumizi ndani ya upeo uliowekewa mipaka katika mradi (k.m. miundo, uwezo, nyuzi, wasaidizi, urekebishaji wa kina, hifadhi, n.k.). Shughuli za matumizi zinaweza kugawanywa kulingana na mradi, na watumiaji wanaweza kuona malipo na kuweka vikomo vya matumizi kwa kila mradi.

Wamiliki wa shirika wanaweza kuona miradi yao yote Iliyo Hai na Iliyowekwa kwenye Kumbukumbu kwenye ukurasa wa Miradi. Pata maelezo zaidi kuhusu majukumu na ruhusa za watumiaji katika Jukwaa la API.

Image

Nani anaweza kuunda mradi?

Wamiliki wa shirika pekee ndio wanaoweza kuunda mradi. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi.

Ili kubadilisha shirika, elekeza kishale juu ya jina la shirika lako upande wa juu kushoto wa ukurasa, kisha uchague shirika katika orodha:

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

Kwa mashirika yaliyo kwenye mpango wa malipo yaliyounganishwa, mashirika madogo hutambuliwa kando. Miradi haiwezi kuundwa ndani ya mashirika madogo.

Image

Miradi hufanyaje kazi?

Kila shirika lina “Mradi chaguomsingi” ambao hauwezi kufutwa. Unaweza kusanidi vikomo vya kasi, ruhusa za miundo pepe na vikomo vya matumizi ya fedha (kuanzia Novemba 2024). Hurithi usanidi kamili wa shirika, kwa hivyo huwezi kuongeza wanachama au akaunti za huduma moja kwa moja kwake.

Ninaundaje mradi?

Kwanza, elekeza kishale juu ya jina la mradi kwenye kona ya kushoto ya ukurasa, kisha uchague Unda mradi.

API platform project menu with Create project highlighted under Default project

Weka jina, maelezo na tovuti ya mradi wako, kisha uchague Unda.

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

Ninawezaje kuongeza watumiaji kwenye mradi?

Wanachama wapya wa shirika hawaongezwi kiotomatiki kwenye “Mradi chaguomsingi”. Wanachama wapya wanaweza kualikwa kwenye mradi wanapoalikwa kwenye shirika (kwa kuwezesha kisanduku cha kuteua cha "Alika kwenye mradi chaguomsingi") au baada ya kukubali mwaliko wa shirika.

Watumiaji walioalikwa kupitia API ya Msimamizi hufuata kanuni zilizobainishwa na mwisho wa /organization/invites.

Ukipata hitilafu unapowaalika watumiaji kwenye mradi kupitia kiolesura au API ya Msimamizi, kwanza hakikisha kuwa mradi unaolengwa upo na haujawekwa kwenye kumbukumbu kabla ya kutuma mwaliko tena.

Wamiliki wa shirika huongezwa kiotomatiki kama wamiliki wa miradi mipya inayoundwa ndani ya shirika.

Ni majukumu gani tofauti ya watumiaji yaliyopo katika mashirika na miradi, na yana ruhusa zipi?

Ingawa Mashirika yana majukumu ya ‘mmiliki’ na ‘msomaji’, miradi ina majukumu ya ‘mmiliki’ na ‘mwanachama’. Wanachama wa mradi ni sawa na wasomaji wa shirika. Rejelea jedwali lililo hapa chini kwa maelezo ya kina zaidi kuhusu ruhusa zinazoambatana na kila jukumu la mtumiaji.

JukumuUpeoMaelezo
MmilikiShirikaAnaweza kuunda/kuona miradi yote, watumiaji wote na funguo zote za API. Anaweza kufuatilia miradi yote ndani ya shirika kupitia

ukurasa wa Miradi
. Anaweza kuweka vikomo vya matumizi ya fedha vya shirika na miradi. Anaweza kuwapa wengine katika shirika ruhusa ya kuona taarifa za matumizi. Anaweza kuweka miradi kwenye kumbukumbu.
MsomajiShirikaAnaweza kutekeleza uinferensi, kutumia rasilimali na kuunda funguo katika miradi yake. Anaweza kuongezwa kwenye miradi.
Hawezi kuunda miradi wala kusimamia watumiaji.
MmilikiMradiAnaweza kuongeza watumiaji wengine kwenye mradi na kubadilisha jina la mradi, pamoja na kuwa na uwezo wote wa Mwanachama. Anaweza kuweka vikomo vya matumizi ya fedha vya mradi. Anaweza kuweka mradi kwenye kumbukumbu.
MwanachamaMradiAnaweza kutekeleza uinferensi, kutumia rasilimali na kuunda funguo katika kiwango cha mradi.

Ikiwa mimi si Mmiliki katika shirika, ninaweza kufikia nini?

Watumiaji ambao si Wamiliki katika shirika wanaweza kuona tu miradi ambayo wao ni wanachama. Mmiliki wa shirika pekee ndiye anayeweza kuona miradi yote, wanachama na funguo za API katika kiwango cha mradi, na kufikia ukurasa wa Miradi.

  • Wanachama wa mradi pekee (na wamiliki wa shirika) ndio wanaoweza kuona miundo iliyoboreshwa iliyoundwa ndani ya mradi huo, mifuatano kutoka kwa Wasaidizi walioundwa au faili zozote zilizoongezwa.

  • Wanachama wa mradi wanaweza kuona wanachama wengine wote wa mradi huo na majukumu yao (yaani, Mmiliki au Mwanachama).

Ninasasishaje jukumu la mtumiaji katika mradi au kumwondoa kwenye mradi?

Mmiliki wa mradi pekee ndiye anayeweza kusasisha jukumu la mtumiaji katika mradi au kumwondoa kwenye mradi. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi.

Ili kusasisha mtumiaji katika mradi, nenda kwenye mipangilio ya shirika, uchague mradi, kisha ubofye Wanachama. Unaweza kuweka jukumu la kila mwanachama kuwa Mwanachama au Mmiliki. Unaweza pia kuchagua Ondoa ili kumwondoa mtumiaji kwenye mradi.

Akaunti ya huduma ni nini, na inatofautianaje na akaunti ya kawaida ya mtumiaji?

Akaunti ya huduma hufanya kazi kama mtumiaji bandia aliyebuniwa kwa ufikiaji wa mfumo, tofauti na akaunti za watumiaji binafsi. Wamiliki wa shirika na mradi pekee ndio wanaoweza kuunda akaunti za huduma.

Akaunti za huduma zimewekewa wigo wa miradi pekee.

Ongeza mwanachama kwenye mradi

Ukibofya kitufe cha + Ongeza mwanachama, utaona orodha ya watumiaji wenye jukumu la Msomaji katika shirika lako. Ili kuongeza mtumiaji ambaye hayumo kwa sasa katika shirika lako, utahitaji kwanza kumwongeza kwenye shirika (unaweza kuacha kisanduku cha kuteua cha 'Ongeza kwenye Mradi Chaguomsingi" bila kuchaguliwa ikiwa hutaki kuwapa watumiaji hawa ufikiaji mpana zaidi). Orodha hii haitajumuisha akaunti za huduma. Katika hatua hii unaweza kuchagua jukumu lao liwe Mmiliki au Mwanachama:

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

Unapoongeza mwanatimu, lazima umpe jukumu la Mwanachama au Mmiliki. Wanachama wa mradi wanaweza kutuma maombi ya API yanayosoma au kubadilisha data, huku wamiliki wa mradi pia wakiweza kubadilisha mipangilio na vikomo vya matumizi ya fedha vya mradi, na kusimamia wanachama wake. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi.

Jinsi ya kuunda akaunti ya huduma kwa ajili ya mradi

Kwanza nenda kwenye mradi unaotaka kuundia akaunti ya huduma kwa kuuchagua kwenye menyu kunjuzi katika upau wa kusogeza:

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

Kisha, nenda kwenye mipangilio ya shirika -> Mradi -> Wanachama -> bofya + Akaunti ya huduma:

Akaunti za huduma zilizoundwa katika kiwango cha mradi ni za kipekee kwa mradi huo na haziwezi kutumika nje ya mradi zilimoundwa ndani yake.

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

Kuipa akaunti ya huduma jina

Iwe umeunda akaunti ya huduma katika kiwango cha shirika au akaunti maalum kwa mradi, unapoiunda unaweza kuweka kitambulisho cha kipekee chenye herufi, nambari na vistari ili kuitambua kwa urahisi.

Hifadhi ufunguo wa API wa akaunti ya huduma

Baada ya kuchagua kitufe cha Unda, ufunguo wa API huundwa mara moja kwa ajili ya akaunti ya huduma na ufunguo wa siri huonyeshwa. Hifadhi ufunguo huu wa siri mahali salama. Kwa sababu za usalama, hutaweza kuuona tena kupitia akaunti yako ya OpenAI. Ukipoteza ufunguo huu wa siri, utahitaji kutengeneza mwingine.

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

Kwa chaguomsingi, ufunguo wa API wa akaunti ya huduma hupewa ruhusa za kusoma na kuandika rasilimali zote za API za mradi. Ruhusa hizi zinaweza kusasishwa katika mipangilio ya Funguo za API ya mradi wako.

Akaunti za huduma huorodheshwa pamoja na wanachama wa mradi kwenye ukurasa wa mipangilio ya wanachama wa mradi wako. Tafadhali rejelea hapa ili ujifunze zaidi kuhusu kusasisha au kuondoa ufikiaji wa akaunti ya huduma kwenye ukurasa wa mipangilio ya wanachama wa mradi wako.

Akaunti zote za huduma katika miradi na mashirika zitaonyeshwa pamoja na watumiaji wako binadamu kwenye ukurasa wa wanachama wa kiwango cha shirika.

Akaunti za huduma hudhibitiwa kama akaunti za kawaida. Kutoka Shirika -> menyu ya Wanachama unaweza Kuondoa akaunti ya huduma au kusasisha jukumu:

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

Ninasimamiaje funguo za API katika miradi ya shirika langu?

Unaweza kuunda na kusimamia funguo za API za kila mradi kwenye ukurasa wa mipangilio ya mradi huo. Katika mipangilio ya shirika, chagua mradi, kisha ubofye Funguo za API.

Ili kuunda ufunguo mpya wa siri, chagua + Unda ufunguo mpya wa siri. Unaweza pia kuchagua ikoni ya Kuhariri iliyo karibu na ufunguo wa siri ili kuhariri ruhusa zake.

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

Unaweza kuweka ruhusa za kila ufunguo wa API unapounda ufunguo mpya wa siri au kwa kuhariri ufunguo uliopo.

Kuna viwango vitatu vya ruhusa: Zote, Zilizowekewa Mipaka na Kusoma Pekee.

  • Zote — Ufunguo wa siri hupewa ruhusa kamili. Huu ndio mpangilio chaguomsingi.

  • Zilizowekewa Mipaka — Humwezesha mtumiaji kuweka ruhusa za Hakuna, Kusoma na Kuandika kwa kila mwisho.

  • Kwa mfano, unaweza kuunda ufunguo wa API ambao hauna ruhusa ya Kusoma au Kuandika kwenye mwisho wa /v1/assistants:

Create new secret key dialog in the API platform with Restricted permissions selected
  • Kusoma Pekee — Ruhusa za kusoma huwekwa kwa miisho yote.

Ufikiaji unasimamiwaje kwa watumiaji walio katika miradi au mashirika mengi?

Watumiaji wanaweza kuwa wanachama wa miradi mingi kadiri inavyohitajika. Ndani ya mradi, watumiaji wanaweza kutengeneza ufunguo binafsi wa API uliowekewa upeo na kikomo cha kufikia mradi huo na rasilimali zake pekee.

Ninawekaje na kusimamia vikomo vya kasi kwa miradi ya shirika langu?

Mmiliki wa shirika pekee ndiye anayeweza kuweka na kusimamia vikomo vya kasi katika kiwango cha mradi. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi.

Katika mipangilio ya shirika, bofya mradi unaotaka kusasisha, kisha uchague Vikomo katika sehemu ya Mradi ya orodha ya kusogeza. Unaweza kusasisha Matumizi ya Miundo kwenye ukurasa huu.

Matumizi ya miundo hukuwezesha kusanidi miundo inayoweza kutumiwa na mradi, na vikomo vya kasi vinaweza kuwekwa kwa kila muundo inavyohitajika.

Ninawekaje na kusimamia vikomo vya matumizi ya fedha kwa miradi ya shirika langu?

Ni Wamiliki wa shirika na Wamiliki wa mradi pekee wanaoweza kuweka na kusimamia vikomo vya matumizi ya fedha vya mradi. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi. Ili kubadilisha vikomo katika kiwango cha shirika, nenda kwenye mipangilio ya shirika, ubofye Vikomo, kisha usogeze chini hadi Vikomo vya matumizi.

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

Ili kuweka vikomo vya mradi, nenda kwenye mipangilio ya shirika, ubofye mradi unaotaka kusasisha, kisha uchague Vikomo. Unaweza kusasisha Kikomo cha matumizi ya fedha kwa mwezi, Kiwango cha arifa na Matumizi ya Miundo.

Kuweka kikomo cha matumizi ya fedha kwa mwezi hukuwezesha kuweka viwango elekezi vya matumizi ya fedha kwa mradi wako. Matumizi yakizidi kikomo hiki katika mwezi husika wa kalenda (UTC), maombi ya API yataendelea kuchakatwa bila kukatizwa. Kipengele hiki kimeundwa kukusaidia kufuatilia matumizi kupitia arifa za kikomo cha matumizi ya fedha, lakini hakitekelezi kikomo kisichoweza kuzidiwa. Kikomo cha matumizi ya fedha cha mradi kinapoundwa, kwa chaguomsingi arifa huundwa katika kiwango cha 100%. Unaweza kuweka arifa zaidi katika viwango tofauti kwa kubofya Ongeza Arifa.

Kumbuka kuwa wamiliki wa shirika na wamiliki wa mradi watapokea ujumbe huu kila wakati, na hili haliwezi kubinafsishwa.

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

Ninawekaje vikomo vya matumizi ya fedha kwa shirika au mradi wangu?

OpenAI sasa inaruhusu vikomo vya kila mwezi vya matumizi ya fedha ya API katika viwango vya shirika na mradi. Kikomo cha matumizi ya fedha kinaweza kufuatilia matumizi bila kuyazuia, au unaweza kukitekeleza kama kikomo kisichoweza kuzidiwa ili maombi ya API yakataliwe matumizi yakifikia kikomo. Kwa hatua na utendaji wa hivi karibuni wa usanidi, angalia Vikomo vya matumizi ya fedha katika hati za wasanidi programu.

Ninawezaje kufuta au kuweka mradi kwenye kumbukumbu?

Miradi inaweza kuwekwa kwenye kumbukumbu kupitia ukurasa mpya wa orodha ya miradi au mipangilio ya mradi husika. Mradi ukiwekwa kwenye kumbukumbu, hauwezi kurejeshwa. Unapoendelea kuweka mradi kwenye kumbukumbu, utaombwa kuandika jina la mradi ili kuendelea.

Unaweza kuona orodha ya miradi yote iliyowekwa kwenye kumbukumbu kupitia kichupo cha “Iliyowekwa kwenye kumbukumbu” katika ukurasa huohuo wa orodha ya miradi.

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

Haiwezekani kufuta miradi. Tunahifadhi historia ya miradi yote ili kuhakikisha mwendelezo wa ufuatiliaji wa matumizi na malipo.

Je, kuna kikomo cha idadi ya miradi ninayoweza kuwa nayo katika shirika langu?

Kwa chaguomsingi, mashirika yanaweza kuunda hadi miradi 2,000.

Je, rasilimali zinaweza kushirikiwa kati ya miradi?

Rasilimali za mradi (kama vile faili, wasaidizi, hifadhi au mifuatano) zimewekewa mipaka ya mradi huo na haziwezi kufikiwa na wanachama wasio wasimamizi walio nje ya mradi. Zaidi ya hayo, rasilimali haziwezi kuhamishwa kati ya miradi.

Isipokuwa moja ni kwamba fine tunes katika “Mradi chaguomsingi” zinaweza kufikiwa kutoka miradi mingine.

Kiwango cha juu cha hifadhi ya faili kwa kila mradi ni kipi?

Kwa sasa OpenAI inaruhusu hadi GB 100 za faili kuhifadhiwa kwa kila mradi.

Kiwango hiki kikizidiwa, utaona hitilafu ifuatayo:

Umezidi kiwango chako cha hifadhi ya faili. Mashirika yanawekewa kikomo cha GB 100 za faili. Tafadhali punguza ukubwa wa faili au wasiliana na usaidizi.

Tunapendekeza ufute faili zisizotumika zilizohifadhiwa kwenye akaunti yako. Kwa marejeleo, unaweza kutazama na kuorodhesha faili kwa kutumia API.

Mimi ni mmiliki wa mradi; kwa nini siwezi kuona Dashibodi ya Matumizi ya mradi wangu?

Kuonekana kwa Dashibodi ya Matumizi ya mradi hakutegemei jukumu la mtumiaji ndani ya mradi. Badala yake, huamuliwa na jukumu lako ndani ya shirika na mipangilio iliyo kwenye https://platform.openai.com/settings/organization/data-controls/visibility

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

Ikiwa huwezi kuona Dashibodi ya Matumizi, huenda mpangilio huu umewekwa kuwa "Inaonekana kwa wamiliki wa shirika".

Je, makala haya yamekusaidia?