API հարթակում նախագծերի կառավարում

Նախագծերը նախատեսված են հաճախորդներին իրենց աշխատանքը կազմակերպելու հնարավորություն տալու համար։ Կազմակերպությունները կարող են կառավարել հասանելիությունն ու սահմանաչափերը, ստեղծել ծառայողական հաշիվներ (UI-ի միջոցով) և նախագծի սահմանափակ շրջանակում հետևել օգտագործմանը (օրինակ՝ մոդելներ, հնարավորություններ, թելեր, օգնականներ, fine tuning, պահեստ և այլն)։ Օգտագործման ակտիվությունը կարելի է բաժանել ըստ նախագծերի, իսկ օգտատերերը կարող են դիտել վճարային տվյալները և յուրաքանչյուր նախագծի համար սահմանել ծախսերի սահմանաչափեր։

Կազմակերպության սեփականատերերը կարող են իրենց բոլոր ակտիվ և արխիվացված նախագծերը տեսնել Նախագծերի էջում։ Իմացեք ավելին API Platform-ում օգտատերերի դերերի և թույլտվությունների մասին։

Ո՞վ կարող է ստեղծել նախագիծ։

Միայն կազմակերպության սեփականատերերը կարող են ստեղծել նախագիծ։ Լրացուցիչ տեղեկությունների համար տես դերերն ու թույլտվությունները։

Կազմակերպությունների միջև փոխարկվելու համար մկնիկի ցուցիչը պահեք էջի վերևի ձախ մասում գտնվող ձեր կազմակերպության անվան վրա և ցանկից ընտրեք կազմակերպությունը։

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

Այն կազմակերպությունների համար, որոնք համախմբված վճարումների պլանում են, ենթակազմակերպությունները նույնականացվում են առանձին։ Ենթակազմակերպություններում նախագծեր ստեղծել հնարավոր չէ։

Ինչպե՞ս են աշխատում նախագծերը։

Յուրաքանչյուր կազմակերպություն ներառում է «Լռելյայն նախագիծ», որը չի կարող ջնջվել։ Կարող եք կարգավորել հաճախականության սահմանաչափերը, վիրտուալ մոդելների թույլտվությունները և ծախսերի սահմանաչափերը (2024 թվականի նոյեմբերի դրությամբ)։ Այն ժառանգում է կազմակերպության ամբողջ կարգավորումը, ուստի չեք կարող անմիջապես դրան ավելացնել անդամներ կամ ծառայողական հաշիվներ։

Ինչպե՞ս ստեղծել նախագիծ։

Նախ մկնիկի ցուցիչը պահեք էջի ձախ անկյունում գտնվող նախագծի անվան վրա և ընտրեք Ստեղծել նախագիծ։

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

Ինչպե՞ս օգտատերեր ավելացնել նախագծում։

Կազմակերպության նոր ավելացված անդամները ինքնաբերաբար չեն ավելացվում «Լռելյայն նախագիծ» նախագծում։ Նոր անդամներին կարելի է հրավիրել նախագիծ կազմակերպություն հրավիրելու պահին՝ նշելով «Հրավիրել լռելյայն նախագիծ» վանդակը, կամ կազմակերպության հրավերն ընդունելուց հետո։

Ադմինիստրատորի API-ի միջոցով հրավիրված օգտատերերի համար գործում են /organization/invites վերջնակետի կանոնները։

Եթե միջերեսի կամ Ադմինիստրատորի API-ի միջոցով օգտատերերին նախագիծ հրավիրելիս սխալ է առաջանում, հրավերը կրկին ուղարկելուց առաջ համոզվեք, որ նպատակային նախագիծը գոյություն ունի և արխիվացված չէ։

Կազմակերպության սեփականատերերն ինքնաբերաբար որպես սեփականատեր են ավելացվում կազմակերպությունում ստեղծված նոր նախագծերին։

Որո՞նք են կազմակերպություններում և նախագծերում օգտատերերի տարբեր դերերը, և ի՞նչ թույլտվություններ են դրանք ներառում։

Մինչ կազմակերպություններն ունեն «սեփականատեր» և «ընթերցող» դերեր, նախագծերն ունեն «սեփականատեր» և «անդամ» դերեր։ Նախագծի անդամները համարժեք են կազմակերպության ընթերցողներին։ Յուրաքանչյուր օգտատիրոջ դերին ուղեկցող թույլտվությունների ավելի մանրամասն նկարագրության համար տես ստորև բերված աղյուսակը։

