OpenAI
Boggan si mashiin ah ayaa loo turjumay. Eeg maqaalka asalka ah ee Ingiriisiga ahaa.

Maareynta mashruucyada ee madasha API

Baro sida loo abuuro loona maamulo mashaariicda OpenAI API, oo ay ku jiraan xubnaha, doorarka, akoonnada adeegga, furayaasha API, xadka isticmaalka iyo miisaaniyadaha.

La cusboonaysiiyay: 10 days ago

Mashaariicdu waxay ujeeddadoodu tahay inay macaamiisha siiyaan awood ay shaqadooda ku abaabulaan. Ururradu waxay maamuli karaan gelitaanka iyo xaddidyada, diyaarin karaan koontooyinka adeegga (iyadoo loo marayo UI-ga), waxayna la socon karaan isticmaalka gudaha baaxad xaddidan oo mashruuc ah (tusaale ahaan noocyo, awoodaha, threads, caawiyayaal, hagaajin gaar ah, kaydin, iwm.). Hawlaha isticmaalka waxaa loo kala jebin karaa mashruuc ahaan, isticmaaleyaashuna waxay arki karaan biilasha oo dejin karaan xaddidyada kharashka mashruuc kasta.

Mulkiilayaasha ururku waxay dhammaan mashaariicdooda Firfircoon iyo Ku kaydsan ka arki karaan bogga Mashaariicda. Wax badan ka baro doorarka isticmaaleyaasha iyo oggolaanshaha ku jira Madasha API.

Image

Yaa abuuri kara mashruuc?

Keliya milkiilayaasha ururka ayaa abuuri kara mashruuc. Wixii macluumaad dheeraad ah, eeg doorarka iyo oggolaanshaha.

Si aad ururrada isugu beddesho, dul gee magaca ururkaaga ee bidixda sare ee bogga, kadibna liiska ka dooro ururka:

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

Ururrada ku jira qorshe biil-bixin la isku daray, urur-hoosaadyada si gaar ah ayaa loo aqoonsadaa. Mashaariic lagama dhex abuuri karo urur-hoosaadyada.

Image

Sidee ayay mashaariicdu u shaqeeyaan?

Urur kasta waxa ku jira “Mashruuc caadi ah” oo aan la tirtiri karin. Waxaad habayn kartaa xadka xawaaraha, oggolaanshaha nooca dalwadda ah iyo xadka kharashka (laga bilaabo Noofambar 2024). Wuxuu dhaxlaa dhammaan habaynta ururka, sidaas darteed si toos ah uguma dari kartid xubno ama akoonno adeeg.

Sideen u abuuraa mashruuc?

Marka hore, dul gee magaca mashruuca ee geeska bidix ee bogga, kadibna dooro Abuur mashruuc.

API platform project menu with Create project highlighted under Default project

Sii mashruucaaga magac, sharaxaad iyo mareeg, kadibna dooro Abuur.

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

Sideen isticmaaleyaal ugu daraa mashruuc?

Xubnaha dhowaan lagu daray ururka si toos ah looguma daro “Mashruuca caadiga ah”. Xubnaha cusub waxaa lagu martiqaadi karaa mashruuca marka ururka lagu martiqaadayo (iyadoo la calaamadinayo sanduuqa "Ku martiqaad mashruuca caadiga ah") ama kadib marka xubintu aqbasho martiqaadka ururka.

Isticmaaleyaasha lagu martiqaado Admin API waxay raacaan xeerarka lagu qeexay bar-dhammaadka /organization/invites.

Haddii cilad kula soo gudboonaato markaad isticmaaleyaal mashruuc ugu martiqaadayso UI-ga ama Admin API, marka hore xaqiiji in mashruuca la beegsanayo jiro oo aanu kaydsanayn, ka hor intaadan martiqaadka dib u dirin.

Milkiilayaasha ururka si toos ah ayaa milkiileyaal looga dhigaa mashaariicda cusub ee ururka laga dhex abuuro.

