OpenAI
Бұл бет машиналық аударма арқылы жасалған. Түпнұсқа ағылшын мақаласын қараңыз.

API платформасындағы жобаларды басқару

OpenAI API жобаларын жасауды және басқаруды, соның ішінде мүшелерді, рөлдерді, қызметтік тіркелгілерді, API кілттерін, пайдалану лимиттері мен бюджеттерді басқаруды үйреніңіз.

Жаңартылған: 5 days ago

Жобалар клиенттерге жұмысын ұйымдастыру мүмкіндігін беруге арналған. Ұйымдар қолжетімділік пен лимиттерді басқара алады, сервистік аккаунттарды (UI арқылы) қамтамасыз ете алады және жоба ішіндегі шектелген ауқым бойынша пайдалануды қадағалай алады (мысалы, модельдер, мүмкіндіктер, тізбектер, ассистенттер, дәл баптау, сақтау орны және т.б.). Пайдалану белсенділігін жоба бойынша бөліп көруге болады, ал пайдаланушылар есеп айырысуды қарап, әр жобаға шығын лимиттерін орната алады.

Ұйым иелері өздерінің барлық белсенді және архивтелген жобаларын Жобалар бетінде көре алады. 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 соңғы нүктесінде көрсетілген ережелерге бағынады.

Пайдаланушыларды 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

Қызметтік тіркелгіні атау

Қызметтік тіркелгіні ұйым деңгейінде немесе тек бір жоба үшін жасасаңыз да, оны оңай анықтау үшін әріптерден, сандардан және дефистерден тұратын бірегей қызметтік тіркелгі идентификаторын жасай аласыз.

Қызметтік тіркелгінің 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 кілтіне рұқсаттар орната аласыз.

Рұқсаттардың үш деңгейі бар: Барлығы, Шектеулі және Тек оқу.

  • Барлығы — Құпия кілтке толық рұқсаттар беріледі. Бұл — әдепкі параметр.

  • Шектеулі — Пайдаланушыға әр соңғы нүкте үшін «Жоқ», «Оқу» және «Жазу» рұқсаттарын орнатуға мүмкіндік береді.

  • Мысалы, /v1/assistants соңғы нүктесін оқуға немесе оған жазуға арнайы рұқсаты жоқ API кілтін жасайсыз:

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

«Пайдалану» бақылау тақтасын көре алмасаңыз, бұл параметр «Ұйым иелеріне көрінеді» күйіне орнатылған болуы мүмкін.

Бұл мақала пайдалы болды ма?