OpenAI
Den här sidan har maskinöversatts. Visa den ursprungliga engelska artikeln.

Hantera projekt i API-plattformen

Uppdaterades: 21 days ago

Projekt syftar till att ge kunder möjlighet att organisera sitt arbete. Organisationer kan hantera åtkomst och gränser, tillhandahålla tjänstkonton (via användargränssnittet) och spåra användning mot en begränsad omfattning inom ett projekt (t.ex. modeller, funktioner, trådar, assistenter, finjustering, lagring osv.). Användningsaktivitet kan delas upp per projekt, och användare kan visa fakturering och ange budgetar per projekt.

Organisationsägare kan visa alla sina aktiva och arkiverade projekt på projektsidan. Läs mer om användarroller och behörigheter i API-plattformen.

Image

Vem kan skapa ett projekt?

Endast organisationsägare kan skapa ett projekt. Se roller och behörigheter för mer information.

För att växla mellan organisationer håller du pekaren över organisationens namn längst upp till vänster på sidan och väljer organisationen i listan:

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

För organisationer med en konsoliderad faktureringsplan identifieras underorganisationer separat. Projekt kan inte skapas i underorganisationer.

Image

Hur fungerar projekt?

Varje organisation innehåller ett ”Standardprojekt” som inte kan tas bort. Du kan konfigurera hastighetsgränser, behörigheter för virtuella modeller och utgiftsbudgetar (från och med november 2024). Det ärver organisationens fullständiga konfiguration, så du kan inte direkt lägga till medlemmar eller tjänstkonton i det.

Hur skapar jag ett projekt?

Håll först muspekaren över projektnamnet i vänstra hörnet av sidan och välj Create project.

API platform project menu with Create project highlighted under Default project

Ange namn, beskrivning och webbplats för projektet och välj sedan Create.

Create a new project dialog in the API platform with fields for project name, use case, and business website

Hur lägger jag till användare i ett projekt?

Nyligen tillagda organisationsmedlemmar läggs inte automatiskt till i ”standardprojektet”. Nya medlemmar kan bjudas in till projektet antingen när de bjuds in till organisationen (genom att aktivera kryssrutan ”Bjud in till standardprojekt”) eller efter att medlemmen har accepterat organisationsinbjudan.

Användare som bjuds in via Admin API följer reglerna som beskrivs av slutpunkten /organization/invites.

Om du får ett fel när du bjuder in användare till ett projekt via användargränssnittet eller Admin API ska du först bekräfta att målprojektet finns och inte är arkiverat innan du skickar inbjudan igen.

Organisationsägare läggs automatiskt till som ägare i nya projekt som skapas inom en organisation.

Vilka är de olika användarrollerna inom organisationer och projekt, och vilka behörigheter medför de?

Medan organisationer har rollerna ”ägare” och ”läsare” har projekt rollerna ”ägare” och ”medlem”. Projektmedlemmar motsvarar organisationsläsare. Se tabellen nedan för en mer detaljerad beskrivning av vilka behörigheter som följer med varje användarroll.

RollOmfattningBeskrivning
ÄgareOrganisationKan skapa/visa alla projekt, alla användare och alla API-nycklar. Har möjlighet att övervaka alla projekt inom organisationen via

projektsidan
. Kan ange organisationsbudgetar och projektbudgetar. Kan ge behörighet att visa användningsinformation för andra i organisationen. Kan arkivera projekt.
LäsareOrganisationKan utföra inferens, använda resurser och skapa nycklar i sina projekt. Kan läggas till i projekt.
Kan inte skapa projekt och hantera användare.
ÄgareProjektKan lägga till andra användare i projektet och byta namn på projektet, samt har alla behörigheter som en medlem har. Kan ange projektbudgetar. Kan arkivera projektet.
MedlemProjektKan utföra inferens, använda resurser och skapa nycklar på projektnivå.

Om jag inte är ägare i organisationen, vad har jag åtkomst till?

Användare som inte är ägare i organisationen kan bara se projekt som de är medlemmar i. Endast organisationsägaren kan se alla projekt, medlemmar och API-nycklar på projektnivå och har åtkomst till projektsidan.

  • Endast medlemmarna i ett projekt (och organisationsägare) kan se de finjusterade modeller som har skapats inom det projektet, trådarna från eventuella skapade assistenter eller filer som har lagts till.

  • Medlemmar i ett projekt kan se vilka alla andra medlemmar i projektet är och deras roller (dvs. ägare eller medlem).

