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

Hantera projekt i API-plattformen

Lär dig skapa och hantera OpenAI API-projekt, inklusive medlemmar, roller, tjänstekonton, API-nycklar, användningsgränser och budgetar.

Uppdaterades: 14 days ago

Projekt syftar till att ge kunder möjlighet att organisera sitt arbete. Organisationer kan hantera åtkomst och gränser, tillhandahålla tjänstekonton (via användargränssnittet) och spåra användning inom en avgränsad omfattning i 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 utgiftsgränser 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 projekt. Mer information finns i roller och behörigheter.

Om du vill 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 samlad faktureringsplan identifieras underorganisationer separat. Projekt kan inte skapas i underorganisationer.

Image

Hur fungerar projekt?

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

Hur skapar jag ett projekt?

Håll först pekaren över projektnamnet i sidans vänstra hörn och välj Skapa projekt.

API platform project menu with Create project highlighted under Default project

Ange projektets namn, beskrivning och webbplats och välj sedan Skapa.

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?

Nya 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 markera kryssrutan "Bjud in till standardprojektet") eller efter att medlemmen har accepterat inbjudan till organisationen.

Användare som bjuds in via Admin API omfattas av reglerna för /organization/invites-slutpunkten.

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

Organisationsägare läggs automatiskt till som ägare av nya projekt som skapas inom organisationen.

Vilka användarroller finns i 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. Tabellen nedan innehåller en mer detaljerad beskrivning av behörigheterna som hör till varje användarroll.

RollOmfattningBeskrivning
ÄgareOrganisationKan skapa och visa alla projekt, alla användare och alla API-nycklar. Kan övervaka alla projekt i organisationen via

sidan Projekt
. Kan ange utgiftsgränser för organisationen och projekt. Kan ge andra i organisationen behörighet att se användningsinformation. Kan arkivera projekt.
LäsareOrganisationKan köra inferens, använda resurser och skapa nycklar i sina projekt. Kan läggas till i projekt.
Kan inte skapa projekt eller hantera användare.
ÄgareProjektKan lägga till andra användare i projektet och byta namn på det samt har alla behörigheter som en medlem har. Kan ange projektets utgiftsgränser. Kan arkivera projektet.
MedlemProjektKan köra inferens, använda resurser och skapa nycklar på projektnivå.

Vad har jag åtkomst till om jag inte är ägare i organisationen?

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

  • Endast projektets medlemmar (och organisationsägare) kan se finjusterade modeller som har skapats i projektet, trådar från skapade assistenter och filer som har lagts till.

  • Projektmedlemmar kan se projektets övriga medlemmar och deras roller (det vill säga Ägare eller Medlem).

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

Endast projektets ägare kan uppdatera en användares projektroll eller ta bort en användare från projektet. Mer information finns i roller och behörigheter.

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

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

Ett tjänstekonto fungerar som en pseudoanvändare avsedd för systemåtkomst och skiljer sig från individuella användarkonton. Endast organisations- och projektägare kan skapa tjänstekonton.

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

Lägg till en medlem i ett projekt

