Přehled
Projekty slouží k uspořádání práce v rámci organizace používající API. Umožňují spravovat přístup, nastavovat limity modelů a limity frekvence požadavků, vytvářet účty služeb a sledovat využití, fakturaci a limity útraty pro vymezenou sadu prostředků, jako jsou modely, funkce, vlákna, asistenti, dolaďování a úložiště.
Vlastníci organizace mohou zobrazit všechny aktivní i archivované projekty na stránce Projekty.
Než začnete
K vytvoření projektu potřebujete roli vlastníka organizace. Organizace mohou ve výchozím nastavení vytvořit až 2 000 projektů.
Pokud vaše organizace používá konsolidovanou fakturaci, podřízené organizace se v nabídce pro výběr organizace zobrazují samostatně. V podřízené organizaci nelze vytvářet projekty.
Chcete-li přepnout organizaci, otevřete nabídku pro výběr organizace a vyberte tu, kterou chcete používat.
Výchozí projekt
Každá organizace obsahuje výchozí projekt, který nelze smazat. Dědí veškeré nastavení organizace. Můžete nastavit jeho limity frekvence požadavků, oprávnění k virtuálním modelům a limity útraty.
Do výchozího projektu nelze přímo přidávat členy ani účty služeb. Přístup k výchozímu projektu můžete udělit při pozvání uživatele do organizace podle postupu pro pozvání do organizace uvedeného v tomto článku.
Vytvoření projektu
Otevřete nabídku pro výběr projektu a vyberte Vytvořit projekt.
Zadejte název, popis a webovou stránku svého projektu.
Vyberte Vytvořit.
Vlastníci organizace se automaticky přidávají jako vlastníci nových projektů.
Přehled rolí a přístupu
Tabulka shrnuje role vlastníka a čtenáře na úrovni organizace a vlastníka a člena na úrovni projektu, které se používají v těchto postupech. Členové projektu mají podobná oprávnění jako čtenáři organizace.
| Role | Rozsah | Oprávnění |
|---|---|---|
| Vlastník | Organizace | Vytvářet a zobrazovat všechny projekty, uživatele a klíče API. Sledovat projekty na stránce Projekty. Nastavovat limity útraty organizace a projektů. Udělovat přístup k údajům o využití ostatních uživatelů. Archivovat projekty. |
| Čtenář | Organizace | Být přidán do projektů a v nich provádět inferenci, používat prostředky a vytvářet klíče. Nemůže vytvářet projekty ani spravovat uživatele. |
| Vlastník | Projekt | Všechna oprávnění člena a navíc přidávat uživatele, spravovat členy a nastavení projektu, přejmenovat projekt, nastavovat jeho limity útraty a archivovat ho. |
| Člen | Projekt | Provádět inferenci, používat prostředky, vytvářet klíče na úrovni projektu a odesílat požadavky API, které čtou nebo upravují data. |
Podrobnosti o rolích v organizaci najdete v článku Role v organizaci. Další role, vlastní role a úplný přehled oprávnění najdete v průvodci rolemi a oprávněními API.
Viditelnost projektů
U těchto standardních rolí platí, že uživatelé, kteří nejsou vlastníky organizace, vidí pouze projekty, do kterých patří. Vlastníci organizace vidí všechny projekty, členy a klíče API na úrovni projektů a mají přístup na stránku Projekty.
Členové projektu vidí ostatní členy svého projektu i jejich role. Doladěné modely, vlákna asistentů a soubory vytvořené nebo přidané v daném projektu vidí pouze členové projektu a vlastníci organizace.
Můžete být členy tolika projektů, kolik potřebujete. Osobní klíč API vytvořený v projektu je omezen na daný projekt a jeho prostředky.
Omezení přístupu k prostředkům
Soubory, asistenti, úložiště a vlákna jsou vázány na svůj projekt. Členové mimo daný projekt, kteří nejsou správci, nemají přístup k jeho prostředkům. Prostředky nelze přesouvat mezi projekty.
Výjimkou jsou doladěné modely ve výchozím projektu: k těm lze přistupovat i z jiných projektů.
Správa členů projektu
Pozvání uživatele do organizace
Abyste mohli uživatele přidat do projektu, musí nejprve patřit do vaší organizace.
Když někoho zvete do organizace, můžete mu udělit přístup k výchozímu projektu zaškrtnutím příslušné možnosti ve formuláři pozvánky. Pokud přístup k výchozímu projektu udělit nechcete, nechte tuto možnost nezaškrtnutou. Noví členové organizace se do výchozího projektu nepřidávají automaticky.
Než někoho pozvete, nemusíte vytvářet další projekt. Uživatele můžete do projektu přidat také poté, co přijme pozvánku do organizace.
Pozvánky odeslané přes rozhraní Admin API se řídí pravidly pro koncový bod /organization/invites.
Přidání člena organizace do projektu
Vlastníci organizace a projektu mohou přidávat členy:
Přejděte do nastavení organizace.
Vyberte projekt a otevřete sekci Členové.
Vyberte + Přidat člena.
Vyberte uživatele a přiřaďte mu roli Člen nebo Vlastník.
Seznam uživatelů zobrazuje uživatele organizace s rolí Čtenář. Neobsahuje účty služeb.
Pokud se pozvánku nepodaří odeslat v uživatelském rozhraní nebo přes Admin API, před opětovným odesláním ověřte, že cílový projekt existuje a není archivovaný.
Změna role nebo odebrání člena
Vlastníci organizace a projektu mohou změnit roli uživatele v projektu nebo ho z daného projektu odebrat.
Přejděte do nastavení organizace.
Vyberte projekt a otevřete sekci Členové.
Nastavte uživateli roli Člen nebo Vlastník, případně ho odeberte výběrem možnosti Odebrat.
Vytváření a správa účtů služeb
Účet služby zajišťuje přístup pro systém, nikoli pro konkrétního uživatele. Účty služeb jsou vázány na projekty.
Vytváření účtů služeb vyžaduje oprávnění ke správě účtů služeb. Tato oprávnění mají vlastníci organizace a projektu.
Vytvoření účtu služby
Vyberte projekt v nabídce pro výběr projektu.
Přejděte do nastavení organizace a vyberte projekt.
Otevřete sekci Členové a vyberte + Účet služby.
Zadejte jedinečné ID účtu služby tvořené písmeny, číslicemi a spojovníky.
Vyberte Vytvořit.
Servisní účty vytvořené na úrovni projektu jsou jedinečné pro daný projekt a nelze je používat mimo projekt, ve kterém byly vytvořeny.
Stejný formát ID platí bez ohledu na to, zda účet služby vytváříte v nastavení na úrovni organizace, nebo projektu.
Účet služby vytvořený pro projekt je jedinečný pro daný projekt a nelze jej používat mimo něj.
Uložení tajného klíče
Při vytvoření účtu služby se okamžitě vytvoří klíč API a zobrazí se jeho tajný klíč. Tajný klíč si bezpečně uložte. Ve svém účtu OpenAI ho už znovu zobrazit nemůžete. Pokud ho ztratíte, vygenerujte nový klíč.
Ve výchozím nastavení má klíč účtu služby oprávnění ke čtení a zápisu u všech prostředků API ve svém projektu. Tato oprávnění můžete později změnit v nastavení projektu v sekci Klíče API.
Úprava nebo odebrání účtu služby
Účty služeb se zobrazují spolu s uživateli v nastavení projektu v sekci Členové. Jejich přístup k projektu spravujte stejným postupem pro změnu role a odebrání jako u ostatních členů projektu.
Všechny účty služeb se spolu s uživateli zobrazují také na stránce Členové organizace, včetně účtů vytvořených v nastavení na úrovni organizace i projektu.
V nabídce Členové organizace můžete změnit roli účtu služby nebo vybrat možnost Odebrat.
Vytváření a správa klíčů API
Každý projekt má vlastní klíče API:
Přejděte do nastavení organizace.
Vyberte projekt a otevřete sekci Klíče API.
Výběrem možnosti + Vytvořit nový tajný klíč vytvořte klíč. Pokud chcete změnit oprávnění stávajícího klíče, vyberte ikonu úprav vedle něj.
Výběr oprávnění klíče
U klíčů vlastněných uživateli můžete oprávnění nastavit při vytváření klíče nebo je upravit později:
Vše: Plná oprávnění. Toto je výchozí nastavení.
Omezená: Vyberte rozsah oprávnění pro konkrétní prostředky nebo koncové body. Dostupné možnosti závisí na prostředku a mohou zahrnovat Žádná, Čtení, Zápis nebo oprávnění pro konkrétní požadavky.
Pouze čtení: Oprávnění ke čtení pro všechny koncové body.
Klíč s omezenými oprávněními může například vyloučit přístup ke čtení a zápisu na koncovém bodu /v1/assistants.
Vytváření klíčů účtů služeb vyžaduje oprávnění ke správě účtů služeb. Pokud tuto možnost nevidíte, požádejte vlastníka organizace nebo projektu o vytvoření klíče účtu služby. Dialog pro vytvoření klíče tyto ovládací prvky oprávnění u klíčů účtů služeb nezobrazuje. Jejich oprávnění změňte dodatečně v nastavení projektu v sekci Klíče API.
Nastavení přístupu k modelům a limitů frekvence požadavků
Správa limitů frekvence požadavků projektu vyžaduje oprávnění správce. Tato oprávnění mají vlastníci organizace. Vlastníci projektů mohou limity frekvence požadavků projektu spravovat také prostřednictvím API pro správu.
Přejděte do nastavení organizace.
Vyberte projekt a otevřete sekci Limity.
V nastavení Využití modelů vyberte, které modely může projekt používat.
Podle potřeby nastavte limit frekvence požadavků pro každý model.
Nastavení limitů útraty a upozornění
Měsíční limity výdajů za API jsou k dispozici na úrovni organizace i projektu. Ke změně limitu potřebujete oprávnění ke správě nastavení příslušné organizace nebo projektu.
Limit výdajů může sloužit ke sledování výdajů, aniž by blokoval požadavky. Pokud chcete, aby požadavky API po dosažení limitu evidovaných výdajů selhávaly, zapněte možnost Vynucovat pevný limit výdajů. Vynucování limitu se neprojeví okamžitě, takže evidované výdaje mohou nastavenou částku mírně překročit.
Upozornění na výdaje vás informují o dosažení prahové hodnoty, ale neblokují požadavky.
Nastavení limitu výdajů organizace
Přejděte do nastavení organizace.
Otevřete Limity a najděte část Výdaje.
Nastavení limitu výdajů projektu
Přejděte do nastavení organizace.
Vyberte projekt a otevřete Limity.
Nastavte hodnoty v polích Limit měsíčních výdajů a Upozornit, když výdaje dosáhnou.
Pokud chcete po dosažení limitu evidovaných výdajů zastavit provoz API, zapněte možnost Vynucovat pevný limit výdajů.
Na této stránce můžete také změnit nastavení Používání modelů.
Pokud vaše výdaje převyšují měsíční rozpočet projektu, porovnejte údaje o využití za stejný projekt a měsíc. Zkontrolujte, zda byla v době využití API zapnutá možnost Vynucovat pevný limit výdajů. Pokud byla vypnutá, rozpočet sloužil pouze ke sledování výdajů a požadavky API se dál zpracovávaly. Pokud chcete, aby budoucí požadavky po dosažení rozpočtu evidovanými výdaji selhávaly, může vlastník organizace nebo projektu zapnout možnost Vynucovat pevný limit výdajů v nastavení Limity daného projektu.
Pokud už byl pevný limit zapnutý, mohou evidované výdaje přesto mírně překročit rozpočet, než se vynucování limitu projeví. Pokud výdaje za daný projekt a měsíc i po těchto kontrolách výrazně překračují vynucovaný limit a nemáte pro to vysvětlení, kontaktujte podporu. Uveďte ID projektu, vynucovaný limit, evidované výdaje, příslušná data a časové pásmo. Pokud máte k dispozici ID příslušných požadavků, přiložte je. Klíče API neuvádějte.
Správa upozornění na výdaje
Při vytvoření limitu výdajů projektu se ve výchozím nastavení vytvoří také upozornění při dosažení 100 % limitu. Výběrem možnosti Přidat upozornění přidáte upozornění pro další prahové hodnoty.
Upozornění na výdaje projektu dostávají vlastníci organizace a projektu. V nastavení upozornění můžete přidat další e-mailové adresy příjemců.
Aktuální postup nastavení a informace o vynucování limitů najdete v průvodci limity útraty.
Zobrazení využití a fakturace
Údaje o využití lze rozdělit podle projektů. U jednotlivých projektů můžete zobrazit fakturaci a nastavit limity útraty.
Přístup k přehledu využití projektu závisí na vaší roli v organizaci a na nastavení viditelnosti přehledu využití. Samotná role vlastníka projektu přístup nezaručuje.
Pokud přehled využití projektu nevidíte, zkontrolujte, zda je viditelnost nastavena na Viditelné pro vlastníky organizace.
Správa úložiště souborů
Každý projekt má kvótu úložiště souborů 100 GB. Pokud ji překročíte, může se zobrazit tato chyba:
Překročili jste kvótu úložiště souborů. Organizace mohou ukládat nejvýše 100 GB souborů. Zmenšete velikost souboru nebo kontaktujte podporu.
Smazáním nepoužívaných souborů uvolněte místo v úložišti. Pomocí API si můžete vypsat uložené soubory a zjistit, které už nepotřebujete.
Archivace projektu
Vlastníci organizace a projektu mohou archivovat projekty ze stránky Projekty nebo z nastavení konkrétního projektu. Po zobrazení výzvy zadejte název projektu pro potvrzení.
Archivace je trvalá: archivovaný projekt nelze obnovit.
Archivované projekty zobrazíte otevřením karty Archivované na stránce Projekty.
Jedinou výjimkou je, že jemně doladěné modely ve „Výchozím projektu“ jsou přístupné i z jiných projektů.
Překročili jste kvótu úložiště souborů. Organizace jsou omezeny na 100 GB souborů. Zmenšete velikost souborů nebo kontaktujte podporu.Projekty nelze smazat. OpenAI uchovává jejich historii pro sledování využití a fakturace.