Դեր	Շրջանակ	Նկարագրություն
Սեփականատեր	Կազմակերպություն	Կարող է ստեղծել/դիտել բոլոր նախագծերը, բոլոր օգտատերերին և բոլոր API բանալիները։ Կարող է կազմակերպության բոլոր նախագծերը վերահսկել Նախագծերի էջի միջոցով։ Կարող է սահմանել կազմակերպության և նախագծերի ծախսերի սահմանաչափերը։ Կարող է թույլտվություններ տրամադրել՝ կազմակերպության այլ անձանց օգտագործման տեղեկությունները դիտելու համար։ Կարող է արխիվացնել նախագծեր։
Ընթերցող	Կազմակերպություն	Կարող է կատարել inference, օգտագործել ռեսուրսներ և իր նախագծերում ստեղծել բանալիներ։ Կարող է ավելացվել նախագծերին։ Չի կարող ստեղծել նախագծեր և կառավարել օգտատերերին։
Սեփականատեր	Նախագիծ	Կարող է նախագծին ավելացնել այլ օգտատերերի և վերանվանել նախագիծը, ինչպես նաև ունի Անդամի բոլոր հնարավորությունները։ Կարող է սահմանել նախագծի ծախսերի սահմանաչափերը։ Կարող է արխիվացնել նախագիծը։
Անդամ	Նախագիծ	Կարող է նախագծի մակարդակում կատարել inference, օգտագործել ռեսուրսներ և ստեղծել բանալիներ։

Եթե կազմակերպության Սեփականատեր չեմ, ի՞նչ հասանելիություն ունեմ։

Կազմակերպության Սեփականատեր չհանդիսացող օգտատերերը կարող են տեսնել միայն այն նախագծերը, որոնց անդամ են։ Միայն կազմակերպության սեփականատերը կարող է նախագծի մակարդակում տեսնել բոլոր նախագծերը, անդամներին և API բանալիները, ինչպես նաև մուտք գործել Նախագծեր էջ։

Միայն նախագծի անդամները և կազմակերպության սեփականատերերը կարող են տեսնել տվյալ նախագծում ստեղծված ճշգրտված մոդելները, ստեղծված Օգնականների հոսքերը կամ ավելացված ֆայլերը։
Նախագծի անդամները կարող են տեսնել այդ նախագծի մյուս բոլոր անդամներին և նրանց դերերը՝ օրինակ՝ Սեփականատեր կամ Անդամ։

Ինչպե՞ս փոխել օգտատիրոջ դերը նախագծում կամ հեռացնել նրան նախագծից։

Օգտատիրոջ դերը նախագծում կարող է փոխել կամ նրան նախագծից հեռացնել միայն նախագծի սեփականատերը։ Լրացուցիչ տեղեկությունների համար տե՛ս դերերն ու թույլտվությունները։

Նախագծում օգտատիրոջ տվյալները թարմացնելու համար անցեք կազմակերպության կարգավորումներ, ընտրեք նախագիծը և սեղմեք Անդամներ։ Յուրաքանչյուր անդամի համար կարող եք սահմանել Անդամ կամ Սեփականատեր դեր։ Օգտատիրոջը նախագծից հեռացնելու համար կարող եք նաև ընտրել Հեռացնել։

Ի՞նչ է ծառայողական հաշիվը, և ինչո՞վ է այն տարբերվում սովորական օգտատիրոջ հաշվից։

Ծառայողական հաշիվը հանդես է գալիս որպես համակարգային հասանելիության համար նախատեսված կեղծ-օգտատեր՝ տարբերվելով անհատական օգտատիրոջ հաշիվներից։ Միայն կազմակերպության և նախագծի սեփականատերերը կարող են ստեղծել ծառայողական հաշիվներ։

Ծառայողական հաշիվները սահմանափակվում են միայն նախագծերով։

Անդամի ավելացում նախագծում