Maxay yihiin doorarka kala duwan ee isticmaaleyaasha ururrada iyo mashaariicda, oggolaansho noocee ahna ayay leeyihiin?

Halka ururradu leeyihiin doorarka ‘milkiile’ iyo ‘akhriste’, mashaariicdu waxay leeyihiin doorarka ‘milkiile’ iyo ‘xubin’. Xubnaha mashruucu waxay u dhigmaan akhristayaasha ururka. Faahfaahin dheeraad ah oo ku saabsan oggolaanshaha la socda door kasta oo isticmaale, eeg jadwalka hoose.

DoorBaaxadSharaxaad
MilkiileUrurWuxuu abuuri ama arki karaa dhammaan mashaariicda, isticmaaleyaasha iyo furayaasha API. Wuxuu la socon karaa dhammaan mashaariicda ururka isagoo adeegsanaya

bogga Mashaariicda
. Wuxuu dejin karaa xadka kharashka ururka iyo kan mashruuca. Wuxuu xubnaha kale ee ururka siin karaa oggolaanshaha ay ku arkaan macluumaadka isticmaalka. Wuxuu kaydin karaa mashaariicda.
AkhristeUrurWuxuu mashaariicdiisa ku samayn karaa saadaalin, ku adeegsan karaa khayraadka, kuna abuuri karaa furayaal. Waxaa lagu dari karaa mashaariicda.
Ma abuuri karo mashaariic, mana maamuli karo isticmaaleyaasha.
MilkiileMashruucWuxuu isticmaaleyaal kale ku dari karaa mashruuca, magaca mashruucana wuu beddeli karaa, wuxuuna leeyahay dhammaan awoodaha Xubinta. Wuxuu dejin karaa xadka kharashka mashruuca. Wuxuu kaydin karaa mashruuca.
XubinMashruucWuxuu heerka mashruuca ku samayn karaa saadaalin, ku adeegsan karaa khayraadka, kuna abuuri karaa furayaal.

Haddii aanan Milkiile ka ahayn ururka, maxaan geli karaa?

Isticmaaleyaasha aan Milkiileyaal ka ahayn ururka waxay arki karaan oo keliya mashaariicda ay xubnaha ka yihiin. Keliya milkiilaha ururka ayaa heerka mashruuca ka arki kara dhammaan mashaariicda, xubnaha iyo furayaasha API, wuxuuna geli karaa bogga Mashaariicda.

  • Keliya xubnaha mashruuca (iyo milkiilayaasha ururka) ayaa arki kara noocyada si gaar ah loo habeeyey ee mashruucaas laga dhex abuuray, taxaneyaasha wada hadalka ee Kaaliyeyaal kasta oo la abuuray, ama faylal kasta oo lagu daray.

  • Xubnaha mashruucu waxay arki karaan dhammaan xubnaha kale ee mashruucaas iyo doorarkooda (tusaale, Milkiile ama Xubin).

Sideen u cusboonaysiiyaa doorka mashruuc ee isticmaale ama uga saaraa isticmaale mashruuca?

Keliya Milkiilaha mashruuca ayaa cusboonaysiin kara doorka mashruuc ee isticmaale ama ka saari kara isticmaale mashruuca. Wixii macluumaad dheeraad ah, eeg doorarka iyo oggolaanshaha.

Si aad isticmaale mashruuc ku jira u cusboonaysiiso, tag dejimaha ururkaaga, dooro mashruuca, kadibna guji Xubnaha. Waxaad doorka xubin kasta u dejin kartaa Xubin ama Milkiile. Waxaad sidoo kale dooran kartaa Ka saar si aad isticmaalaha uga saarto mashruuca.

Waa maxay akoon adeeg, muxuuse kaga duwan yahay akoonka isticmaale ee caadiga ah?

Akoonka adeeggu wuxuu u shaqeeyaa sidii isticmaale macmal ah oo loogu talagalay gelitaanka nidaamka, kana duwan akoonnada isticmaaleyaasha gaarka ah. Keliya milkiilayaasha ururka iyo mashruuca ayaa abuuri kara akoonno adeeg.

