OpenAI
Оваа страница беше машински преведена. Погледнете ја оригиналната статија на англиски јазик.

Управување со проекти во API платформата

Дознајте како да создавате и управувате со OpenAI API-проекти, вклучувајќи членови, улоги, услужни сметки, API-клучеви, ограничувања на користењето и буџети.

Ажурирано: 4 days ago

Целта на проектите е да им овозможат на клиентите да ја организираат својата работа. Организациите можат да управуваат со пристапот и ограничувањата, да обезбедуваат сервисни сметки (преку корисничкиот интерфејс) и да го следат користењето во ограничен опсег во рамките на проект (на пр. модели, можности, нишки, асистенти, фино подесување, складирање итн.). Активноста на користење може да се раздели по проект, а корисниците можат да ја прегледуваат наплатата и да поставуваат ограничувања за трошење за секој проект.

Сопствениците на организацијата можат да ги прегледаат сите свои активни и архивирани проекти на страницата „Проекти“. Дознајте повеќе за корисничките улоги и дозволи во API платформата.

Image

Кој може да создаде проект?

Само сопствениците на организацијата може да создадат проект. За повеќе информации, погледнете во улоги и дозволи.

За да се префрлате меѓу организации, поставете го покажувачот врз името на организацијата во горниот лев агол на страницата и изберете ја организацијата од списокот:

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

Кај организациите со консолидиран план за наплата, подорганизациите се означени одделно. Во подорганизациите не може да се создаваат проекти.

Image

Како функционираат проектите?

Секоја организација има „Стандарден проект“ што не може да се избрише. Може да ги конфигурирате ограничувањата на стапката, дозволите за виртуелни модели и ограничувањата на трошоците (од ноември 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.

Ако се појави грешка при поканување корисници во проект преку корисничкиот интерфејс или 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-клучеви на проектот.

Услужните сметки се наведени заедно со членовите на проектот на страницата со поставки за членови на проектот. Погледнете овде за да дознаете повеќе за ажурирањето или отстранувањето на пристапот на услужната сметка на страницата со поставки за членови на проектот.

Сите сервисни сметки низ проектите и организациите ќе се прикажуваат заедно со вашите човечки корисници на страницата за членови на ниво на организација.

Со сервисните сметки се управува како со обични сметки. Од Организација -> менито Членови може да отстраните сервисна сметка или да ја ажурирате улогата:

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 GB датотеки по проект.

Ако ја надминете оваа квота, ќе ја видите следнава грешка:

Го надминавте вашиот квотен лимит за складирање датотеки. Организациите се ограничени на 100 GB датотеки. Намалете ја големината на датотеката или контактирајте поддршка.

Ви препорачуваме да ги избришете неискористените датотеки зачувани на вашата сметка. За референца, може да прегледувате и наведувате датотеки со API.

Сопственик сум на проект, зошто не можам да ја видам Контролната табла за користење на мојот проект?

Видливоста на Контролната табла за користење на проектот не зависи од улогата на корисникот во проектот. Наместо тоа, таа се одредува според вашата улога во организацијата и поставките на https://platform.openai.com/settings/organization/data-controls/visibility

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

Ако не можете да ја видите Контролната табла за користење, оваа поставка веројатно е наместена на "Видливо за сопствениците на организацијата".

Дали оваа статија ви беше корисна?