Hur uppdaterar jag en användares projektroll eller tar bort en användare från ett projekt?

Endast ägaren av ett projekt kan uppdatera en användares projektroll eller ta bort en användare från ett projekt. Se roller och behörigheter för mer information.

För att uppdatera en användare i ett projekt går du till dina organisationsinställningar, väljer projektet och klickar på Medlemmar. Du kan välja att ange varje medlems roll som Medlem eller Ägare. Du kan också välja Ta bort för att ta bort användaren från projektet.

Vad är ett tjänstkonto och hur skiljer det sig från ett vanligt användarkonto?

Ett tjänstkonto fungerar som en pseudoanvändare avsedd för systemåtkomst, skild från individuella användarkonton. Endast organisations- och projektägare kan skapa tjänstkonton.

Tjänstkonton är endast begränsade till projekt.

Lägg till en medlem i ett projekt

Om du klickar på knappen + Add member visas en lista över användare i din organisation med rollen Reader. Om du vill lägga till en användare som för närvarande inte finns i din organisation måste du först lägga till personen i organisationen (du kan låta kryssrutan ”Lägg till i standardprojekt” vara avmarkerad om du inte vill ge dessa användare bredare åtkomst). Den här listan omfattar inte tjänstkonton. Under det här steget kan du välja om deras roll ska vara antingen Owner eller Member:

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

När du lägger till en teammedlem måste du tilldela personen rollen Medlem eller Ägare. Projektmedlemmar kan göra API-begäranden som läser eller ändrar data, medan projektägare även kan ändra projektinställningar och projektbudgetar samt hantera projektmedlemmar. Se roller och behörigheter för mer information.

Så här skapar du ett tjänstkonto för ett projekt

Navigera först till projektet som du vill skapa ett tjänstkonto för genom att välja i rullgardinsmenyn i navigeringsfältet:

API platform project switcher open with options to create a project or manage projects

Gå sedan till dina organisationsinställningar -> Projekt -> Medlemmar -> klicka på + Service account:

Tjänstkonton som skapas på projektnivå är unika för projektet och kan inte användas utanför det projekt där de skapas.

Project Members page with Create a service account dialog after selecting the Service account option

Namnge tjänstkontot

Oavsett om du skapar tjänstkontot på organisationsnivå eller skapar ett unikt för ett projekt kan du när du skapar ett tjänstkonto skapa ett unikt tjänstkonto-ID bestående av bokstäver, siffror och bindestreck för att enkelt identifiera tjänstkontot.

Spara tjänstkontots API-nyckel

När du har valt knappen Skapa skapas en API-nyckel omedelbart för tjänstkontot och den hemliga nyckeln visas. Spara den här hemliga nyckeln på en säker plats. Av säkerhetsskäl kan du inte visa den igen via ditt OpenAI-konto. Om du förlorar den här hemliga nyckeln måste du generera en ny.

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

Behörigheterna för tjänstkontots API-nyckel är som standard inställda på att läsa och skriva alla projektets API-resurser. Dessa behörigheter kan uppdateras i ditt projekts inställningar för API-nycklar.

Tjänstkonton listas tillsammans med projektmedlemmar på sidan för ditt projekts medlemsinställningar. Se här för att läsa mer om att uppdatera eller ta bort ett tjänstkontos åtkomst på sidan för ditt projekts medlemsinställningar.

Alla tjänstkonton i både projekt och organisationer visas tillsammans med dina mänskliga användare på medlemssidan på organisationsnivå.

Tjänstkonton hanteras som vanliga konton. Från Organisation -> medlemsmenyn kan du ta bort ett tjänstkonto eller uppdatera rollen:

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

Hur hanterar jag API-nycklar inom min organisations projekt?

Du kan skapa och hantera API-nycklar för varje projekt på projektets inställningssida. I dina organisationsinställningar väljer du projektet och klickar på API-nycklar.

För att skapa en ny hemlig nyckel väljer du + Create new secret key. Du kan också välja redigeringsikonen bredvid en hemlig nyckel för att redigera dess behörigheter.

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

Du kan ange behörigheter för var och en av dina API-nycklar när du skapar en ny hemlig nyckel eller genom att redigera en befintlig nyckel.

