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

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

Создавајте и управувајте со API-проекти: пристап за членови, сервисни сметки, API-клучеви, пристап до модели, користење и ограничувања на трошењето.

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

Преглед

Проектите ја организираат работата во рамките на API-организација. Користете ги за управување со пристапот, поставување ограничувања за моделите и ограничувања на брзината, создавање сервисни сметки и следење на користењето, наплатата и ограничувањата на трошењето за одреден збир ресурси, како што се модели, можности, нишки, асистенти, фино прилагодување и простор за складирање.

Сопствениците на организацијата можат да ги видат сите активни и архивирани проекти на страницата Проекти.

Image

Пред да започнете

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

Ако вашата организација користи обединета наплата, подорганизациите се прикажуваат одделно во менито за избор на организација. Не може да создавате проекти во подорганизација.

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

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

Сопствениците на организации што ги исполнуваат условите може да постават регионално место на чување на податоците при создавање нов API-проект. За ова поставување не е потребно одобрение за нула задржување на податоци (ZDR). Регионалниот проект користи сопствени поставки.

За пристап до регионот ОАЕ, контактирајте со тимот за продажба. За поддржаните региони и техничките барања, погледнете го водичот за место на чување на податоците за API.

Стандарден проект

Секоја организација вклучува стандарден проект што не може да се избрише. Тој ја наследува целосната конфигурација на организацијата. Можете да ги поставите неговите ограничувања на брзината, дозволи за виртуелни модели и ограничувања на трошењето.

Не можете да додавате членови или сервисни сметки директно во стандардниот проект. Можете да вклучите пристап до стандардниот проект кога поканувате некого во организацијата, следејќи ги чекорите за поканување во организација во оваа статија.

Создавање проект

  1. Отворете го менито за избор на проект и изберете Создај проект.

  2. Внесете име на проектот и пополнете ги сите други прикажани полиња.

  3. Во Место на чување на податоците и извршување на инференцијата, изберете достапен регион. За да избирате регион за обработка за секое барање, оставете ја поставката на Глобално и изберете Овозможи место на чување на податоците по барање. Прегледајте го известувањето за цените и проверете го регионот пред да го создадете проектот.

  4. Изберете Создај.

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. Постојните глобални проекти што веќе поддржуваат место на чување на податоците по барање може да продолжат да ги користат своите API-клучеви.

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

Ако опцијата за место на чување на податоците не е достапна

Потврдете дека сте во саканата API-организација и дека ја имате улогата сопственик на организацијата. Исполнувањето на условите за друга API-функција, вклучително и верификација на организацијата, само по себе не ја овозможува опцијата за место на чување на податоците.

Ако опцијата не е достапна, проверете ги пораките прикажани во дијалог-прозорецот за проектот. Ако сѐ уште ви треба помош, контактирајте со поддршката на OpenAI. Наведете го вашиот ID на организација за API, ID на проектот ако постои, избраната опција, регионот и пораката за грешка со отстранети чувствителни податоци, заедно со времето и временската зона кога се појавила. Не споделувајте API-клучеви или податоци за автентикација при плаќање.

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

За грешки во барањата или доцнење по поставувањето, погледнете Решавање проблеми со грешки и доцнење на API.

Разбирање на улогите и пристапот

Табелата ги сумира улогите сопственик и читател на организацијата и сопственик и член на проектот што се користат во овие чекори. Членовите на проектот имаат дозволи слични на оние на читателите во организацијата.

УлогаОпсегДозволи
СопственикОрганизацијаСоздавање и прегледување на сите проекти, корисници и API-клучеви. Следење на проектите на страницата Проекти. Поставување ограничувања на трошењето за организацијата и проектите. Доделување пристап до податоците за користење на другите корисници. Архивирање проекти.
ЧитателОрганизацијаМоже да биде додаден во проекти, да врши инференција, да користи ресурси и да создава клучеви во тие проекти. Не може да создава проекти или да управува со корисници.
СопственикПроектСите дозволи на член, плус додавање корисници, управување со членовите и поставките на проектот, преименување на проектот, поставување ограничувања на неговото трошење и архивирање.
ЧленПроектВршење инференција, користење ресурси, создавање клучеви на ниво на проект и испраќање API-барања што читаат или менуваат податоци.

За детали за улогите во организацијата, видете: улоги во организацијата. За дополнителни улоги, приспособени улоги и сите дозволи, видете го водичот за улоги и дозволи за API.

