OpenAI
Šo lapu tulkoja mašīntulks. Skatīt oriģinālo rakstu angļu valodā.

Projektu pārvaldība API platformā

Izveidojiet un pārvaldiet API projektus, tostarp dalībnieku piekļuvi, pakalpojumu kontus, API atslēgas, piekļuvi modeļiem, lietojumu un tēriņu ierobežojumus.

Atjaunināts: 21 hours ago

Pārskats

Projekti palīdz organizēt darbu API organizācijā. Izmantojiet tos, lai pārvaldītu piekļuvi, konfigurētu modeļu un darbības ierobežojumus, izveidotu pakalpojumu kontus un sekotu lietojumam, norēķiniem un tēriņu ierobežojumiem noteiktam resursu kopumam, piemēram, modeļiem, iespējām, pavedieniem, asistentiem, precīzajai pielāgošanai un krātuvei.

Organizācijas īpašnieki var skatīt visus aktīvos un arhivētos projektus lapā Projekti.

Image

Pirms sākat

Lai izveidotu projektu, jums ir nepieciešama organizācijas īpašnieka loma. Pēc noklusējuma organizācijas var izveidot līdz 2000 projektiem.

Ja jūsu organizācija izmanto konsolidētu norēķinu sistēmu, apakšorganizācijas organizāciju atlasītājā tiek rādītas atsevišķi. Apakšorganizācijā nevar izveidot projektus.

Lai pārslēgtos uz citu organizāciju, atveriet organizāciju atlasītāju un atlasiet organizāciju, kuru vēlaties izmantot.

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

Noklusējuma projekts

Katrā organizācijā ir noklusējuma projekts, kuru nevar izdzēst. Tas pārmanto visu organizācijas konfigurāciju. Varat konfigurēt tā darbības ierobežojumus, virtuālo modeļu atļaujas un tēriņu ierobežojumus.

Noklusējuma projektam nevar tieši pievienot dalībniekus vai pakalpojumu kontus. Piekļuvi noklusējuma projektam varat piešķirt, uzaicinot kādu pievienoties organizācijai un veicot šajā rakstā aprakstītās uzaicināšanas darbības.

Izveidot projektu

  1. Atveriet projektu atlasītāju un atlasiet Izveidot projektu.

  2. Ievadiet projekta nosaukumu, aprakstu un tīmekļa vietni.

  3. Atlasiet Izveidot.

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

Organizācijas īpašnieki tiek automātiski pievienoti jaunajiem projektiem kā īpašnieki.

Izprast lomas un piekļuvi

Tabulā ir apkopotas šajās darbībās izmantotās organizācijas īpašnieka un lasītāja lomas, kā arī projekta īpašnieka un dalībnieka lomas. Projekta dalībnieku atļaujas ir līdzīgas organizācijas lasītāju atļaujām.

LomaTvērumsAtļaujas
ĪpašnieksOrganizācijaIzveidot un skatīt visus projektus, lietotājus un API atslēgas. Uzraudzīt projektus lapā Projekti. Iestatīt organizācijas un projektu tēriņu ierobežojumus. Piešķirt piekļuvi citu lietotāju lietojuma informācijai. Arhivēt projektus.
LasītājsOrganizācijaTikt pievienotam projektiem, veikt inferenci, izmantot resursus un izveidot atslēgas šajos projektos. Nevar izveidot projektus vai pārvaldīt lietotājus.
ĪpašnieksProjektsVisas dalībnieka atļaujas, kā arī iespēja pievienot lietotājus, pārvaldīt projekta dalībniekus un iestatījumus, pārdēvēt projektu, iestatīt tā tēriņu ierobežojumus un arhivēt to.
DalībnieksProjektsVeikt inferenci, izmantot resursus, izveidot projekta līmeņa atslēgas un nosūtīt API pieprasījumus, kas lasa vai maina datus.

Plašāku informāciju par organizācijas lomām skatiet rakstā Organizācijas lomas. Informāciju par papildu lomām, pielāgotajām lomām un visām atļaujām skatiet API lomu un atļauju rokasgrāmatā.

Projektu redzamība

Lietotāji ar šīm standarta lomām, kuri nav organizācijas īpašnieki, var redzēt tikai tos projektus, kuros viņi ir dalībnieki. Organizācijas īpašnieki var redzēt visus projektus, dalībniekus un projektu līmeņa API atslēgas, kā arī piekļūt lapai Projekti.

Projekta dalībnieki var redzēt pārējos sava projekta dalībniekus un katra dalībnieka lomu. Tikai projekta dalībnieki un organizācijas īpašnieki var redzēt šajā projektā izveidotos vai pievienotos precīzi pielāgotos modeļus, asistentu pavedienus un failus.