Om du klickar på knappen + Lägg till medlem visas en lista över användare i organisationen som har rollen Läsare. Om du vill lägga till en användare som inte ingår i organisationen måste du först lägga till personen i organisationen (du kan låta kryssrutan 'Lägg till i standardprojektet" vara avmarkerad om du inte vill ge användaren bredare åtkomst). Listan innehåller inte tjänstekonton. I det här steget kan du välja rollen Ägare eller Medlem:

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 projektets utgiftsgränser samt hantera projektmedlemmar. Mer information finns i roller och behörigheter.

Så skapar du ett tjänstekonto för ett projekt

Gå först till projektet som du vill skapa ett tjänstekonto för genom att välja det i listrutan i navigeringsfältet:

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

Gå sedan till organisationsinställningarna -> Projekt -> Medlemmar -> och klicka på + Tjänstekonto:

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änstekontot

Oavsett om du skapar tjänstekontot på organisationsnivå eller specifikt för ett projekt kan du skapa ett unikt ID för tjänstekontot med bokstäver, siffror och bindestreck, så att kontot enkelt kan identifieras.

Spara tjänstekontots API-nyckel

När du väljer knappen Skapa skapas omedelbart en API-nyckel för tjänstekontot och den hemliga nyckeln visas. Spara den 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 hemliga nyckeln måste du generera en ny.

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

Som standard har tjänstekontots API-nyckel behörighet att läsa och skriva till alla projektets API-resurser. Behörigheterna kan uppdateras i projektets inställningar för API-nycklar.

Tjänstekonton visas tillsammans med projektmedlemmar på projektets inställningssida för medlemmar. Läs mer här om hur du uppdaterar eller tar bort ett tjänstekontos åtkomst på projektets inställningssida för medlemmar.

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 i organisationens projekt?

Du kan skapa och hantera API-nycklar för varje projekt på projektets inställningssida. Gå till organisationsinställningarna, välj projektet och klicka på API-nycklar.

Skapa en ny hemlig nyckel genom att välja + Skapa ny hemlig nyckel. Du kan även välja redigeringsikonen bredvid en hemlig nyckel för att ändra dess behörigheter.

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

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

Det finns tre behörighetsnivåer: Alla, Begränsad och Skrivskyddad.

  • Alla — Den hemliga nyckeln får fullständig behörighet. Detta är standardinställningen.

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

  • Du kan till exempel skapa en API-nyckel som uttryckligen saknar behörighet att läsa från eller skriva till slutpunkten /v1/assistants:

Create new secret key dialog in the API platform with Restricted permissions selected
  • Skrivskyddad — Läsbehörighet 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. I ett projekt kan användare generera en personlig API-nyckel vars omfattning och åtkomst är begränsad till projektet och dess resurser.

Hur anger och hanterar jag hastighetsgränser för organisationens projekt?

Endast organisationens ägare kan ange och hantera hastighetsgränser på projektnivå. Mer information finns i roller och behörigheter.

Gå till organisationsinställningarna, klicka på projektet som du vill uppdatera och välj Gränser under Projekt i navigeringslistan. På den här sidan kan du uppdatera Modellanvändning.

Med Modellanvändning kan du konfigurera vilka modeller som får användas av projektet, och hastighetsgränser kan anges för varje modell efter behov.

Hur anger och hanterar jag utgiftsgränser för organisationens projekt?

Endast organisationens ägare och projektets ägare kan ange och hantera projektets utgiftsgränser. Mer information finns i roller och behörigheter. Om du vill ändra gränserna på organisationsnivå går du till organisationsinställningarna, 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

Om du vill ange projektgränser går du till organisationsinställningarna, klickar på projektet som du vill uppdatera och väljer Gränser. Du kan uppdatera Månatlig utgiftsgräns, Aviseringströskel och Modellanvändning.

Genom att ange en månatlig utgiftsgräns kan du skapa mjuka utgiftströsklar för projektet. Om användningen överskrider gränsen under en viss kalendermånad (UTC) fortsätter API-begäranden att behandlas utan avbrott. Funktionen hjälper dig att övervaka användningen genom aviseringar om utgiftsgränser, men tillämpar inget strikt utgiftstak. När en utgiftsgräns skapas för ett projekt skapas som standard en avisering vid tröskeln 100 %. Du kan ange fler aviseringar vid andra trösklar genom att klicka på Lägg till avisering.

Observera att organisationens 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 anger jag utgiftsgränser för min organisation eller mitt projekt?

OpenAI stöder nu månatliga utgiftsgränser för API-användning på både organisations- och projektnivå. En utgiftsgräns kan övervaka utgifterna utan att tillämpas, eller användas som en strikt gräns så att API-begäranden misslyckas när utgifterna når gränsen. De senaste konfigurationsstegen och aktuellt beteende finns under Utgiftsgränser i utvecklardokumentationen.

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 arkiverar ett projekt uppmanas du att ange projektets namn för att fortsätta.

Du kan se en lista över alla arkiverade projekt på 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 sparar historiken för alla projekt för att säkerställa kontinuitet i spårningen av användning och fakturering.

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

Som standard kan organisationer 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 medlemmar utan administratörsbehörighet utanför projektet. Resurser kan inte heller flyttas mellan projekt.

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

Hur stor är lagringskvoten för filer per projekt?

OpenAI stöder för närvarande en lagringskvot på 100 GB filer per projekt.

Om kvoten ö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 projektets kontrollpanel för användning?

Synligheten för ett projekts kontrollpanel för användning är inte kopplad till användarens roll i projektet. Den avgörs i stället 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 kontrollpanelen för användning är den här inställningen troligen satt till "Synlig för organisationsägare".

Var den här artikeln till hjälp?