Սեղմելով + Ավելացնել անդամ կոճակը՝ կտեսնեք ձեր կազմակերպության՝ Ընթերցող դերն ունեցող օգտատերերի ցանկը։ Եթե ցանկանում եք ավելացնել օգտատիրոջ, որը ներկայում ձեր կազմակերպության անդամ չէ, նախ պետք է նրան ավելացնեք կազմակերպությունում։ Եթե չեք ցանկանում այդ օգտատերերին ավելի լայն հասանելիություն տրամադրել, կարող եք չնշել «Ավելացնել լռելյայն նախագծում» վանդակը։ Այս ցանկում ծառայողական հաշիվները չեն ներառվում։ Այս քայլում կարող եք ընտրել նրանց դերը՝ Սեփականատեր կամ Անդամ։

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

Թիմի անդամ ավելացնելիս նրան պետք է նշանակեք կա՛մ Անդամ, կա՛մ Սեփականատեր դեր։ Նախագծի անդամները կարող են տվյալներ կարդացող կամ փոփոխող API հարցումներ կատարել, իսկ նախագծի սեփականատերերը կարող են նաև փոխել նախագծի կարգավորումներն ու ծախսերի սահմանաչափերը և կառավարել նախագծի անդամներին։ Լրացուցիչ տեղեկությունների համար տե՛ս դերերն ու թույլտվությունները։

Ինչպես ստեղծել ծառայողական հաշիվ նախագծի համար

Նախ անցեք այն նախագիծը, որի համար ցանկանում եք ծառայողական հաշիվ ստեղծել՝ ընտրելով այն նավարկման գոտու բացվող ցանկից։

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

Այնուհետև անցեք կազմակերպության կարգավորումներ -> Նախագիծ -> Անդամներ -> և սեղմեք + Ծառայողական հաշիվ։

Նախագծի մակարդակում ստեղծված ծառայողական հաշիվները եզակի են տվյալ նախագծի համար և չեն կարող օգտագործվել այն նախագծից դուրս, որտեղ ստեղծվել են։

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

Ծառայողական հաշվի անվանումը

Անկախ նրանից՝ ստեղծում եք ծառայողական հաշիվ կազմակերպության մակարդակում, թե նախագծին հատուկ հաշիվ, ծառայողական հաշիվ ստեղծելիս կարող եք կազմել եզակի ծառայողական հաշվի ID՝ բաղկացած տառերից, թվերից և գծիկներից, որպեսզի հեշտ լինի նույնականացնել ծառայողական հաշիվը։

Պահպանեք ծառայողական հաշվի API բանալին

Ստեղծել կոճակն ընտրելուց անմիջապես հետո ծառայողական հաշվի համար կստեղծվի API բանալի, և կցուցադրվի գաղտնի բանալին։ Պահպանեք այս գաղտնի բանալին ապահով և անվտանգ վայրում։ Անվտանգության նկատառումներով այն այլևս չեք կարողանա դիտել ձեր OpenAI հաշվի միջոցով։ Եթե կորցնեք այս գաղտնի բանալին, պետք է նորը ստեղծեք։

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

Լռելյայն՝ ծառայողական հաշվի API բանալին ունի նախագծի բոլոր API ռեսուրսները կարդալու և փոփոխելու թույլտվություն։ Այս թույլտվությունները կարող եք թարմացնել նախագծի API բանալիների կարգավորումներում։

Ծառայողական հաշիվները նախագծի անդամների հետ միասին նշված են նախագծի անդամների կարգավորումների էջում։ Նախագծի անդամների կարգավորումների էջում ծառայողական հաշվի հասանելիությունը թարմացնելու կամ հեռացնելու մասին ավելին իմանալու համար տե՛ս այստեղ։

Ինչպես նախագծերի, այնպես էլ կազմակերպությունների բոլոր ծառայողական հաշիվները կցուցադրվեն ձեր իրական օգտատերերի կողքին կազմակերպության մակարդակի անդամների էջում։

Ծառայողական հաշիվները կառավարվում են սովորական հաշիվների նման։ Organization -> Members menu-ից կարող եք հեռացնել ծառայողական հաշիվը կամ թարմացնել դերը։

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

Ինչպե՞ս կառավարել API բանալիները կազմակերպության նախագծերում։

Յուրաքանչյուր նախագծի API բանալիները կարող եք ստեղծել և կառավարել այդ նախագծի կարգավորումների էջում։ Կազմակերպության կարգավորումներում ընտրեք նախագիծը և սեղմեք API բանալիներ։

Նոր գաղտնի բանալի ստեղծելու համար ընտրեք + Ստեղծել նոր գաղտնի բանալի։ Գաղտնի բանալու թույլտվությունները խմբագրելու համար կարող եք նաև ընտրել դրա կողքի Խմբագրել պատկերակը։

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