Varat būt dalībnieks tik daudzos projektos, cik nepieciešams. Projektā izveidota personiskā API atslēga ir piesaistīta šim projektam un tā resursiem.

Resursu nodalījums

Faili, asistenti, krātuve un pavedieni ir piesaistīti savam projektam. Dalībnieki, kuri nepieder šim projektam un nav administratori, nevar piekļūt tā resursiem, un resursus nevar pārvietot starp projektiem.

Izņēmums ir noklusējuma projektā precīzi pielāgotie modeļi: tiem var piekļūt no citiem projektiem.

Pārvaldīt projekta dalībniekus

Uzaicināt kādu pievienoties jūsu organizācijai

Lai personu varētu pievienot projektam, tai vispirms jābūt jūsu organizācijas dalībniekam.

Uzaicinot kādu pievienoties organizācijai, varat piešķirt arī piekļuvi noklusējuma projektam, uzaicinājuma veidlapā atzīmējot attiecīgo opciju. Neatzīmējiet to, ja nevēlaties piešķirt piekļuvi noklusējuma projektam. Jaunie organizācijas dalībnieki netiek automātiski pievienoti noklusējuma projektam.

Pirms kādu uzaicināt, nav jāizveido vēl viens projekts. Varat arī pievienot personu projektam pēc tam, kad tā ir pieņēmusi uzaicinājumu pievienoties organizācijai.

Uz uzaicinājumiem, kas nosūtīti, izmantojot administratora API, attiecas galapunkta /organization/invites noteikumi.

Pievienot organizācijas dalībnieku projektam

Organizācijas un projektu īpašnieki var pievienot dalībniekus:

  1. Atveriet organizācijas iestatījumus.

  2. Atlasiet projektu un atveriet sadaļu Dalībnieki.

  3. Atlasiet + Pievienot dalībnieku.

  4. Atlasiet lietotāju un piešķiriet lomu Dalībnieks vai Īpašnieks.

Lietotāju sarakstā tiek rādīti organizācijas lietotāji ar lomu Lasītājs. Pakalpojumu konti tajā nav iekļauti.

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

Ja uzaicinājumu neizdodas nosūtīt lietotāja saskarnē vai administratora API, pirms atkārtotas nosūtīšanas pārliecinieties, ka mērķa projekts pastāv un nav arhivēts.

Mainīt lomu vai noņemt dalībnieku

Organizācijas un projektu īpašnieki var mainīt lietotāja lomu projektā vai noņemt lietotāju no šī projekta.

  1. Atveriet organizācijas iestatījumus.

  2. Atlasiet projektu un atveriet sadaļu Dalībnieki.

  3. Iestatiet lietotājam lomu Dalībnieks vai Īpašnieks vai atlasiet Noņemt, lai viņu noņemtu.

Izveidot un pārvaldīt pakalpojumu kontus

Pakalpojuma konts nodrošina piekļuvi sistēmai, nevis pārstāv atsevišķu lietotāju. Pakalpojumu konti ir piesaistīti projektiem.

Lai izveidotu pakalpojumu kontus, ir nepieciešamas pakalpojumu kontu pārvaldības atļaujas. Organizācijas un projektu īpašniekiem ir šīs atļaujas.

Izveidot pakalpojuma kontu

  1. Projektu atlasītājā izvēlieties projektu.

  2. Atveriet organizācijas iestatījumus un atlasiet projektu.

  3. Atveriet sadaļu Dalībnieki un atlasiet + Pakalpojuma konts.

  4. Ievadiet unikālu pakalpojuma konta ID, izmantojot burtus, ciparus un defises.

  5. Atlasiet Izveidot.

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

Servisa konti, kas izveidoti projekta līmenī, ir unikāli projektam, un tos nevar izmantot ārpus projekta, kurā tie ir izveidoti.

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

Neatkarīgi no tā, vai pakalpojuma kontu izveidojat organizācijas vai projekta līmeņa iestatījumos, tiek izmantots viens un tas pats ID formāts.

Projektam izveidots pakalpojuma konts ir unikāls šim projektam, un to nevar izmantot ārpus tā.

Saglabāt slepeno atslēgu

Izveidojot pakalpojuma kontu, uzreiz tiek izveidota API atslēga un parādīta tās slepenā atslēga. Saglabājiet slepeno atslēgu drošā vietā. Savā OpenAI kontā to vairs nevarēsiet apskatīt. Ja to pazaudējat, ģenerējiet jaunu atslēgu.

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