Видливост на проектите

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

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

Можете да членувате во онолку проекти колку што ви се потребни. Личен API-клуч создаден во проект е ограничен на тој проект и неговите ресурси.

Граници на пристап до ресурсите

Датотеките, асистентите, просторот за складирање и нишките се ограничени на својот проект. Членовите надвор од тој проект што не се администратори не можат да пристапат до неговите ресурси, а ресурсите не можат да се преместуваат меѓу проекти.

Исклучок се фино прилагодените модели во стандардниот проект: до нив може да се пристапи од други проекти.

Управување со членовите на проектот

Поканување некого во вашата организација

Лицето мора да биде член на вашата организација пред да можете да го додадете во проект.

Кога поканувате некого во организацијата, можете да му дадете и пристап до стандардниот проект со избирање на таа опција во формуларот за покана. Оставете ја опцијата неизбрана ако не сакате да дадете пристап до стандардниот проект. Новите членови на организацијата не се додаваат автоматски во стандардниот проект.

Не треба да создадете друг проект пред да поканите некого. Можете да додадете некого во проект и откако ќе ја прифати поканата за организацијата.

Поканите испратени преку администраторскиот API ги следат правилата за крајната точка /organization/invites.

Додавање член на организацијата во проект

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

  1. Одете во поставките на организацијата.

  2. Изберете го проектот, па отворете Членови.

  3. Изберете + Додај член.

  4. Изберете го корисникот и доделете му ја улогата Член или Сопственик.

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

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

Ако поканата е неуспешна во корисничкиот интерфејс или преку администраторскиот API, проверете дали целниот проект постои и не е архивиран пред повторно да ја испратите поканата.

Промена на улога или отстранување член

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

  1. Одете во поставките на организацијата.

  2. Изберете го проектот, па отворете Членови.

  3. Поставете ја улогата на корисникот на Член или Сопственик, или изберете Отстрани за да го отстраните.

Создавање и управување со сервисни сметки

Сервисната сметка обезбедува пристап за системи, наместо да претставува поединечен корисник. Сервисните сметки се ограничени на проекти.

За создавање сервисни сметки се потребни дозволи за управување со сервисни сметки. Сопствениците на организацијата и на проектите ги имаат овие дозволи.

Создавање сервисна сметка

  1. Изберете го проектот во избирачот на проекти.

  2. Одете во поставките на организацијата и изберете го проектот.

  3. Отворете Членови и изберете + Сервисна сметка.

  4. Внесете единствен идентификатор за сервисната сметка користејќи букви, бројки и цртички.

  5. Изберете Создај.

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

Истиот формат на идентификатор важи без разлика дали ја создавате сервисната сметка преку поставките на ниво на организација или на проект.

Сервисната сметка создадена за одреден проект е единствена за тој проект и не може да се користи надвор од него.

Зачувување на тајниот клуч

При создавање на сервисната сметка веднаш се создава API-клуч и се прикажува неговиот таен клуч. Зачувајте го тајниот клуч на безбедно место. Не можете повторно да го видите преку вашата сметка на OpenAI. Ако го изгубите, генерирајте нов клуч.

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

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

Ажурирање или отстранување сервисна сметка

Сервисните сметки се прикажуваат заедно со корисниците во поставките Членови на проектот. За да управувате со нивниот пристап до проектот, користете ги истите чекори за промена на улога и отстранување како и за другите членови на проектот.

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

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

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

Создавање и управување со API-клучеви

Секој проект има свои API-клучеви:

  1. Одете во поставките на организацијата.

  2. Изберете го проектот, па отворете API-клучеви.

  3. Изберете + Создај нов таен клуч за да создадете клуч или изберете ја иконата за уредување до постоечки клуч за да ги промените неговите дозволи.

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

Избирање дозволи за клучот

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

  • Сите: Целосни дозволи. Ова е стандардната поставка.

  • Ограничени: Изберете опсег на пристап за одредени ресурси или крајни точки. Достапните опции зависат од ресурсот и може да вклучуваат Нема, Читање, Запишување или дозволи за конкретни барања.

  • Само читање: Дозволи за читање за сите крајни точки.

На пример, клуч со ограничени дозволи може да го исклучи пристапот за читање и запишување до крајната точка /v1/assistants.

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