Akoonnada adeeggu waxay ku xaddidan yihiin oo keliya mashaariicda.

Xubin ku dar mashruuc

Haddii aad gujiso badhanka + Ku dar xubin, waxaad arki doontaa liiska isticmaaleyaasha ururkaaga ee leh doorka Akhriste. Haddii aad rabto inaad ku darto isticmaale aan hadda ururkaaga ku jirin, waa inaad marka hore ururka ku dartaa (waxaad ka tegi kartaa sanduuqa 'Ku dar Mashruuca Caadiga ah" isagoo aan calaamadsanayn haddii aadan rabin inaad isticmaaleyaashaas siiso marin ballaaran). Liiskan kuma jiraan akoonnada adeegga. Tallaabadan waxaad ku dooran kartaa in doorkoodu noqdo Milkiile ama Xubin:

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

Markaad xubin kooxeed ku darto, waa inaad u qoondaysaa doorka Xubin ama Milkiile. Xubnaha mashruucu waxay samayn karaan codsiyada API ee akhriya ama beddela xogta, halka milkiilayaasha mashruucu ay sidoo kale beddeli karaan dejimaha iyo xadka kharashka mashruuca, ayna maamuli karaan xubnaha mashruuca. Wixii macluumaad dheeraad ah, eeg doorarka iyo oggolaanshaha.

Sida mashruuc loogu abuuro akoon adeeg

Marka hore, tag mashruuca aad rabto inaad akoon adeeg u abuurto adigoo ka dooranaya liiska hoos-u-dhaca ee ku yaal barta hagidda:

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

Kadib, tag dejimaha ururkaaga -> Mashruuc -> Xubnaha -> guji + Akoon adeeg:

Akoonnada adeegga ee lagu abuuro heerka mashruuca waxay u gaar yihiin mashruuca mana lagu isticmaali karo meel ka baxsan mashruuca lagu abuuray.

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

Magac-bixinta akoonka adeegga

Haddii aad akoonka adeegga ka abuurto heerka ururka ama mid u gaar ah mashruuc, markaad abuurayso waxaad samayn kartaa aqoonsi akoon adeeg oo gaar ah, kana kooban xarfo, tirooyin iyo jiitinno, si akoonka adeegga si fudud loo aqoonsado.

Kaydi furaha API ee akoonka adeegga

Markaad doorato badhanka Abuur, fure API ayaa isla markiiba loo abuuraa akoonka adeegga, waxaana la soo bandhigayaa furaha sirta ah. Furahan sirta ah ku kaydi meel ammaan ah oo sugan. Sababo amni dartood, mar kale kama arki kartid akoonkaaga OpenAI. Haddii aad lumiso furahan sirta ah, waa inaad mid cusub samaysataa.

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

Oggolaanshaha furaha API ee akoonka adeegga waxaa si caadi ah loogu dejiyaa akhrinta iyo qorista dhammaan khayraadka API ee mashruuca. Oggolaanshahan waxaa lagu cusboonaysiin karaa dejimaha Furayaasha API ee mashruucaaga.

Akoonnada adeegga waxaa xubnaha mashruuca lala taxaa bogga dejimaha xubnaha mashruucaaga. Fadlan eeg halkan si aad wax badan uga ogaato cusboonaysiinta ama ka saarista gelitaanka akoon adeeg ee bogga dejimaha xubnaha mashruucaaga.

Dhammaan akoonnada adeegga ee ku jira mashaariicda iyo ururradaba waxaa lagu soo bandhigi doonaa agagaarka isticmaalayaashaada bani’aadamka ah ee bogga xubnaha heerka ururka.

Akoonnada adeegga waxaa loo maareeyaa sida akoonnada caadiga ah. Laga bilaabo Ururka -> liiska Xubnaha, waxaad Ka saari kartaa akoon adeeg ama cusboonaysiin kartaa doorka:

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

Sideen u maamulaa furayaasha API ee mashaariicda ururkayga?

Waxaad bogga dejimaha mashruuc kasta ka abuuri oo ka maamuli kartaa furayaashiisa API. Gudaha dejimaha ururkaaga, dooro mashruuca, kadibna guji Furayaasha API.

Si aad u abuurto fure sir cusub, dooro + Abuur fure sir cusub. Waxaad sidoo kale dooran kartaa summadda Wax ka beddel ee ku xigta fure sir si aad oggolaanshihiisa u beddesho.

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

Waxaad oggolaanshaha fure kasta oo API ah dejin kartaa markaad abuurayso fure sir cusub ama markaad wax ka beddelayso fure jira.

Saddex heer oo oggolaansho ayaa jira: Dhammaan, Xaddidan iyo Akhris Keliya.

  • Dhammaan — Furaha sirta ah waxaa loo dejiyaa oggolaansho buuxa. Kani waa dejinta caadiga ah.

  • Xaddidan — Waxay u oggolaanaysaa isticmaalaha inuu bar-dhammaad kasta u dejiyo oggolaanshaha Midna, Akhris iyo Qoris.

  • Tusaale ahaan, waxaad abuuri kartaa fure API oo si gaar ah aan oggolaansho ugu lahayn inuu wax ka Akhriyo ama wax ugu Qoro bar-dhammaadka /v1/assistants:

Create new secret key dialog in the API platform with Restricted permissions selected
  • Akhris Keliya — Oggolaanshaha akhriska ayaa loo dejiyaa dhammaan bar-dhammaadyada.

Sidee loo maamulaa gelitaanka isticmaaleyaasha ka tirsan mashaariic ama ururro badan?

Isticmaaleyaashu waxay xubno ka noqon karaan mashaariic inta loo baahdo. Mashruuc dhexdiisa, isticmaaleyaashu waxay samaysan karaan fure API oo gaar ah, kuna kooban gelitaanka mashruucaas iyo khayraadkiisa.

Sideen u dejiyaa una maamulaa xadka xawaaraha ee mashaariicda ururkayga?

Keliya Milkiilaha ururka ayaa dejin kara oo maamuli kara xadka xawaaraha ee heerka mashruuca. Wixii macluumaad dheeraad ah, eeg doorarka iyo oggolaanshaha.

Gudaha dejimaha ururkaaga, guji mashruuca aad rabto inaad cusboonaysiiso, kadibna qaybta Mashruuca ee liiska hagidda ka dooro Xaddidaadaha. Boggan waxaad ku cusboonaysiin kartaa Isticmaalka Nooca.

Isticmaalka nooca wuxuu kuu oggolaanayaa inaad habayso noocyada uu mashruucu adeegsan karo, halka xadka xawaaraha loo dejin karo nooc kasta hadba sida loogu baahdo.

Sideen u dejiyaa una maamulaa xadka kharashka mashaariicda ururkayga?

Keliya Milkiilayaasha ururka iyo Milkiilayaasha mashruuca ayaa dejin kara oo maamuli kara xadka kharashka mashruuca. Wixii macluumaad dheeraad ah, eeg doorarka iyo oggolaanshaha. Si aad xadka heerka ururka u beddesho, gudaha dejimaha ururkaaga, guji Xaddidaadaha, kadibna hoos ugu dhaadhac Xadka isticmaalka.

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

Si aad u dejiso xadka mashruucaaga, gudaha dejimaha ururkaaga, guji mashruuca aad rabto inaad cusboonaysiiso, kadibna dooro Xaddidaadaha. Waxaad cusboonaysiin kartaa Xadka kharashka billaha ah, Heerka ogeysiiska, iyo Isticmaalka Nooca.

Dejinta xadka kharashka billaha ah waxay kuu oggolaanaysaa inaad mashruucaaga u dejiso heerar kharash oo dabacsan. Marka isticmaalku ka bato xadkan bil taariikheed gudaheed (UTC), codsiyada API si aan kala go' lahayn ayaa loo sii farsamayn doonaa. Astaantan waxaa loogu talagalay inay kaa caawiso la socodka isticmaalka iyadoo adeegsanaysa digniinaha xadka kharashka, balse ma dhaqan geliso saqaf kharash oo adag. Marka la abuuro xadka kharashka mashruuca, digniin ayaa si caadi ah looga abuuraa heerka 100%. Digniino dheeraad ah oo heerar kala duwan leh ayaa lagu dejin karaa adigoo gujinaya Ku dar Digniin.

Ogow in milkiilaha ama milkiilayaasha ururka iyo kuwa mashruucu ay mar walba heli doonaan farriimahan, taasna lama habayn karo.

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

Sideen xadka kharashka ugu dejiyaa ururkayga ama mashruucayga?

OpenAI hadda waxay taageertaa xadka kharashka API ee billaha ah, heerarka ururka iyo mashruuca labadaba. Xadka kharashku wuxuu la socon karaa kharashka isaga oo aan la dhaqan gelin, ama waxaad ka dhigi kartaa xad adag si codsiyada API u fashilmaan marka kharashku xadka gaaro. Tallaabooyinka habaynta iyo habdhaqanka ugu dambeeya, ka eeg Xadka kharashka ee dukumentiyada horumariyeyaasha.

Sideen u tirtiraa ama u kaydiyaa mashruuc?

Mashaariicda waxaa lagu kaydin karaa bogga cusub ee liiska mashaariicda ama dejimaha mashruuc gaar ah. Marka mashruuc la kaydiyo, dib looma soo celin karo. Markaad kaydinta sii waddo, waxaa lagaa codsan doonaa inaad geliso magaca mashruuca si aad u sii socoto.

Waxaad liiska dhammaan mashaariicda la kaydiyey ka arki kartaa tabka “La kaydiyey” ee isla bogga liiska mashaariicda.

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

Suurtagal ma aha in mashaariic la tirtiro. Waxaan kaydinnaa taariikhda dhammaan mashaariicda si loo joogteeyo dabagalka isticmaalka iyo biil-bixinta.

Tirada mashaariicda aan ururkayga ku yeelan karo xad ma leedahay?

Sida caadiga ah, ururradu waxay abuuri karaan ilaa 2,000 mashruuc.

Khayraadka ma la wadaagi karaa mashaariicda?

Khayraadka mashruuca (sida faylasha, kaaliyeyaasha, kaydinta ama taxaneyaasha wada hadalka) wuxuu ku kooban yahay mashruuca, mana geli karaan xubnaha aan maamuleyaasha ahayn ee mashruuca ka baxsan. Intaa waxaa dheer, khayraadka looma kala wareejin karo mashaariicda.

Marka laga reebo hal xaalad oo ah in fine-tunes-ka ku jira “Mashruuca caadiga ah” laga geli karo mashaariic kale.

Waa immisa qoondada kaydinta faylasha ee mashruuc kasta?

OpenAI waxay hadda mashruuc kasta taageertaa qoondo kaydinta faylasha ah 100 GB.

Haddii qoondadan la dhaafo, waxaad arki doontaa ciladdan:

Waxaad dhaaftay xaddiga qoondada kaydinta faylasha. Ururradu waxay ku kooban yihiin 100 GB oo faylal ah. Fadlan yaree cabbirka faylka ama la xiriir taageerada.

Waxaan kugula talinaynaa inaad tirtirto faylasha aan la isticmaalin ee ku kaydsan akoonkaaga. Tixraac ahaan, waxaad API-ga ku arki kartaa kuna taxliili kartaa faylasha.

Waxaan ahay milkiilaha mashruuca, maxaan u arki la'ahay Boodhka Isticmaalka ee mashruucayga?

Muuqashada Boodhka Isticmaalka mashruucu kuma xirna doorka isticmaaluhu ku leeyahay mashruuca. Taa beddelkeeda, waxaa go'aamiya doorkaaga ururka dhexdiisa iyo dejimaha ku yaal https://platform.openai.com/settings/organization/data-controls/visibility

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

Haddii aadan arki karin Boodhka Isticmaalka, dejintan waxay u badan tahay inay tahay "U muuqda milkiilayaasha ururka".

Maqaalkani faa'iido ma kuu lahaa?