Pēc noklusējuma pakalpojuma konta atslēga ļauj lasīt un rakstīt visus API resursus tā projektā. Šīs atļaujas varat mainīt vēlāk projekta iestatījumu sadaļā API atslēgas.

Atjaunināt vai noņemt pakalpojuma kontu

Pakalpojumu konti tiek rādīti līdzās lietotājiem projekta iestatījumu sadaļā Dalībnieki. Pārvaldiet to piekļuvi projektam, veicot tās pašas lomas maiņas un noņemšanas darbības, ko citiem projekta dalībniekiem.

Visi pakalpojumu konti tiek rādīti arī līdzās lietotājiem organizācijas lapā Dalībnieki, tostarp konti, kas izveidoti organizācijas vai projekta līmeņa iestatījumos.

Organizācijas izvēlnē Dalībnieki varat mainīt pakalpojuma konta lomu vai atlasīt Noņemt.

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

Izveidot un pārvaldīt API atslēgas

Katram projektam ir savas API atslēgas:

  1. Atveriet organizācijas iestatījumus.

  2. Atlasiet projektu un atveriet sadaļu API atslēgas.

  3. Atlasiet + Izveidot jaunu slepeno atslēgu, lai izveidotu atslēgu, vai atlasiet rediģēšanas ikonu blakus esošai atslēgai, lai mainītu tās atļaujas.

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

Izvēlēties atslēgas atļaujas

Lietotājiem piederošu atslēgu atļaujas varat iestatīt, veidojot atslēgu, vai rediģēt vēlāk:

  • Visas: visas atļaujas. Šis ir noklusējuma iestatījums.

  • Ierobežotas: izvēlieties piekļuves tvērumu konkrētiem resursiem vai galapunktiem. Pieejamās opcijas ir atkarīgas no resursa un var ietvert Nav, Lasīt, Rakstīt vai konkrētiem pieprasījumiem paredzētas atļaujas.

  • Tikai lasīšana: lasīšanas atļaujas visiem galapunktiem.

Piemēram, ierobežota atslēga var liegt lasīšanas un rakstīšanas piekļuvi galapunktam /v1/assistants.

Create new secret key dialog in the API platform with Restricted permissions selected

Lai izveidotu pakalpojumu kontu atslēgas, ir nepieciešamas pakalpojumu kontu pārvaldības atļaujas. Ja šī opcija nav redzama, lūdziet organizācijas vai projekta īpašniekam izveidot pakalpojuma konta atslēgu. Atslēgas izveides dialoglodziņā pakalpojumu kontu atslēgām šīs atļauju opcijas netiek rādītas; mainiet to atļaujas vēlāk projekta iestatījumu sadaļā API atslēgas.

Konfigurēt piekļuvi modeļiem un darbības ierobežojumus

Projekta darbības ierobežojumu pārvaldībai ir nepieciešamas administratora atļaujas. Organizācijas īpašniekiem ir šīs atļaujas, un arī projektu īpašnieki var pārvaldīt projektu darbības ierobežojumus, izmantojot pārvaldības API.

  1. Atveriet organizācijas iestatījumus.

  2. Atlasiet projektu un atveriet sadaļu Ierobežojumi.

  3. Izmantojiet iestatījumu Modeļu lietojums, lai izvēlētos, kurus modeļus projektā var izmantot.

  4. Pēc vajadzības iestatiet darbības ierobežojumu katram modelim.

Iestatīt tēriņu ierobežojumus un brīdinājumus

API mēneša izdevumu limitus var iestatīt gan organizācijas, gan projekta līmenī. Lai mainītu limitu, jums jābūt tiesībām pārvaldīt attiecīgās organizācijas vai projekta iestatījumus.

Izdevumu limitu var izmantot izdevumu pārraudzībai, neapturot pieprasījumus. Ieslēdziet opciju Piemērot stingru izdevumu limitu, ja vēlaties, lai API pieprasījumi tiktu noraidīti, kad uzskaitītie izdevumi sasniedz limitu. Ierobežojums nestājas spēkā uzreiz, tāpēc uzskaitītie izdevumi var nedaudz pārsniegt iestatīto summu.

Brīdinājumi par izdevumiem informē jūs, kad ir sasniegts slieksnis; tie neaptur pieprasījumus.

Organizācijas izdevumu limita iestatīšana

  1. Dodieties uz organizācijas iestatījumiem.

  2. Atveriet sadaļu Limiti un atrodiet sadaļu Izdevumi.

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