За создавање клучеви за сервисни сметки се потребни дозволи за управување со сервисни сметки. Ако не ја гледате таа опција, побарајте од сопственик на организацијата или на проектот да го создаде клучот за сервисната сметка. Дијалогот за создавање клуч не ги прикажува овие контроли за дозволи за клучевите на сервисните сметки; променете ги нивните дозволи подоцна во поставките API-клучеви на проектот.

Поставување пристап до модели и ограничувања на брзината

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

  1. Одете во поставките на организацијата.

  2. Изберете го проектот, па отворете Ограничувања.

  3. Преку Користење модели изберете кои модели може да ги користи проектот.

  4. По потреба, поставете ограничување на брзината за секој модел.

Поставување ограничувања и известувања за трошење

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

Ограничувањето на трошењето може да служи за следење на трошоците без да ги запира барањата. Вклучете ја опцијата Примени строго ограничување на трошењето ако сакате барањата до API да се одбиваат откако евидентираното трошење ќе го достигне ограничувањето. Ограничувањето не стапува во сила веднаш, па евидентираното трошење може малку да го надмине поставениот износ.

Известувањата за трошење ве известуваат кога ќе се достигне одреден праг; тие не ги запираат барањата.

Поставете ограничување на трошењето за организација

  1. Одете во поставките на организацијата.

  2. Отворете Ограничувања и најдете Трошење.

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

Поставете ограничување на трошењето за проект

  1. Одете во поставките на организацијата.

  2. Изберете го проектот, па отворете Ограничувања.

  3. Поставете ги вредностите за Ограничување на месечното трошење и Извести кога трошењето ќе достигне.

  4. Вклучете ја опцијата Примени строго ограничување на трошењето ако сакате да го запрете сообраќајот кон API откако евидентираното трошење ќе го достигне ограничувањето.

На оваа страница може да ја промените и поставката Користење модели.

Ако трошењето го надминува месечниот буџет на проектот, споредете ги податоците за користењето за истиот проект и месец. Проверете дали опцијата Примени строго ограничување на трошењето била вклучена во моментот на користењето. Ако била исклучена, буџетот служел само за следење на трошењето, а барањата до API продолжиле да се обработуваат. Ако сакате идните барања да се одбиваат откако евидентираното трошење ќе го достигне буџетот, сопственик на организацијата или на проектот може да ја вклучи опцијата Примени строго ограничување на трошењето во поставките Ограничувања на проектот.

Ако строгото ограничување веќе било вклучено, евидентираното трошење сепак може малку да го надмине буџетот додека ограничувањето стапи во сила. Ако трошењето за тој проект и месец и по овие проверки е значително над строгото ограничување, а причината останува нејасна, контактирајте со поддршката и наведете ги ID на проектот, применетото строго ограничување, евидентираното трошење, релевантните датуми и временската зона. Вклучете ги и идентификаторите на релевантните барања, ако ги имате. Не вклучувајте API-клучеви.

Управувајте со известувањата за трошење

Кога создавате ограничување на трошењето за проект, стандардно се создава и известување што се испраќа при достигнување 100% од ограничувањето. Изберете Додај известување за да додадете известувања за други прагови.

Сопствениците на организацијата и на проектот добиваат известувања за трошењето на проектот. Во поставките за известувањата може да додадете и други приматели преку е-пошта.

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

За тековните чекори за поставување и начинот на примена на ограничувањата, видете го водичот за ограничувања на трошењето.

Преглед на користењето и наплатата

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

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

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

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

Управување со просторот за складирање датотеки

Секој проект има квота од 100 GB за складирање датотеки. Ако ја надминете, може да се прикаже оваа грешка:

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

Избришете ги датотеките што не ги користите за да ослободите простор. Можете да добиете список на зачуваните датотеки преку API за да ги најдете датотеките што повеќе не ви требаат.

Архивирање проект

Сопствениците на организации и проекти може да архивираат проекти преку страницата „Проекти“ или преку поставките на конкретниот проект. Кога ќе се побара потврда, внесете го името на проектот.

Архивирањето е трајно: архивиран проект не може да се врати.

Не архивирајте проект за да му го смените регионот или да ги префрлите неговите ресурси. Архивирањето е трајно и не гарантира веднаш да се избришат сите задржани податоци.

За да ги видите архивираните проекти, отворете го јазичето Архивирани на страницата „Проекти“.

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

Единствениот исклучок е што fine-tune моделите во „Стандардниот проект“ може да се пристапат од други проекти.

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

Проектите не можат да се избришат. OpenAI ја чува нивната историја за следење на користењето и наплатата.

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