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

სერვისული ანგარიშის დასახელება

სერვისულ ანგარიშს ორგანიზაციის დონეზე ქმნით თუ კონკრეტული პროექტისთვის, შექმნისას შეგიძლიათ მიანიჭოთ ასოებისგან, ციფრებისა და დეფისებისგან შემდგარი უნიკალური ID, რათა მისი ამოცნობა მარტივად შეძლოთ.

სერვისული ანგარიშის API-გასაღების შენახვა

ღილაკის შექმნა არჩევის შემდეგ სერვისული ანგარიშისთვის დაუყოვნებლივ შეიქმნება API-გასაღები და გამოჩნდება საიდუმლო გასაღები. შეინახეთ ეს საიდუმლო გასაღები უსაფრთხო ადგილას. უსაფრთხოების მიზნით, მას თქვენს OpenAI ანგარიშში ხელახლა ვეღარ ნახავთ. თუ ამ საიდუმლო გასაღებს დაკარგავთ, ახლის გენერირება დაგჭირდებათ.

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

სერვისული ანგარიშის API-გასაღებს ნაგულისხმევად აქვს პროექტის ყველა API-რესურსის წაკითხვისა და ჩაწერის ნებართვა. ამ ნებართვების განახლება პროექტის API-გასაღებების პარამეტრებში შეგიძლიათ.

სერვისული ანგარიშები პროექტის წევრების პარამეტრების გვერდზე წევრებთან ერთად არის ჩამოთვლილი. პროექტის წევრების პარამეტრების გვერდზე სერვისული ანგარიშის წვდომის განახლების ან წაშლის შესახებ დამატებითი ინფორმაციისთვის იხილეთ აქ.

პროექტებისა და ორგანიზაციების ყველა სერვისის ანგარიში თქვენს ადამიან მომხმარებლებთან ერთად გამოჩნდება ორგანიზაციის დონის წევრების გვერდზე.

სერვისის ანგარიშები იმართება ჩვეულებრივი ანგარიშების მსგავსად. Organization -> Members მენიუდან შეგიძლიათ სერვისის ანგარიშის წაშლა ან როლის განახლება:

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 GB ფაილით. გთხოვთ, შეამციროთ ფაილის ზომა ან დაუკავშირდეთ მხარდაჭერას.

გირჩევთ, წაშალოთ თქვენს ანგარიშზე შენახული გამოუყენებელი ფაილები. ცნობისთვის, API-ის მეშვეობით შეგიძლიათ ფაილების ნახვა და ჩამოთვლა.

პროექტის მფლობელი ვარ — რატომ ვერ ვხედავ ჩემი პროექტის გამოყენების დაფას?

პროექტის გამოყენების დაფის ხილვადობა პროექტში მომხმარებლის როლზე დამოკიდებული არ არის. მას განსაზღვრავს თქვენი როლი ორგანიზაციაში და პარამეტრები მისამართზე https://platform.openai.com/settings/organization/data-controls/visibility

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

თუ გამოყენების დაფას ვერ ხედავთ, ეს პარამეტრი, სავარაუდოდ, დაყენებულია მნიშვნელობაზე "ხილულია ორგანიზაციის მფლობელებისთვის".

სასარგებლო იყო ეს სტატია?