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

Իմացեք՝ ինչպես ստեղծել և կառավարել OpenAI API նախագծեր, այդ թվում՝ անդամներ, դերեր, ծառայողական հաշիվներ, 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

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

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

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

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

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

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

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

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

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

Կազմակերպությունում Սեփականատեր չհանդիսացող օգտատերերը կարող են տեսնել միայն այն նախագծերը, որոնց անդամ են։ Միայն կազմակերպության սեփականատերը կարող է նախագծի մակարդակով տեսնել բոլոր նախագծերը, անդամներին ու 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 նախագիծ։

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

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

Միակ բացառությունն այն է, որ «Լռելյայն նախագիծ»-ի 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

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