Յուրաքանչյուր API բանալու թույլտվությունները կարող եք սահմանել նոր գաղտնի բանալի ստեղծելիս կամ գոյություն ունեցող բանալին խմբագրելով։

Հասանելի է թույլտվությունների երեք մակարդակ՝ Բոլորը, Սահմանափակ և Միայն ընթերցում։

Բոլորը — Գաղտնի բանալու համար սահմանվում են լիարժեք թույլտվություններ։ Սա լռելյայն կարգավորումն է։
Սահմանափակ — Օգտատիրոջը հնարավորություն է տալիս յուրաքանչյուր վերջնակետի համար սահմանել Ոչ մի, Ընթերցում և Գրում թույլտվությունները։

Օրինակ՝ կարող եք ստեղծել API բանալի, որը հատուկ չունի /v1/assistants վերջնակետից ընթերցելու կամ այնտեղ գրելու թույլտվություն։

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

Միայն ընթերցում — Բոլոր վերջնակետերի համար սահմանվում է ընթերցման թույլտվություն։

Ինչպե՞ս է կառավարվում հասանելիությունը այն օգտատերերի համար, որոնք պատկանում են մի քանի նախագծերի կամ կազմակերպությունների։

Օգտատերերը կարող են լինել այնքան նախագծերի անդամ, որքան անհրաժեշտ է։ Նախագծի ներսում օգտատերերը կարող են ստեղծել անձնական API բանալի, որը սահմանափակված է այդ նախագծով և նրա ռեսուրսներով։

Ինչպե՞ս սահմանել և կառավարել իմ կազմակերպության նախագծերի սահմանաչափերը։

Միայն կազմակերպության Սեփականատերը կարող է սահմանել և կառավարել նախագծի մակարդակի սահմանաչափերը։ Լրացուցիչ տեղեկությունների համար տես դերերն ու թույլտվությունները։

Ձեր կազմակերպության կարգավորումներում սեղմեք այն նախագծի վրա, որը ցանկանում եք թարմացնել, և նավիգացիոն ցանկի Նախագիծ բաժնում ընտրեք Սահմանաչափեր։ Այս էջում կարող եք թարմացնել ձեր Մոդելի օգտագործումը։

Մոդելի օգտագործումը թույլ է տալիս կարգավորել, թե որ մոդելները կարող են օգտագործվել նախագծի կողմից, իսկ սահմանաչափերը կարող են ըստ անհրաժեշտության սահմանվել յուրաքանչյուր մոդելի համար։

Ինչպե՞ս սահմանել և կառավարել կազմակերպության նախագծերի ծախսերի սահմանաչափերը։

Նախագծի ծախսերի սահմանաչափերը կարող են սահմանել և կառավարել միայն կազմակերպության և նախագծի սեփականատերերը։ Լրացուցիչ տեղեկությունների համար տե՛ս դերերն ու թույլտվությունները։ Կազմակերպության մակարդակի սահմանաչափերը փոխելու համար կազմակերպության կարգավորումներում սեղմեք Սահմանաչափեր, ապա ոլորեք ներքև՝ մինչև Օգտագործման սահմանաչափեր բաժինը։

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

Նախագծի սահմանաչափերը սահմանելու համար կազմակերպության կարգավորումներում սեղմեք այն նախագիծը, որը ցանկանում եք թարմացնել, ապա ընտրեք Սահմանաչափեր։ Կարող եք թարմացնել Ամսական ծախսերի սահմանաչափը, Ծանուցման շեմը և Մոդելների օգտագործումը։

Ամսական ծախսերի սահմանաչափ սահմանելով՝ կարող եք ձեր նախագծի համար ծախսերի ոչ կոշտ շեմեր հաստատել։ Եթե տվյալ օրացուցային ամսվա ընթացքում (UTC) օգտագործումը գերազանցի այս սահմանաչափը, API հարցումները կշարունակեն մշակվել առանց ընդհատման։ Այս գործառույթն օգնում է հետևել օգտագործմանը ծախսերի սահմանաչափի ծանուցումների միջոցով, սակայն ծախսերի համար կոշտ վերին սահման չի կիրառում։ Նախագծի ծախսերի սահմանաչափ ստեղծելիս լռելյայն ստեղծվում է ծանուցում 100% շեմի համար։ Այլ շեմերի համար լրացուցիչ ծանուցումներ սահմանելու նպատակով սեղմեք Ավելացնել ծանուցում։

