Projekte sollen Kund:innen dabei helfen, ihre Arbeit zu organisieren. Organisationen können Zugriff und Limits verwalten, Servicekonten bereitstellen (über die UI) und die Nutzung innerhalb eines begrenzten Projektumfangs nachverfolgen, z. B. Modelle, Funktionen, Threads, Assistants, Fine-Tuning, Speicher usw. Nutzungsaktivitäten können nach Projekt aufgeschlüsselt werden. Nutzer:innen können die Abrechnung einsehen und Budgets pro Projekt festlegen.
Organisations-Owner können alle ihre aktiven und archivierten Projekte auf der Projects page anzeigen. Erfahre mehr über Nutzerrollen und Berechtigungen in der API Platform.
Wer kann ein Projekt erstellen?
Nur Organisations-Owner können ein Projekt erstellen. Weitere Informationen findest du unter Rollen und Berechtigungen.
Um zwischen Organisationen zu wechseln, bewege den Mauszeiger oben links auf der Seite über den Namen deiner Organisation und wähle die Organisation aus der Liste aus:
Bei Organisationen mit konsolidiertem Abrechnungsplan werden Unterorganisationen separat ausgewiesen. In Unterorganisationen können keine Projekte erstellt werden.
Wie funktionieren Projekte?
Jede Organisation enthält ein „Default project“, das nicht gelöscht werden kann. Sie können die Ratenlimits, Berechtigungen für virtuelle Modelle und Ausgabenbudgets konfigurieren (Stand November 2024). Es übernimmt die vollständige Konfiguration der Organisation, daher können Sie ihm nicht direkt Mitglieder oder Servicekonten hinzufügen.
Wie erstelle ich ein Projekt?
Bewegen Sie zuerst den Mauszeiger über den Projektnamen in der linken Ecke der Seite und wählen Sie Create project.
Geben Sie einen Namen, eine Beschreibung und eine Website für Ihr Projekt an und wählen Sie dann Create.
Wie füge ich Nutzer:innen zu einem Projekt hinzu?
Neu hinzugefügte Organisationsmitglieder werden nicht automatisch zum „Default project“ hinzugefügt. Neue Mitglieder können entweder beim Einladen in die Organisation zum Projekt eingeladen werden, indem du das Kontrollkästchen „Invite to default project“ aktivierst, oder nachdem das Mitglied die Einladung zur Organisation angenommen hat.
Nutzer:innen, die über die Admin API eingeladen wurden, folgen den Regeln, die im /organization/invites-Endpunkt beschrieben sind.
Wenn beim Einladen von Nutzer:innen zu einem Projekt über die UI oder die Admin API ein Fehler auftritt, prüfe zuerst, ob das Zielprojekt existiert und nicht archiviert ist, bevor du die Einladung erneut sendest.
Organisations-Owner werden automatisch als Owner zu neuen Projekten hinzugefügt, die innerhalb einer Organisation erstellt werden.
Welche unterschiedlichen Nutzerrollen gibt es in Organisationen und Projekten, und welche Berechtigungen umfassen sie?
Während Organisationen die Rollen „owner“ und „reader“ haben, haben Projekte die Rollen „owner“ und „member“. Projektmitglieder entsprechen in etwa Organisations-Readern. Eine ausführlichere Beschreibung der Berechtigungen, die mit den einzelnen Nutzerrollen verbunden sind, findest du in der folgenden Tabelle.
| Rolle | Bereich | Beschreibung |
|---|---|---|
| Owner | Organisation | Kann alle Projekte, alle Nutzer:innen und alle API-Schlüssel erstellen bzw. anzeigen. Kann mit der Projects page alle Projekte innerhalb der Organisation überwachen. Kann Organisationsbudgets und Projektbudgets festlegen. Kann anderen Personen in der Organisation Berechtigungen zum Anzeigen von Nutzungsinformationen erteilen. Kann Projekte archivieren. |
| Reader | Organisation | Kann Inferenz ausführen, Ressourcen nutzen und Schlüssel in eigenen Projekten erstellen. Kann Projekten hinzugefügt werden. Kann keine Projekte erstellen und keine Nutzer:innen verwalten. |
| Owner | Projekt | Kann andere Nutzer:innen zum Projekt hinzufügen und das Projekt umbenennen sowie alle Funktionen eines Members nutzen. Kann Projektbudgets festlegen. Kann das Projekt archivieren. |
| Member | Projekt | Kann auf Projektebene Inferenz ausführen, Ressourcen nutzen und Schlüssel erstellen. |
Worauf habe ich Zugriff, wenn ich kein Owner in der Organisation bin?
Nutzer:innen, die keine Owner in der Organisation sind, können nur Projekte sehen, in denen sie Mitglied sind. Nur der Organisations-Owner kann alle Projekte, Mitglieder und API-Schlüssel auf Projektebene sehen und hat Zugriff auf die Projects page.
Nur die Mitglieder eines Projekts und Organisations-Owner können die innerhalb dieses Projekts erstellten feinabgestimmten Modelle, die Threads aus erstellten Assistants oder hinzugefügte Dateien sehen.
Mitglieder eines Projekts können sehen, wer die anderen Mitglieder dieses Projekts sind und welche Rollen sie haben, d. h. Owner oder Member.
Wie aktualisiere ich die Projektrolle von Nutzer:innen oder entferne Nutzer:innen aus einem Projekt?
Nur der Owner eines Projekts kann die Projektrolle von Nutzer:innen aktualisieren oder Nutzer:innen aus einem Projekt entfernen. Weitere Informationen findest du unter Rollen und Berechtigungen.
Um Nutzer:innen in einem Projekt zu aktualisieren, gehe zu deinen Organisationseinstellungen, wähle das Projekt aus und klicke auf Members. Du kannst die Rolle jedes Mitglieds auf Member oder Owner setzen. Du kannst auch Remove auswählen, um die Person aus dem Projekt zu entfernen.
Was ist ein Servicekonto und wie unterscheidet es sich von einem regulären Nutzerkonto?
Ein Servicekonto fungiert als Pseudo-Nutzer:in für den Systemzugriff und unterscheidet sich von individuellen Nutzerkonten. Nur Organisations- und Projektinhabende können Servicekonten erstellen.
Servicekonten sind nur auf Projekte beschränkt.
Mitglied zu einem Projekt hinzufügen
Wenn du auf die Schaltfläche + Add member klickst, siehst du eine Liste der Nutzer:innen in deiner Organisation mit der Rolle Reader. Wenn du eine:n Nutzer:in hinzufügen möchtest, der:die derzeit nicht in deiner Organisation ist, musst du ihn:sie zuerst zur Organisation hinzufügen. Du kannst das Kontrollkästchen „Add to Default Project“ deaktiviert lassen, wenn du diesen Nutzer:innen keinen umfassenderen Zugriff geben möchtest. Diese Liste enthält keine Servicekonten. In diesem Schritt kannst du auswählen, ob die Rolle Owner oder Member sein soll:
Wenn du ein Teammitglied hinzufügst, musst du ihm entweder die Rolle Member oder Owner zuweisen. Projektmitglieder können API-Anfragen stellen, die Daten lesen oder ändern. Projekt-Owner können außerdem Projekteinstellungen und Projektbudgets ändern sowie Projektmitglieder verwalten. Weitere Informationen findest du unter Rollen und Berechtigungen.
So erstellst du ein Servicekonto für ein Projekt
Navigiere zuerst zu dem Projekt, für das du ein Servicekonto erstellen möchtest, indem du es im Dropdown-Menü in der Navigationsleiste auswählst:
Gehe dann zu deinen Organisationseinstellungen -> Project -> Members -> und klicke auf + Service account:
Auf Projektebene erstellte Servicekonten sind projektspezifisch und können nicht außerhalb des Projekts verwendet werden, in dem sie erstellt wurden.
Benennen des Servicekontos
Unabhängig davon, ob Sie das Servicekonto auf Organisationsebene erstellen oder ein nur für ein Projekt bestimmtes Konto erstellen, können Sie beim Erstellen eines Servicekontos eine eindeutige Servicekonto-ID aus Buchstaben, Zahlen und Bindestrichen festlegen, um das Servicekonto leicht zu identifizieren.
API-Schlüssel des Servicekontos speichern
Nachdem du die Schaltfläche Create ausgewählt hast, wird sofort ein API-Schlüssel für das Servicekonto erstellt und der geheime Schlüssel angezeigt. Speichere diesen geheimen Schlüssel an einem sicheren Ort. Aus Sicherheitsgründen kannst du ihn später nicht noch einmal über dein OpenAI-Konto anzeigen. Wenn du diesen geheimen Schlüssel verlierst, musst du einen neuen generieren.
Die Berechtigungen des API-Schlüssels für das Servicekonto sind standardmäßig auf Lesen und Schreiben für alle API-Ressourcen des Projekts gesetzt. Diese Berechtigungen kannst du in den API Keys-Einstellungen deines Projekts aktualisieren.
Servicekonten werden zusammen mit Projektmitgliedern auf der Mitglieder-Einstellungsseite deines Projekts aufgeführt. Weitere Informationen zum Aktualisieren oder Entfernen des Zugriffs eines Servicekontos auf der Mitglieder-Einstellungsseite deines Projekts findest du hier.
Alle Servicekonten aus Projekten und Organisationen werden zusammen mit deinen menschlichen Nutzer:innen auf der Mitgliederseite auf Organisationsebene angezeigt.
Servicekonten werden wie reguläre Konten verwaltet. Über Organization -> Members menu kannst du ein Servicekonto entfernen oder die Rolle aktualisieren:
Wie verwalte ich API-Schlüssel in den Projekten meiner Organisation?
Du kannst API-Schlüssel für jedes Projekt auf der Einstellungsseite des jeweiligen Projekts erstellen und verwalten. Wähle in deinen Organisationseinstellungen das Projekt aus und klicke auf API Keys.
Um einen neuen geheimen Schlüssel zu erstellen, wähle + Create new secret key aus. Du kannst auch das Bearbeitungssymbol neben einem geheimen Schlüssel auswählen, um dessen Berechtigungen zu bearbeiten.
Du kannst Berechtigungen für jeden deiner API-Schlüssel festlegen, wenn du einen neuen geheimen Schlüssel erstellst oder einen vorhandenen Schlüssel bearbeitest.
Es gibt drei Berechtigungsstufen: All, Restricted und Read Only.
All – Für den geheimen Schlüssel sind vollständige Berechtigungen festgelegt. Das ist die Standardeinstellung.
Restricted – Ermöglicht Nutzer:innen, für jeden Endpunkt die Berechtigungen None, Read und Write festzulegen.
Du erstellst zum Beispiel einen API-Schlüssel, der ausdrücklich keine Berechtigung hat, den Endpunkt /v1/assistants zu lesen oder zu beschreiben:
Read Only – Leseberechtigungen sind für alle Endpunkte festgelegt.
Wie wird der Zugriff für Nutzende verwaltet, die zu mehreren Projekten oder Organisationen gehören?
Nutzende können Mitglied in so vielen Projekten sein, wie erforderlich. Innerhalb eines Projekts können Nutzende einen persönlichen API-Schlüssel generieren, der auf den Zugriff auf dieses Projekt und seine Ressourcen beschränkt ist.
Wie lege ich Ratenlimits für die Projekte meiner Organisation fest und verwalte sie?
Nur der Owner einer Organisation kann Ratenlimits auf Projektebene festlegen und verwalten. Weitere Informationen findest du unter Rollen und Berechtigungen.
Klicke in deinen Organisationseinstellungen auf das Projekt, das du aktualisieren möchtest, und wähle im Projektbereich der Navigationsliste Limits aus. Auf dieser Seite kannst du deine Model Usage aktualisieren.
Mit Model Usage legst du fest, welche Modelle vom Projekt genutzt werden können. Außerdem kannst du bei Bedarf Ratenlimits für jedes Modell festlegen.
Wie lege ich Budgets für die Projekte meiner Organisation fest und verwalte sie?
Nur Owner einer Organisation und Owner eines Projekts können Projektbudgets festlegen und verwalten. Weitere Informationen findest du unter Rollen und Berechtigungen. Um Limits auf Organisationsebene zu ändern, klicke in deinen Organisationseinstellungen auf Limits, und scrolle nach unten zu Usage limits.
Um deine Projektlimits festzulegen, klicke in deinen Organisationseinstellungen auf das Projekt, das du aktualisieren möchtest, und wähle Limits. Du kannst Monthly budget, Notification threshold und Model Usage aktualisieren.
Mit einem monthly budget kannst du weiche Ausgabenschwellen für dein Projekt festlegen. Wenn die Nutzung dieses Limit in einem bestimmten Kalendermonat (UTC) überschreitet, werden API-Anfragen weiterhin ohne Unterbrechung verarbeitet. Diese Funktion hilft dir, die Nutzung mithilfe von Budgetwarnungen zu überwachen. Sie setzt jedoch keine harte Ausgabenobergrenze durch. Wenn ein Projektbudget erstellt wird, wird standardmäßig eine Warnung bei der 100-%-Schwelle erstellt. Weitere Budgets mit anderen Schwellenwerten kannst du festlegen, indem du auf Add Alert klickst.
Bitte beachte, dass die Organisations-Owner und Projekt-Owner diese Nachrichten immer erhalten. Das kann nicht angepasst werden.
Wie lösche oder archiviere ich ein Projekt?
Projekte können entweder über die neue Seite Projektliste oder in den Einstellungen eines einzelnen Projekts archiviert werden. Sobald ein Projekt archiviert ist, kann es nicht wiederhergestellt werden. Wenn du mit der Archivierung fortfährst, wirst du aufgefordert, den Projektnamen einzugeben.
Eine Liste aller archivierten Projekte findest du auf derselben Seite Projektliste über den Tab „Archived“.
Projekte können nicht gelöscht werden. Wir bewahren einen Verlauf aller Projekte auf, um die Kontinuität bei der Nutzungs- und Abrechnungsverfolgung sicherzustellen.
Gibt es ein Limit für die Anzahl der Projekte in meiner Organisation?
Organisationen können standardmäßig bis zu 2.000 Projekte erstellen.
Können Ressourcen projektübergreifend geteilt werden?
Projektressourcen (wie Dateien, Assistants, Speicher oder Threads) sind auf das Projekt beschränkt und können von Nicht-Admin-Mitgliedern außerhalb des Projekts nicht aufgerufen werden. Außerdem können Ressourcen nicht zwischen Projekten verschoben werden.
Die einzige Ausnahme ist, dass Fine-Tunes im „Default project“ von anderen Projekten aus zugänglich sind.
Wie hoch ist das Dateispeicherkontingent pro Projekt?
OpenAI unterstützt derzeit ein Dateispeicherkontingent von 100 GB Dateien pro Projekt.
Wenn dieses Kontingent überschritten wird, sehen Sie die folgende Fehlermeldung:
Sie haben Ihr Kontingent für Dateispeicher überschritten. Organisationen sind auf 100 GB Dateien begrenzt. Bitte reduzieren Sie die Dateigröße oder kontaktieren Sie den Support.Wir empfehlen dir, ungenutzte Dateien zu löschen, die in deinem Konto gespeichert sind. Zur Orientierung kannst du Dateien mit der API anzeigen und auflisten.
Ich bin Projekt-Owner. Warum kann ich das Usage Dashboard für mein Projekt nicht sehen?
Die Sichtbarkeit des Usage Dashboards eines Projekts hängt nicht von der Rolle einer Person innerhalb des Projekts ab. Sie wird stattdessen durch deine Rolle innerhalb der Organisation und die Einstellungen unter https://platform.openai.com/settings/organization/data-controls/visibility bestimmt.
Wenn du ein Usage Dashboard nicht sehen kannst, ist diese Einstellung wahrscheinlich auf „Visible to organization owners“ gesetzt.