Projecten beheren in het API-platform

Overzicht

Met projecten organiseer je het werk binnen een API-organisatie. Gebruik ze om toegang te beheren, model- en volumelimieten in te stellen, serviceaccounts aan te maken en gebruik, facturering en bestedingslimieten bij te houden voor een afgebakende verzameling resources, zoals modellen, functionaliteiten, threads, assistenten, finetuning en opslag.

Organisatie-eigenaren kunnen alle actieve en gearchiveerde projecten bekijken op de pagina Projecten.

Voordat je begint

Je hebt de rol Organisatie-eigenaar nodig om een project aan te maken. Organisaties kunnen standaard maximaal 2.000 projecten aanmaken.

Als je organisatie geconsolideerde facturering gebruikt, verschijnen suborganisaties afzonderlijk in het organisatiemenu. Je kunt geen projecten aanmaken binnen een suborganisatie.

Om van organisatie te wisselen, open je het organisatiemenu en selecteer je de organisatie die je wilt gebruiken.

Standaardproject

Elke organisatie heeft een standaardproject dat niet kan worden verwijderd. Het neemt de volledige configuratie van de organisatie over. Je kunt de volumelimieten, rechten voor virtuele modellen en bestedingslimieten ervan instellen.

Je kunt leden of serviceaccounts niet rechtstreeks aan het standaardproject toevoegen. Je kunt toegang tot het standaardproject verlenen wanneer je iemand uitnodigt voor de organisatie. Volg hiervoor de stappen voor organisatie-uitnodigingen in dit artikel.

Een project aanmaken

1. Open het projectmenu en selecteer Project aanmaken.

2. Voer een naam, beschrijving en website voor je project in.

3. Selecteer Aanmaken.

Organisatie-eigenaren worden automatisch als eigenaar aan nieuwe projecten toegevoegd.

Inzicht in rollen en toegang

De tabel geeft een overzicht van de rollen Eigenaar en Lezer op organisatieniveau en Eigenaar en Lid op projectniveau die in deze stappen worden gebruikt. Projectleden hebben vergelijkbare rechten als lezers op organisatieniveau.

Zie organisatierollen voor meer informatie over rollen binnen een organisatie. Zie de gids voor API-rollen en -rechten voor aanvullende rollen, aangepaste rollen en een volledig overzicht van rechten.

Zichtbaarheid van projecten

Met deze standaardrollen kunnen gebruikers die geen organisatie-eigenaar zijn alleen de projecten zien waarvan ze lid zijn. Organisatie-eigenaren kunnen alle projecten, leden en API-sleutels op projectniveau zien en hebben toegang tot de pagina Projecten.

Projectleden kunnen de andere leden van hun project en de rol van elk lid zien. Alleen projectleden en organisatie-eigenaren kunnen de gefinetunede modellen, assistentthreads en bestanden zien die binnen dat project zijn aangemaakt of toegevoegd.

Je kunt lid zijn van zoveel projecten als je nodig hebt. Een persoonlijke API-sleutel die binnen een project is aangemaakt, is beperkt tot dat project en de resources ervan.

Afbakening van resources

Bestanden, assistenten, opslag en threads zijn beperkt tot hun eigen project. Leden buiten dat project die geen beheerder zijn, hebben geen toegang tot de resources ervan. Resources kunnen niet tussen projecten worden verplaatst.

Gefinetunede modellen in het standaardproject zijn een uitzondering: deze zijn toegankelijk vanuit andere projecten.

Projectleden beheren

Iemand uitnodigen voor je organisatie

Wanneer je iemand uitnodigt voor de organisatie, kun je toegang tot het standaardproject verlenen door die optie in het uitnodigingsformulier te selecteren. Laat de optie uitgeschakeld als je geen toegang tot het standaardproject wilt verlenen. Nieuwe organisatieleden worden niet automatisch aan het standaardproject toegevoegd.

Je hoeft geen ander project aan te maken voordat je iemand uitnodigt. Je kunt iemand ook aan een project toevoegen nadat diegene de uitnodiging voor de organisatie heeft geaccepteerd.

Uitnodigingen die via de Admin API worden verzonden, volgen de regels voor het endpoint /organization/invites.

Een organisatielid aan een project toevoegen

Organisatie- en projecteigenaren kunnen leden toevoegen:

1. Ga naar de organisatie-instellingen.

2. Selecteer het project en open Leden.

3. Selecteer + Lid toevoegen.

4. Selecteer de gebruiker en wijs de rol Lid of Eigenaar toe.

De gebruikerslijst toont gebruikers van de organisatie met de rol Lezer. Serviceaccounts staan niet in deze lijst.

Als een uitnodiging via de gebruikersinterface of de Admin API mislukt, controleer dan of het doelproject bestaat en niet is gearchiveerd voordat je de uitnodiging opnieuw verzendt.

Een rol wijzigen of een lid verwijderen

Organisatie- en projecteigenaren kunnen de projectrol van een gebruiker wijzigen of een gebruiker uit dat project verwijderen.

1. Ga naar de organisatie-instellingen.

2. Selecteer het project en open Leden.

3. Stel de rol van de gebruiker in op Lid of Eigenaar, of selecteer Verwijderen om de gebruiker te verwijderen.

Serviceaccounts aanmaken en beheren

Een serviceaccount biedt toegang voor systemen in plaats van een individuele gebruiker te vertegenwoordigen. Serviceaccounts zijn beperkt tot projecten.

Om serviceaccounts aan te maken, heb je rechten nodig om serviceaccounts te beheren. Organisatie- en projecteigenaren hebben deze rechten.

Een serviceaccount aanmaken

1. Kies het project in het projectmenu.

2. Ga naar de organisatie-instellingen en selecteer het project.

3. Open Leden en selecteer + Serviceaccount.

4. Voer een unieke serviceaccount-ID in met letters, cijfers en koppeltekens.

5. Selecteer Aanmaken.

Voor de ID geldt hetzelfde formaat, ongeacht of je het serviceaccount aanmaakt via instellingen op organisatie- of projectniveau.

Een serviceaccount dat voor een project is aangemaakt, is uniek voor dat project en kan niet daarbuiten worden gebruikt.

De geheime sleutel opslaan

Bij het aanmaken van het serviceaccount wordt direct een API-sleutel aangemaakt en de bijbehorende geheime sleutel weergegeven. Bewaar de geheime sleutel op een veilige plek. Je kunt deze niet opnieuw bekijken via je OpenAI-account. Als je de sleutel kwijtraakt, genereer dan een nieuwe.

Standaard heeft de serviceaccountsleutel lees- en schrijfrechten voor alle API-resources in het bijbehorende project. Je kunt die rechten achteraf wijzigen in de instellingen onder API-sleutels van het project.

Serviceaccounts staan naast gebruikers in de instellingen onder Leden van het project. Beheer hun projecttoegang met dezelfde stappen voor het wijzigen van rollen en het verwijderen van leden als voor andere projectleden.

Alle serviceaccounts staan ook naast gebruikers op de pagina Leden van de organisatie, inclusief accounts die via instellingen op organisatie- en projectniveau zijn aangemaakt.

Via het menu Leden van de organisatie kun je de rol van een serviceaccount wijzigen of Verwijderen selecteren.

API-sleutels aanmaken en beheren

Elk project heeft zijn eigen API-sleutels:

1. Ga naar de organisatie-instellingen.

2. Selecteer het project en open API-sleutels.

3. Selecteer + Nieuwe geheime sleutel aanmaken om een sleutel aan te maken, of selecteer het bewerkingspictogram naast een bestaande sleutel om de rechten ervan te wijzigen.

Rechten voor sleutels kiezen

Voor sleutels die eigendom zijn van gebruikers kun je de rechten instellen bij het aanmaken of later wijzigen:

• Alles: volledige rechten. Dit is de standaardinstelling.

• Beperkt: kies toegangsbereiken voor specifieke resources of endpoints. De beschikbare opties zijn afhankelijk van de resource en kunnen Geen, Lezen, Schrijven of verzoekspecifieke rechten omvatten.

• Alleen-lezen: leesrechten voor alle endpoints.

Een beperkte sleutel kan bijvoorbeeld lees- en schrijftoegang tot het endpoint /v1/assistants uitsluiten.

Om serviceaccountsleutels aan te maken, heb je rechten nodig om serviceaccounts te beheren. Als je die optie niet ziet, vraag dan een organisatie- of projecteigenaar om de serviceaccountsleutel aan te maken. Het dialoogvenster voor het aanmaken van sleutels toont deze rechteninstellingen niet voor serviceaccountsleutels. Wijzig de rechten achteraf in de instellingen onder API-sleutels van het project.

