Projecten zijn bedoeld om klanten te helpen hun werk te organiseren. Organisaties kunnen toegang en limieten beheren, serviceaccounts inrichten (via de UI) en gebruik bijhouden binnen een afgebakend bereik binnen een project (bijv. modellen, mogelijkheden, threads, assistants, fine-tuning, opslag, enz.). Gebruiksactiviteit kan per project worden uitgesplitst, en gebruikers kunnen facturering bekijken en per project bestedingslimieten instellen.
Organisatie-eigenaren kunnen al hun actieve en gearchiveerde projecten bekijken op de pagina Projecten. Meer informatie over gebruikersrollen en machtigingen in de API-platform.
Wie kan een project maken?
Alleen organisatie-eigenaren kunnen een project maken. Raadpleeg rollen en machtigingen voor meer informatie.
Als je tussen organisaties wilt schakelen, beweeg je de muis over de naam van je organisatie linksboven op de pagina en selecteer je de organisatie uit de lijst:
Voor organisaties met een geconsolideerd factureringsplan worden suborganisaties afzonderlijk geïdentificeerd. Projecten kunnen niet binnen suborganisaties worden gemaakt.
Hoe werken projecten?
Elke organisatie bevat een ‘standaardproject’ dat niet kan worden verwijderd. Je kunt de rate limits, virtuele modelmachtigingen en bestedingslimieten configureren (sinds november 2024). Het neemt de volledige configuratie van de organisatie over, dus je kunt er niet rechtstreeks leden of serviceaccounts aan toevoegen.
Hoe maak ik een project?
Plaats eerst de muisaanwijzer op de projectnaam in de linkerhoek van de pagina en selecteer Project maken.
Voer een naam, beschrijving en website voor je project in en selecteer vervolgens Maken.
Hoe voeg ik gebruikers toe aan een project?
Nieuwe organisatieleden worden niet automatisch toegevoegd aan het "Standaardproject". Nieuwe leden kunnen voor het project worden uitgenodigd wanneer ze voor de organisatie worden uitgenodigd (door het selectievakje "Uitnodigen voor standaardproject" in te schakelen) of nadat ze de uitnodiging voor de organisatie hebben geaccepteerd.
Voor gebruikers die via de Admin API worden uitgenodigd, gelden de regels van het /organization/invites-endpoint.
Als er een fout optreedt wanneer je via de gebruikersinterface of de Admin API gebruikers voor een project uitnodigt, controleer dan eerst of het doelproject bestaat en niet is gearchiveerd voordat je de uitnodiging opnieuw verstuurt.
Eigenaars van een organisatie worden automatisch als eigenaar toegevoegd aan nieuwe projecten die binnen de organisatie worden gemaakt.
Welke verschillende gebruikersrollen bestaan er binnen organisaties en projecten, en welke machtigingen horen daarbij?
Terwijl organisaties de rollen ‘eigenaar’ en ‘lezer’ hebben, hebben projecten de rollen ‘eigenaar’ en ‘lid’. Projectleden zijn vergelijkbaar met lezers van een organisatie. Raadpleeg de onderstaande tabel voor een gedetailleerdere beschrijving van de machtigingen die bij elke gebruikersrol horen.
| Rol | Bereik | Beschrijving |
|---|---|---|
| Eigenaar | Organisatie | Kan alle projecten, alle gebruikers en alle API-sleutels maken/bekijken. Kan via de pagina Projecten alle projecten binnen de organisatie monitoren. Kan bestedingslimieten voor de organisatie en voor projecten instellen. Kan machtigingen verlenen om gebruiksinformatie van anderen in de organisatie te bekijken. Kan projecten archiveren. |
| Lezer | Organisatie | Kan inference uitvoeren, resources gebruiken en sleutels maken in de eigen projecten. Kan aan projecten worden toegevoegd. Kan geen projecten maken en geen gebruikers beheren. |
| Eigenaar | Project | Kan andere gebruikers aan het project toevoegen en het project hernoemen, en heeft daarnaast alle mogelijkheden van een lid. Kan bestedingslimieten voor het project instellen. Kan het project archiveren. |
| Lid | Project | Kan inference uitvoeren, resources gebruiken en sleutels maken op projectniveau. |
Waartoe heb ik toegang als ik geen eigenaar van de organisatie ben?
Gebruikers die geen eigenaar van de organisatie zijn, kunnen alleen projecten zien waarvan ze lid zijn. Alleen de organisatie-eigenaar kan alle projecten, leden en API-sleutels op projectniveau zien en heeft toegang tot de pagina Projecten.
Alleen projectleden en organisatie-eigenaars kunnen de binnen dat project gemaakte fijn-afgestelde modellen, de threads van gemaakte Assistants en toegevoegde bestanden zien.
Projectleden kunnen zien wie de andere leden van dat project zijn en welke rollen ze hebben (zoals Eigenaar of Lid).
Hoe wijzig ik de projectrol van een gebruiker of verwijder ik een gebruiker uit een project?
Alleen de eigenaar van een project kan de projectrol van een gebruiker wijzigen of een gebruiker uit een project verwijderen. Raadpleeg rollen en machtigingen voor meer informatie.
Als je een gebruiker in een project wilt bijwerken, ga je naar je organisatie-instellingen, selecteer je het project en klik je op Leden. Je kunt de rol van elk lid instellen op Lid of Eigenaar. Je kunt ook Verwijderen selecteren om de gebruiker uit het project te verwijderen.
Wat is een serviceaccount en hoe verschilt het van een gewone gebruikersaccount?
Een serviceaccount fungeert als een pseudo-gebruiker die is ontworpen voor systeemtoegang, en verschilt van individuele gebruikersaccounts. Alleen organisatie- en projecteigenaren kunnen serviceaccounts maken.
Serviceaccounts zijn alleen beperkt tot projecten.
Een lid aan een project toevoegen
Als je op de knop + Lid toevoegen klikt, zie je een lijst met gebruikers in je organisatie die de rol Lezer hebben. Als je een gebruiker wilt toevoegen die nog geen deel uitmaakt van je organisatie, moet je deze eerst aan de organisatie toevoegen. Je kunt het selectievakje "Toevoegen aan standaardproject" uitgeschakeld laten als je deze gebruiker geen ruimere toegang wilt geven. Serviceaccounts staan niet in deze lijst. Tijdens deze stap kun je voor de rol Eigenaar of Lid kiezen:
Wanneer je een teamlid toevoegt, moet je de rol Lid of Eigenaar toewijzen. Projectleden kunnen API-aanvragen doen om gegevens te lezen of te wijzigen. Projecteigenaars kunnen daarnaast de projectinstellingen en bestedingslimieten wijzigen en projectleden beheren. Raadpleeg rollen en machtigingen voor meer informatie.
Een serviceaccount voor een project maken
Ga eerst naar het project waarvoor je een serviceaccount wilt maken door het te kiezen in de vervolgkeuzelijst in de navigatiebalk:
Ga vervolgens naar je organisatie-instellingen -> Project -> Leden -> en klik op + Serviceaccount:
Serviceaccounts die op projectniveau worden gemaakt, zijn uniek voor het project en kunnen niet worden gebruikt buiten het project waarin ze zijn gemaakt.
Het serviceaccount een naam geven
Ongeacht of u het serviceaccount op organisatieniveau maakt of een account maakt dat uniek is voor een project, kunt u bij het maken van een serviceaccount een unieke serviceaccount-ID maken die bestaat uit letters, cijfers en koppeltekens om het serviceaccount eenvoudig te identificeren.
De API-sleutel van het serviceaccount opslaan
Nadat je de knop Maken hebt geselecteerd, wordt er onmiddellijk een API-sleutel voor het serviceaccount gemaakt en wordt de geheime sleutel weergegeven. Bewaar deze geheime sleutel op een veilige plek. Om veiligheidsredenen kun je deze niet opnieuw bekijken via je OpenAI-account. Als je deze geheime sleutel kwijtraakt, moet je een nieuwe genereren.
De API-sleutel van het serviceaccount heeft standaard lees- en schrijfmachtigingen voor alle API-resources van het project. Je kunt deze machtigingen bijwerken in de API-sleutelinstellingen van je project.
Serviceaccounts staan samen met projectleden op de pagina met ledeninstellingen van je project. Lees hier meer over het wijzigen of verwijderen van de toegang van een serviceaccount via de pagina met ledeninstellingen van je project.
Alle serviceaccounts voor zowel projecten als organisaties worden naast je menselijke gebruikers weergegeven op de ledenpagina op organisatieniveau.
Serviceaccounts worden beheerd als gewone accounts. Vanuit Organisatie -> Ledenmenu kun je een serviceaccount Verwijderen of de rol bijwerken:
Hoe beheer ik API-sleutels binnen de projecten van mijn organisatie?
Je kunt de API-sleutels van elk project aanmaken en beheren op de instellingenpagina van dat project. Ga naar je organisatie-instellingen, selecteer het project en klik op API-sleutels.
Selecteer + Nieuwe geheime sleutel maken om een nieuwe geheime sleutel te maken. Je kunt ook het pictogram Bewerken naast een geheime sleutel selecteren om de machtigingen ervan te wijzigen.
Je kunt de machtigingen voor elke API-sleutel instellen wanneer je een nieuwe geheime sleutel maakt of een bestaande sleutel bewerkt.
Er zijn drie machtigingsniveaus beschikbaar: Alles, Beperkt en Alleen-lezen.
Alles — De geheime sleutel krijgt volledige machtigingen. Dit is de standaardinstelling.
Beperkt — Hiermee kan de gebruiker voor elk endpoint de machtiging Geen, Lezen of Schrijven instellen.
Je kunt bijvoorbeeld een API-sleutel maken die specifiek geen machtiging heeft om het endpoint /v1/assistants te lezen of ernaar te schrijven:
Alleen-lezen — Voor alle endpoints worden leesmachtigingen ingesteld.
Hoe wordt toegang beheerd voor gebruikers die tot meerdere projecten of organisaties behoren?
Gebruikers kunnen lid zijn van zoveel projecten als nodig is. Binnen een project kunnen gebruikers een persoonlijke API-sleutel genereren die is afgebakend en beperkt tot toegang tot dat project en de bijbehorende resources.
Hoe stel ik volumelimieten in en beheer ik ze voor de projecten van mijn organisatie?
Alleen de eigenaar van een organisatie kan volumelimieten op projectniveau instellen en beheren. Raadpleeg rollen en machtigingen voor meer informatie.
Klik in je organisatie-instellingen op het project dat je wilt bijwerken en selecteer Limieten in de sectie Project van de navigatielijst. Je kunt je Modelgebruik op deze pagina bijwerken.
Met modelgebruik kun je configureren welke modellen door het project kunnen worden gebruikt, en volumelimieten kunnen indien nodig per model worden ingesteld.
Hoe stel en beheer ik bestedingslimieten voor de projecten van mijn organisatie?
Alleen eigenaars van een organisatie en eigenaars van een project kunnen bestedingslimieten voor projecten instellen en beheren. Raadpleeg rollen en machtigingen voor meer informatie. Als je de limieten op organisatieniveau wilt wijzigen, ga je naar je organisatie-instellingen, klik je op Limieten en scrol je omlaag naar Gebruikslimieten.
Als je de projectlimieten wilt instellen, ga je naar je organisatie-instellingen, klik je op het project dat je wilt bijwerken en selecteer je Limieten. Je kunt je Maandelijkse bestedingslimiet, Meldingsdrempel en Modelgebruik bijwerken.
Door een maandelijkse bestedingslimiet in te stellen, kun je zachte bestedingsdrempels voor je project bepalen. Als het gebruik deze limiet in een bepaalde kalendermaand (UTC) overschrijdt, worden API-aanvragen zonder onderbreking verwerkt. Deze functie helpt je het gebruik te bewaken via waarschuwingen voor bestedingslimieten, maar legt geen harde bestedingslimiet op. Wanneer een bestedingslimiet voor een project wordt ingesteld, wordt standaard een waarschuwing aangemaakt bij de drempel van 100%. Je kunt extra waarschuwingen voor andere drempels instellen door op Waarschuwing toevoegen te klikken.
Houd er rekening mee dat de eigenaars van de organisatie en het project deze berichten altijd ontvangen. Dit kan niet worden aangepast.
Hoe stel ik bestedingslimieten in voor mijn organisatie of project?
OpenAI ondersteunt nu maandelijkse API-bestedingslimieten op zowel organisatie- als projectniveau. Een bestedingslimiet kan uitgaven monitoren zonder deze af te dwingen, of je kunt deze als harde limiet afdwingen zodat API-aanvragen mislukken nadat de uitgaven de limiet hebben bereikt. Zie Bestedingslimieten in de ontwikkelaarsdocumentatie voor de nieuwste configuratiestappen en het actuele gedrag.
Hoe verwijder of archiveer ik een project?
Je kunt projecten archiveren via de nieuwe pagina met het projectoverzicht of via de instellingen van een afzonderlijk project. Een gearchiveerd project kan niet worden hersteld. Wanneer je een project archiveert, wordt je gevraagd de naam van het project in te voeren om door te gaan.
Je kunt een lijst met alle gearchiveerde projecten bekijken via het tabblad "Gearchiveerd" op dezelfde pagina met het projectoverzicht.
Projecten kunnen niet worden verwijderd. We bewaren de geschiedenis van alle projecten om de continuïteit van de gebruiks- en factureringstracering te waarborgen.
Is er een limiet aan het aantal projecten dat ik in mijn organisatie kan hebben?
Organisaties kunnen standaard maximaal 2.000 projecten maken.
Kunnen resources tussen projecten worden gedeeld?
Projectresources (zoals bestanden, assistants, opslag of threads) zijn beperkt tot het project en zijn niet toegankelijk voor niet-adminleden buiten het project. Bovendien kunnen resources niet tussen projecten worden verplaatst.
De enige uitzondering is dat fine-tunes in het ‘Standaardproject’ vanuit andere projecten toegankelijk zijn.
Hoe groot is het opslagquotum voor bestanden per project?
OpenAI ondersteunt momenteel een opslagquotum van 100 GB aan bestanden per project.
Als dit quotum wordt overschreden, zie je de volgende foutmelding:
U hebt uw quota voor bestandsopslag overschreden. Organisaties zijn beperkt tot 100 GB aan bestanden. Verklein het bestand of neem contact op met support.We raden je aan ongebruikte bestanden die in je account zijn opgeslagen te verwijderen. Ter referentie: je kunt bestanden bekijken en weergeven met de API.
Ik ben projecteigenaar. Waarom kan ik het gebruiksdashboard van mijn project niet zien?
De zichtbaarheid van het gebruiksdashboard van een project hangt niet samen met de rol van een gebruiker binnen het project. Deze wordt bepaald door je rol binnen de organisatie en de instellingen op https://platform.openai.com/settings/organization/data-controls/visibility
Als je een gebruiksdashboard niet kunt zien, is deze instelling waarschijnlijk ingesteld op "Zichtbaar voor organisatie-eigenaars".