Tre behörighetsnivåer är tillgängliga: Alla, Begränsad och Endast läsning.

  • Alla — Fullständiga behörigheter anges för den hemliga nyckeln. Det här är standardinställningen.

  • Begränsad — Gör att användaren kan ange behörigheterna Ingen, Läsa och Skriva för varje slutpunkt.

    • Du skapar till exempel en API-nyckel som specifikt inte har behörighet att läsa eller skriva till slutpunkten /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Endast läsning — Läsbehörigheter anges för alla slutpunkter.

Hur hanteras åtkomst för användare som tillhör flera projekt eller organisationer?

Användare kan vara medlemmar i så många projekt som behövs. Inom ett projekt kan användare skapa en personlig API-nyckel som är begränsad till åtkomst till det projektet och dess resurser.

Hur ställer jag in och hanterar frekvensgränser för min organisations projekt?

Endast ägaren av en organisation kan ställa in och hantera frekvensgränser på projektnivå. Se roller och behörigheter för mer information.

I dina organisationsinställningar klickar du på projektet du vill uppdatera och väljer Gränser i avsnittet Projekt i navigeringslistan. Du kan uppdatera din modellanvändning på den här sidan.

Modellanvändning låter dig konfigurera vilka modeller som kan användas av projektet, och frekvensgränser kan anges för varje modell efter behov.

Hur ställer jag in och hanterar budgetar för min organisations projekt?

Endast ägare av en organisation och ägare av ett projekt kan ställa in och hantera projektbudgetar. Se roller och behörigheter för mer information. För att ändra gränserna på organisationsnivå går du till dina organisationsinställningar, klickar på Gränser, och rullar ned till Användningsgränser.

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

För att ställa in dina projektgränser går du till dina organisationsinställningar, klickar på projektet du vill uppdatera och väljer Gränser. Du kan uppdatera din månadsbudget, aviseringströskel och modellanvändning.

Genom att ställa in en månadsbudget kan du fastställa mjuka utgiftströsklar för ditt projekt. När användningen överskrider den här gränsen under en viss kalendermånad (UTC) fortsätter API-begäranden att behandlas utan avbrott. Den här funktionen är utformad för att hjälpa dig övervaka användning via budgetaviseringar, men den tillämpar inget hårt tak för utgifter. När en projektbudget skapas skapas som standard en avisering vid tröskeln 100 %. Ytterligare budgetar med olika trösklar kan ställas in genom att klicka på Lägg till avisering.

Observera att organisationens ägare och projektets ägare alltid får dessa meddelanden och att detta inte kan anpassas.

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

Hur tar jag bort eller arkiverar ett projekt?

Projekt kan arkiveras antingen via den nya sidan med projektlistan eller i inställningarna för ett enskilt projekt. När ett projekt har arkiverats kan det inte återställas. När du fortsätter med en arkivering blir du ombedd att ange projektets namn för att gå vidare.

Du kan visa en lista över alla arkiverade projekt via fliken ”Arkiverade” på samma sida med projektlistan.

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

Det går inte att ta bort projekt; vi behåller en historik över alla projekt för att säkerställa kontinuitet i spårning av användning och fakturering.

Finns det en gräns för hur många projekt jag kan ha i min organisation?

Organisationer kan som standard skapa upp till 2 000 projekt.

Kan resurser delas mellan projekt?

Projektresurser (som filer, assistenter, lagring eller trådar) är begränsade till projektet och kan inte nås av icke-adminmedlemmar utanför projektet. Dessutom kan resurser inte flyttas mellan projekt.

Det enda undantaget är att finjusteringar i ”Standardprojektet” kan nås från andra projekt.

Vad är fillagringskvoten per projekt?

OpenAI har för närvarande stöd för en fillagringskvot på 100 GB filer per projekt.

Om denna kvot överskrids visas följande fel:

Du har överskridit din kvot för fillagring. Organisationer är begränsade till 100 GB filer. Minska filstorleken eller kontakta supporten.

Vi rekommenderar att du tar bort oanvända filer som är lagrade på ditt konto. Som referens kan du visa och lista filer med API:et.

Jag är projektägare, varför kan jag inte se användningspanelen för mitt projekt?

Synligheten för ett projekts användningspanel är inte relaterad till en användares roll i ett projekt. I stället avgörs den av din roll i organisationen och inställningarna på https://platform.openai.com/settings/organization/data-controls/visibility

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

Om du inte kan se en användningspanel är den här inställningen troligen satt till ”Synlig för organisationsägare”.

Var den här artikeln till hjälp?