Նկատի ունեցեք, որ կազմակերպության և նախագծի սեփականատերերը միշտ կստանան այս հաղորդագրությունները, և դա հնարավոր չէ հարմարեցնել։

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

Ինչպե՞ս սահմանեմ ծախսերի սահմանաչափեր իմ կազմակերպության կամ նախագծի համար։

OpenAI-ն այժմ աջակցում է ամսական API ծախսերի սահմանաչափեր ինչպես կազմակերպության, այնպես էլ նախագծի մակարդակներում։ Ծախսերի սահմանաչափը կարող է հետևել ծախսերին՝ առանց պարտադրելու, կամ կարող եք այն պարտադրել որպես կոշտ սահմանաչափ, որպեսզի API հարցումները ձախողվեն, երբ ծախսը հասնի սահմանաչափին։ Կարգավորման վերջին քայլերի և վարքագծի համար տես Ծախսերի սահմանաչափեր բաժինը մշակողների փաստաթղթերում։

Ինչպե՞ս ջնջել կամ արխիվացնել նախագիծը։

Նախագծերը կարելի է արխիվացնել նոր նախագծերի ցանկի էջից կամ առանձին նախագծի կարգավորումներից։ Արխիվացված նախագիծը հնարավոր չէ վերականգնել։ Արխիվացումը շարունակելու համար ձեզ կառաջարկվի մուտքագրել նախագծի անունը։

Բոլոր արխիվացված նախագծերի ցանկը կարող եք տեսնել նույն նախագծերի ցանկի էջի «Արխիվացված» ներդիրում։

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

Նախագծերը հնարավոր չէ ջնջել։ Մենք պահպանում ենք բոլոր նախագծերի պատմությունը՝ օգտագործման և վճարումների հաշվառման անընդհատությունն ապահովելու համար։

Կա՞ սահմանափակում իմ կազմակերպությունում նախագծերի քանակի վրա։

Կազմակերպությունները լռելյայն կարող են ստեղծել մինչև 2,000 նախագիծ։

Հնարավո՞ր է ռեսուրսներ համօգտագործել նախագծերի միջև։

Նախագծի ռեսուրսները (օրինակ՝ ֆայլեր, assistants, պահեստ, կամ threads) սահմանափակված են տվյալ նախագծով և հասանելի չեն նախագծից դուրս գտնվող ոչ-ադմին անդամներին։ Ավելին, ռեսուրսները չեն կարող տեղափոխվել նախագծերի միջև։

Միակ բացառությունն այն է, որ «Լռելյայն նախագիծ»-ի fine-tune-երը կարող են հասանելի լինել այլ նախագծերից։

Որքա՞ն է յուրաքանչյուր նախագծի ֆայլերի պահեստավորման քվոտան։

OpenAI-ն ներկայում յուրաքանչյուր նախագծի համար աջակցում է 100 ԳԲ ֆայլերի պահեստավորման քվոտա։

Այս քվոտան գերազանցելու դեպքում կտեսնեք հետևյալ սխալը։

Դուք գերազանցել եք ձեր ֆայլային պահեստի քվոտան։ Կազմակերպությունները սահմանափակված են 100 ԳԲ ֆայլերով։ Խնդրում ենք նվազեցնել ֆայլի չափը կամ կապվել աջակցման ծառայության հետ։

Խորհուրդ ենք տալիս ջնջել ձեր հաշվում պահված չօգտագործվող ֆայլերը։ Որպես տեղեկանք՝ կարող եք API-ի միջոցով դիտել և ցուցակագրել ֆայլերը։

Ես նախագծի սեփականատեր եմ․ ինչո՞ւ չեմ տեսնում իմ նախագծի Օգտագործման վահանակը։

Նախագծի Օգտագործման վահանակի տեսանելիությունը կապված չէ տվյալ նախագծում օգտատիրոջ դերի հետ։ Այն որոշվում է կազմակերպությունում ձեր դերով և https://platform.openai.com/settings/organization/data-controls/visibility էջի կարգավորումներով։

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

Եթե չեք տեսնում Օգտագործման վահանակը, հավանաբար այս կարգավորման համար ընտրված է «Տեսանելի է կազմակերպության սեփականատերերին» տարբերակը։