Projekta izdevumu limita iestatīšana

  1. Dodieties uz organizācijas iestatījumiem.

  2. Atlasiet projektu un pēc tam atveriet sadaļu Limiti.

  3. Iestatiet vērtības laukos Mēneša izdevumu limits un Brīdināt, kad izdevumi sasniedz.

  4. Ieslēdziet opciju Piemērot stingru izdevumu limitu, ja vēlaties apturēt API pieprasījumus, kad uzskaitītie izdevumi sasniedz limitu.

Šajā lapā varat mainīt arī modeļu lietojumu.

Ja jūsu izdevumi pārsniedz projekta mēneša budžetu, salīdziniet tā paša projekta lietojuma datus par attiecīgo mēnesi. Pārbaudiet, vai lietošanas laikā bija ieslēgta opcija Piemērot stingru izdevumu limitu. Ja tā bija izslēgta, budžets kalpoja izdevumu pārraudzībai un API pieprasījumi turpinājās. Ja vēlaties, lai turpmāk pieprasījumi tiktu noraidīti, kad uzskaitītie izdevumi sasniedz budžetu, organizācijas vai projekta īpašnieks var ieslēgt opciju Piemērot stingru izdevumu limitu projekta iestatījumu sadaļā Limiti.

Ja stingrais limits jau bija ieslēgts, uzskaitītie izdevumi tik un tā var nedaudz pārsniegt budžetu, kamēr ierobežojums stājas spēkā. Ja attiecīgā projekta izdevumi par konkrēto mēnesi joprojām ievērojami pārsniedz piemēroto limitu un pēc šīm pārbaudēm iemesls nav skaidrs, sazinieties ar atbalsta dienestu, norādot projekta ID, piemēroto limitu, uzskaitītos izdevumus, kā arī attiecīgos datumus un laika joslu. Ja pieejami, pievienojiet attiecīgo pieprasījumu ID. Neiekļaujiet API atslēgas.

Izdevumu brīdinājumu pārvaldība

Iestatot projekta izdevumu limitu, pēc noklusējuma tiek izveidots arī brīdinājums par 100% no limita sasniegšanu. Atlasiet Pievienot brīdinājumu, lai pievienotu brīdinājumus par citu sliekšņu sasniegšanu.

Brīdinājumus par projekta izdevumiem saņem organizācijas un projekta īpašnieki. Brīdinājumu iestatījumos varat pievienot citus e-pasta saņēmējus.

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

Aktuālās konfigurēšanas darbības un informāciju par ierobežojumu piemērošanu skatiet tēriņu ierobežojumu rokasgrāmatā.

Skatīt lietojumu un norēķinus

Lietojuma datus var skatīt sadalījumā pa projektiem, un katram projektam varat skatīt norēķinu datus un iestatīt tēriņu ierobežojumus.

Piekļuve projekta lietojuma informācijas panelim ir atkarīga no jūsu lomas organizācijā un lietojuma informācijas paneļa redzamības iestatījumiem. Projekta īpašnieka loma pati par sevi nepiešķir piekļuvi.

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

Ja neredzat projekta lietojuma informācijas paneli, pārbaudiet, vai redzamība nav iestatīta uz Redzams organizācijas īpašniekiem.

Pārvaldīt failu krātuvi

Katram projektam failu glabāšanai ir piešķirta 100 GB kvota. Ja to pārsniegsiet, var tikt parādīta šāda kļūda:

Jūs esat pārsniedzis failu glabāšanas kvotu. Organizācijām failu glabāšanai ir noteikts 100 GB ierobežojums. Lūdzu, samaziniet faila lielumu vai sazinieties ar atbalsta dienestu.

Izdzēsiet neizmantotos failus, lai atbrīvotu vietu krātuvē. Varat iegūt saglabāto failu sarakstu, izmantojot API, lai atrastu failus, kas vairs nav vajadzīgi.

Arhivēt projektu

Organizācijas un projektu īpašnieki var arhivēt projektus lapā Projekti vai attiecīgā projekta iestatījumos. Kad tiek prasīts apstiprinājums, ievadiet projekta nosaukumu.

Arhivēšana ir neatgriezeniska: arhivētu projektu nevar atjaunot.

Lai skatītu arhivētos projektus, lapā Projekti atveriet cilni Arhivētie.

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

Vienīgais izņēmums ir tas, ka modeļiem ar smalko pielāgošanu “Noklusējuma projektā” var piekļūt no citiem projektiem.

Jūs esat pārsniedzis failu glabātuves kvotu. Organizācijām ir noteikts 100 GB failu ierobežojums. Lūdzu, samaziniet faila izmēru vai sazinieties ar atbalstu.

Projektus nevar izdzēst. OpenAI saglabā to vēsturi lietojuma un norēķinu uzskaitei.

Vai šis raksts bija noderīgs?