Modeltoegang en volumelimieten instellen

Om volumelimieten voor projecten te beheren, heb je beheerdersrechten nodig. Organisatie-eigenaren hebben deze rechten. Projecteigenaren kunnen volumelimieten voor projecten ook via de beheer-API beheren.

1. Ga naar de organisatie-instellingen.

2. Selecteer het project en open Limieten.

3. Gebruik Modelgebruik om te kiezen welke modellen het project mag gebruiken.

4. Stel indien nodig voor elk model een volumelimiet in.

Bestedingslimieten en meldingen instellen

Maandelijkse bestedingslimieten voor de API zijn beschikbaar op zowel organisatie- als projectniveau. Om een limiet te wijzigen, heb je rechten nodig om de betreffende organisatie- of projectinstellingen te beheren.

Met een bestedingslimiet kun je uitgaven volgen zonder verzoeken te stoppen. Schakel Een harde limiet afdwingen in als je wilt dat API-verzoeken mislukken zodra de geregistreerde uitgaven de limiet bereiken. De limiet wordt niet onmiddellijk afgedwongen, dus de geregistreerde uitgaven kunnen iets boven het ingestelde bedrag uitkomen.

Bestedingsmeldingen waarschuwen je wanneer een drempel is bereikt; ze stoppen geen verzoeken.

Een bestedingslimiet voor een organisatie instellen

1. Ga naar de organisatie-instellingen.

2. Open Limieten en zoek Uitgaven.

Een bestedingslimiet voor een project instellen

1. Ga naar de organisatie-instellingen.

2. Selecteer het project en open Limieten.

3. Stel de waarden in voor Maandelijkse bestedingslimiet en Melding als uitgaven dit bedrag bereiken.

4. Schakel Een harde limiet afdwingen in als je API-verkeer wilt stoppen zodra de geregistreerde uitgaven de limiet bereiken.

Je kunt op deze pagina ook Modelgebruik wijzigen.

Bestedingsmeldingen beheren

Als je een bestedingslimiet voor een project instelt, wordt standaard ook een melding ingesteld voor 100% van die limiet. Selecteer Melding toevoegen om meldingen voor andere drempels toe te voegen.

Organisatie- en projecteigenaren ontvangen bestedingsmeldingen voor projecten. Je kunt in de meldingsinstellingen andere e-mailontvangers toevoegen.

Zie de gids voor bestedingslimieten voor de actuele configuratiestappen en uitleg over hoe limieten worden afgedwongen.

Gebruik en facturering bekijken

Je kunt het gebruik uitsplitsen per project, factureringsgegevens bekijken en bestedingslimieten voor afzonderlijke projecten instellen.

Toegang tot het gebruiksdashboard van een project hangt af van je organisatierol en de zichtbaarheidsinstellingen van het gebruiksdashboard. De rol van projecteigenaar geeft op zichzelf geen toegang.

Als je het gebruiksdashboard van een project niet kunt zien, controleer dan of de zichtbaarheid is ingesteld op Zichtbaar voor eigenaren van de organisatie.

Bestandsopslag beheren

Elk project heeft een opslagquotum van 100 GB voor bestanden. Als je dit overschrijdt, kun je deze foutmelding zien:

Je hebt je opslagquotum voor bestanden overschreden. Organisaties mogen maximaal 100 GB aan bestanden opslaan. Verklein het bestand of neem contact op met de ondersteuning.

Verwijder ongebruikte bestanden om opslagruimte vrij te maken. Je kunt via de API een lijst met opgeslagen bestanden opvragen om te bepalen welke bestanden je niet meer nodig hebt.

Een project archiveren

Organisatie- en projecteigenaren kunnen projecten archiveren via de pagina Projecten of de instellingen van het afzonderlijke project. Voer de projectnaam in wanneer daarom wordt gevraagd om te bevestigen.

Archiveren is definitief: een gearchiveerd project kan niet worden hersteld.

Open het tabblad Gearchiveerd op de pagina Projecten om gearchiveerde projecten te bekijken.

Projecten kunnen niet worden verwijderd. OpenAI bewaart de projectgeschiedenis om gebruik en facturering bij te houden.