Общ преглед
Проектите организират работата в рамките на API организация. Използвайте ги, за да управлявате достъпа, да конфигурирате лимити за моделите и лимити на заявките, да създавате служебни акаунти и да проследявате използването, фактурирането и лимитите на разходите за определен набор от ресурси, като модели, възможности, нишки, асистенти, фина настройка и хранилище.
Собствениците на организацията могат да преглеждат всички активни и архивирани проекти на страницата „Проекти“.
Преди да започнете
За да създадете проект, трябва да имате роля на собственик на организацията. По подразбиране организациите могат да създават до 2000 проекта.
Ако организацията ви използва консолидирано фактуриране, подорганизациите се показват отделно в менюто за избор на организация. Не можете да създавате проекти в подорганизация.
За да смените организацията, отворете менюто за избор на организация и изберете тази, която искате да използвате.
Проект по подразбиране
Всяка организация включва проект по подразбиране, който не може да бъде изтрит. Той наследява цялата конфигурация на организацията. Можете да конфигурирате лимитите му на заявките, разрешенията за виртуални модели и лимитите на разходите.
Не можете да добавяте членове или служебни акаунти директно към проекта по подразбиране. Можете да включите достъп до проекта по подразбиране, когато каните някого в организацията, като следвате стъпките за покана в организацията, описани в тази статия.
Създаване на проект
Отворете менюто за избор на проект и изберете Създаване на проект.
Въведете име, описание и уебсайт за проекта си.
Изберете Създаване.
Собствениците на организацията автоматично се добавят като собственици на новите проекти.
Запознаване с ролите и достъпа
Таблицата обобщава ролите „Собственик“ и „Читател“ на ниво организация и ролите „Собственик“ и „Член“ на ниво проект, използвани в тези стъпки. Членовете на проект имат разрешения, подобни на тези на читателите в организацията.
| Роля | Обхват | Разрешения |
|---|---|---|
| Собственик | Организация | Създаване и преглед на всички проекти, потребители и API ключове. Наблюдение на проектите на страницата „Проекти“. Задаване на лимити на разходите за организацията и проектите. Предоставяне на достъп до информацията за използването от други потребители. Архивиране на проекти. |
| Читател | Организация | Може да бъде добавян към проекти, да изпълнява инференция, да използва ресурси и да създава ключове в тези проекти. Не може да създава проекти или да управлява потребители. |
| Собственик | Проект | Всички разрешения на член, както и добавяне на потребители, управление на членовете и настройките на проекта, преименуване на проекта, задаване на лимитите му на разходите и архивирането му. |
| Член | Проект | Изпълнение на инференция, използване на ресурси, създаване на ключове на ниво проект и изпращане на API заявки за четене или промяна на данни. |
За подробности относно ролите в организацията вижте ролите в организацията. За допълнителни роли, персонализирани роли и пълния набор от разрешения вижте ръководството за роли и разрешения в API.
Видимост на проектите
При тези стандартни роли потребителите, които не са собственици на организацията, могат да виждат само проектите, в които членуват. Собствениците на организацията могат да виждат всички проекти, членове и API ключове на ниво проект и имат достъп до страницата „Проекти“.
Членовете на проекта могат да виждат другите членове на своя проект и ролята на всеки от тях. Само членовете на проекта и собствениците на организацията могат да виждат фино настроените модели, нишките на асистенти и файловете, създадени или добавени в този проект.
Можете да членувате в толкова проекти, колкото ви е необходимо. Личен API ключ, създаден в даден проект, е ограничен до този проект и неговите ресурси.
Ограничения на достъпа до ресурси
Файловете, асистентите, хранилището и нишките са ограничени до съответния проект. Членове извън този проект, които не са администратори, нямат достъп до ресурсите му, а ресурсите не могат да се преместват между проекти.
Изключение са фино настроените модели в проекта по подразбиране: до тях може да се осъществява достъп от други проекти.
Управление на членовете на проект
Покана към някого да се присъедини към организацията ви
За да добавите някого към проект, той трябва вече да е член на организацията ви.
Когато каните някого в организацията, можете да включите достъп до проекта по подразбиране, като изберете съответната опция във формуляра за покана. Оставете я неизбрана, ако не искате да предоставите достъп до проекта по подразбиране. Новите членове на организацията не се добавят автоматично към проекта по подразбиране.
Не е нужно да създавате друг проект, преди да поканите някого. Можете също да добавите някого към проект, след като приеме поканата за организацията.
Поканите, изпратени чрез административния API, следват правилата за крайната точка /organization/invites.
Добавяне на член на организацията към проект
Собствениците на организации и проекти могат да добавят членове:
Отидете в настройките на организацията.
Изберете проекта, след което отворете Членове.
Изберете + Добавяне на член.
Изберете потребителя и му задайте ролята Член или Собственик.
Списъкът с потребители показва потребителите в организацията с роля „Читател“. Той не включва служебни акаунти.
Ако изпращането на покана през потребителския интерфейс или административния API е неуспешно, проверете дали целевият проект съществува и не е архивиран, преди да изпратите поканата отново.
Промяна на роля или премахване на член
Собствениците на организацията и проекта могат да променят ролята на потребител в проекта или да го премахнат от него.
Отидете в настройките на организацията.
Изберете проекта, след което отворете Членове.
Задайте на потребителя роля Член или Собственик, или изберете Премахване, за да го премахнете.
Създаване и управление на служебни акаунти
Служебният акаунт осигурява достъп за системи, вместо да представлява отделен потребител. Служебните акаунти са ограничени до съответните проекти.
Създаването на служебни акаунти изисква разрешения за управление на служебни акаунти. Собствениците на организации и проекти имат тези разрешения.
Създаване на служебен акаунт
Изберете проекта от менюто за избор на проект.
Отидете в настройките на организацията и изберете проекта.
Отворете Членове и изберете + Служебен акаунт.
Въведете уникален идентификатор за служебния акаунт, като използвате букви, цифри и тирета.
Изберете Създаване.
Service account-ите, създадени на ниво проект, са уникални за проекта и не могат да се използват извън проекта, в който са създадени.
Прилага се един и същ формат на идентификатора, независимо дали създавате служебния акаунт от настройките на ниво организация, или на ниво проект.
Служебен акаунт, създаден за даден проект, е специфичен за този проект и не може да се използва извън него.
Запазване на тайния ключ
При създаване на служебния акаунт незабавно се създава API ключ и се показва неговият таен ключ. Запазете тайния ключ на сигурно място. Няма да можете да го видите отново през акаунта си в OpenAI. Ако го загубите, генерирайте нов ключ.
По подразбиране ключът на служебния акаунт има достъп за четене и запис до всички API ресурси в своя проект. Можете да промените тези разрешения по-късно в настройките API ключове на проекта.
Актуализиране или премахване на служебен акаунт
Служебните акаунти се показват заедно с потребителите в настройките Членове на проекта. Управлявайте достъпа им до проекта със същите стъпки за промяна на роля и премахване, които използвате за другите членове на проекта.
Всички служебни акаунти се показват и заедно с потребителите на страницата „Членове“ на организацията, включително акаунтите, създадени от настройките на ниво организация и на ниво проект.
От менюто „Членове“ на организацията можете да промените ролята на служебен акаунт или да изберете Премахване.
Създаване и управление на API ключове
Всеки проект има собствени API ключове:
Отидете в настройките на организацията.
Изберете проекта, след което отворете API ключове.
Изберете + Създаване на нов таен ключ, за да създадете ключ, или изберете иконата за редактиране до съществуващ ключ, за да промените разрешенията му.
Избор на разрешения за ключ
За ключове, притежавани от потребители, можете да зададете разрешения при създаването на ключа или да ги редактирате по-късно:
Всички: Пълни разрешения. Това е настройката по подразбиране.
Ограничени: Изберете обхват на достъп за конкретни ресурси или крайни точки. Наличните опции зависят от ресурса и може да включват Без достъп, Четене, Запис или разрешения за конкретни заявки.
Само за четене: Разрешения за четене за всички крайни точки.
Например ключ с ограничени разрешения може да изключва достъпа за четене и запис до крайната точка /v1/assistants.
Създаването на ключове за служебни акаунти изисква разрешения за управление на служебни акаунти. Ако не виждате тази опция, помолете собственик на организацията или проекта да създаде ключа за служебния акаунт. Диалоговият прозорец за създаване на ключ не показва тези контроли за разрешенията при ключове за служебни акаунти; променете разрешенията им след това в настройките API ключове на проекта.
Конфигуриране на достъпа до модели и лимитите на заявките
Управлението на лимитите на заявките за проект изисква администраторски разрешения. Собствениците на организацията имат тези разрешения, а собствениците на проекти също могат да управляват лимитите на заявките за проектите чрез API за управление.
Отидете в настройките на организацията.
Изберете проекта, след което отворете Лимити.
Използвайте Използване на модели, за да изберете кои модели може да използва проектът.
Задайте лимит на заявките за всеки модел според нуждите.
Задаване на лимити на разходите и известия
Месечни лимити на разходите за API са налични както на ниво организация, така и на ниво проект. За да промените лимит, трябва да имате разрешение за управление на съответните настройки на организацията или проекта.
Лимитът на разходите може да служи за проследяване на разходите, без да спира заявките. Включете Налагане на твърд лимит, ако искате API заявките да се отхвърлят, след като отчетените разходи достигнат лимита. Ограничението не се прилага мигновено, затова отчетените разходи може леко да надвишат зададената сума.
Известията за разходите ви уведомяват при достигане на даден праг; те не спират заявките.
Задаване на лимит на разходите за организация
Отидете в настройките на организацията.
Отворете Лимити и намерете Разходи.
Задаване на лимит на разходите за проект
Отидете в настройките на организацията.
Изберете проекта, след което отворете Лимити.
Задайте стойностите за Лимит на месечните разходи и Известяване, когато разходите достигнат.
Включете Налагане на твърд лимит, ако искате да спрете API трафика, след като отчетените разходи достигнат лимита.
На тази страница можете също да промените Използване на модели.
Управление на известията за разходите
При създаване на лимит на разходите за проект по подразбиране се създава и известие при достигане на 100% от лимита. Изберете Добавяне на известие, за да добавите известия за други прагове.
Собствениците на организацията и проекта получават известия за разходите по проекта. Можете да добавите други получатели по имейл в настройките за известията.
За актуалните стъпки за конфигуриране и начина на прилагане вижте ръководството за лимитите на разходите.
Преглед на използването и фактурирането
Данните за използването могат да се разбиват по проекти, а за всеки проект можете да преглеждате данните за фактурирането и да задавате лимити на разходите.
Достъпът до таблото за използването на даден проект зависи от ролята ви в организацията и от настройките за видимост на таблото за използването. Ролята на собственик на проект сама по себе си не предоставя достъп.
Ако не виждате таблото за използването на даден проект, проверете дали видимостта е зададена на Видимо за собствениците на организацията.
Управление на хранилището за файлове
Всеки проект има квота от 100 GB за съхранение на файлове. Ако я надвишите, може да видите следната грешка:
Надвишили сте квотата си за съхранение на файлове. Организациите са ограничени до 100 GB файлове. Намалете размера на файла или се свържете с поддръжката.
Изтрийте неизползваните файлове, за да освободите място. Можете да получите списък със съхранените файлове чрез API, за да определите кои вече не ви трябват.
Архивиране на проект
Собствениците на организации и проекти могат да архивират проекти от страницата „Проекти“ или от настройките на отделния проект. Когато бъдете подканени да потвърдите, въведете името на проекта.
Архивирането е необратимо: архивиран проект не може да бъде възстановен.
За да видите архивираните проекти, отворете раздела Архивирани на страницата „Проекти“.
Единственото изключение е, че fine-tune моделите в „Проект по подразбиране“ могат да бъдат достъпвани от други проекти.
Надвишили сте квотата си за файлово хранилище. Организациите са ограничени до 100 GB файлове. Моля, намалете размера на файловете или се свържете с поддръжката.Проектите не могат да се изтриват. OpenAI запазва историята им за проследяване на използването и фактурирането.