Projekte sollen Kundinnen und Kunden dabei helfen, ihre Arbeit zu organisieren. Organisationen können Zugriff und Limits verwalten, Servicekonten bereitstellen (über die Benutzeroberfläche) und die Nutzung innerhalb eines begrenzten Projektumfangs nachverfolgen, z. B. Modelle, Funktionen, Threads, Assistenten, Fine-Tuning, Speicher usw. Nutzungsaktivitäten lassen sich nach Projekt aufschlüsseln. Nutzerinnen und Nutzer können die Abrechnung einsehen und Ausgabenlimits pro Projekt festlegen.
Owner einer Organisation können alle aktiven und archivierten Projekte auf der Projektseite anzeigen. Mehr über Benutzerrollen und Berechtigungen in der API-Plattform erfahren.
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 „Standardprojekt“, das nicht gelöscht werden kann. Du kannst die Rate Limits, Berechtigungen für virtuelle Modelle und Ausgabenlimits konfigurieren (Stand: November 2024). Es übernimmt die vollständige Konfiguration der Organisation. Deshalb kannst du ihm keine Mitglieder oder Servicekonten direkt hinzufügen.
Wie erstelle ich ein Projekt?
Bewege den Mauszeiger zunächst links auf der Seite über den Projektnamen und wähle Projekt erstellen aus.
Gib einen Namen, eine Beschreibung und eine Website für dein Projekt an und wähle anschließend Erstellen aus.
Wie füge ich einem Projekt Personen hinzu?
Neu hinzugefügte Organisationsmitglieder werden nicht automatisch dem „Standardprojekt“ hinzugefügt. Neue Mitglieder können entweder bei der Einladung in die Organisation zum Projekt eingeladen werden, indem das Kontrollkästchen „Zum Standardprojekt einladen“ aktiviert wird, oder nachdem sie die Einladung in die Organisation angenommen haben.
Für über die Admin-API eingeladene Personen gelten die Regeln des /organization/invites-Endpunkts.
Wenn beim Einladen von Personen in ein Projekt über die Benutzeroberfläche oder die Admin-API ein Fehler auftritt, prüfe vor dem erneuten Senden der Einladung zunächst, ob das Zielprojekt vorhanden und nicht archiviert ist.
Organisationsinhaber werden neuen Projekten innerhalb der Organisation automatisch als Inhaber hinzugefügt.
Welche Benutzerrollen gibt es in Organisationen und Projekten, und welche Berechtigungen haben sie?
Während Organisationen die Rollen „Owner“ und „Reader“ haben, gibt es in Projekten die Rollen „Owner“ und „Member“. Projektmitglieder entsprechen in etwa Readern auf Organisationsebene. In der folgenden Tabelle findest du eine genauere Beschreibung der Berechtigungen, die zu den einzelnen Benutzerrollen gehören.
| Rolle | Geltungsbereich | Beschreibung |
|---|---|---|
| Owner | Organisation | Kann alle Projekte, alle Personen und alle API-Schlüssel erstellen bzw. anzeigen. Kann über die Projektseite alle Projekte innerhalb der Organisation überwachen. Kann Ausgabenlimits für die Organisation und für Projekte festlegen. Kann Berechtigungen vergeben, damit andere in der Organisation Nutzungsinformationen anzeigen können. Kann Projekte archivieren. |
| Reader | Organisation | Kann in den eigenen Projekten Inferenz ausführen, Ressourcen nutzen und Schlüssel erstellen. Kann zu Projekten hinzugefügt werden. Kann keine Projekte erstellen und keine Personen verwalten. |
| Owner | Projekt | Kann andere Personen zum Projekt hinzufügen und das Projekt umbenennen sowie alle Funktionen eines Member nutzen. Kann Ausgabenlimits für Projekte festlegen. Kann das Projekt archivieren. |
| Member | Projekt | Kann auf Projektebene Inferenz ausführen, Ressourcen nutzen und Schlüssel erstellen. |
Auf welche Inhalte kann ich zugreifen, wenn ich in der Organisation kein Inhaber bin?
Personen, die keine Organisationsinhaber sind, können nur Projekte sehen, denen sie als Mitglied angehören. Nur der Organisationsinhaber kann alle Projekte, Mitglieder und API-Schlüssel auf Projektebene sehen und auf die Projektseite zugreifen.
Nur Projektmitglieder und Organisationsinhaber können die in diesem Projekt erstellten feinabgestimmten Modelle, die Threads der erstellten Assistants und die hinzugefügten Dateien sehen.
Projektmitglieder können sehen, wer die anderen Mitglieder des Projekts sind und welche Rollen sie haben, beispielsweise Inhaber oder Mitglied.
Wie ändere ich die Projektrolle einer Person oder entferne sie aus einem Projekt?
Nur der Projektinhaber kann die Projektrolle einer Person ändern oder sie aus einem Projekt entfernen. Weitere Informationen findest du unter Rollen und Berechtigungen.
Um eine Person in einem Projekt zu bearbeiten, öffne deine Organisationseinstellungen, wähle das Projekt aus und klicke auf Mitglieder. Du kannst jedem Mitglied entweder die Rolle Mitglied oder Inhaber zuweisen. Du kannst außerdem Entfernen 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.
Ein Mitglied zu einem Projekt hinzufügen
Wenn du auf + Mitglied hinzufügen klickst, siehst du eine Liste der Personen in deiner Organisation mit der Rolle Leser. Wenn du eine Person hinzufügen möchtest, die noch nicht zu deiner Organisation gehört, musst du sie zuerst der Organisation hinzufügen. Du kannst das Kontrollkästchen „Zum Standardprojekt hinzufügen“ deaktiviert lassen, wenn du ihr keinen umfassenderen Zugriff gewähren möchtest. Dienstkonten werden in dieser Liste nicht aufgeführt. In diesem Schritt kannst du ihr entweder die Rolle Inhaber oder Mitglied zuweisen:
Wenn du ein Teammitglied hinzufügst, musst du ihm entweder die Rolle Mitglied oder Inhaber zuweisen. Projektmitglieder können API-Anfragen stellen, die Daten lesen oder ändern. Projektinhaber können außerdem Projekteinstellungen und Ausgabenlimits ändern sowie Projektmitglieder verwalten. Weitere Informationen findest du unter Rollen und Berechtigungen.
Ein Dienstkonto für ein Projekt erstellen
Navigiere zunächst zu dem Projekt, für das du ein Dienstkonto erstellen möchtest, indem du es im Dropdownmenü der Navigationsleiste auswählst:
Öffne dann deine Organisationseinstellungen -> Projekt -> Mitglieder -> und klicke auf + Dienstkonto:
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 Dienstkontos speichern
Nachdem du Erstellen ausgewählt hast, wird sofort ein API-Schlüssel für das Dienstkonto erstellt und der geheime Schlüssel angezeigt. Bewahre diesen geheimen Schlüssel an einem sicheren Ort auf. Aus Sicherheitsgründen kannst du ihn später nicht erneut über dein OpenAI-Konto aufrufen. Wenn du diesen geheimen Schlüssel verlierst, musst du einen neuen erstellen.
Der API-Schlüssel des Dienstkontos besitzt standardmäßig Lese- und Schreibberechtigungen für alle API-Ressourcen des Projekts. Du kannst diese Berechtigungen in den API-Schlüssel-Einstellungen deines Projekts ändern.
Dienstkonten werden auf der Seite mit den Mitgliedseinstellungen deines Projekts zusammen mit den Projektmitgliedern aufgeführt. Weitere Informationen dazu, wie du den Zugriff eines Dienstkontos in den Mitgliedseinstellungen deines Projekts änderst oder entfernst, 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?
Auf der Einstellungsseite des jeweiligen Projekts kannst du API-Schlüssel erstellen und verwalten. Wähle in deinen Organisationseinstellungen das Projekt aus und klicke auf API-Schlüssel.
Um einen neuen geheimen Schlüssel zu erstellen, wähle + Neuen geheimen Schlüssel erstellen aus. Du kannst auch das Bearbeitungssymbol neben einem geheimen Schlüssel auswählen, um dessen Berechtigungen zu ändern.
Du kannst die Berechtigungen für jeden API-Schlüssel beim Erstellen eines neuen geheimen Schlüssels oder durch Bearbeiten eines vorhandenen Schlüssels festlegen.
Es stehen drei Berechtigungsstufen zur Verfügung: Alle, Eingeschränkt und Nur Lesen.
Alle: Für den geheimen Schlüssel werden vollständige Berechtigungen festgelegt. Dies ist die Standardeinstellung.
Eingeschränkt: Ermöglicht es, für jeden Endpunkt die Berechtigungen Keine, Lesen und Schreiben festzulegen.
Du kannst beispielsweise einen API-Schlüssel erstellen, der ausdrücklich keine Lese- oder Schreibberechtigung für den Endpunkt /v1/assistants besitzt:
Nur Lesen: Für alle Endpunkte werden Leseberechtigungen 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 Ausgabenlimits für die Projekte meiner Organisation fest und verwalte sie?
Nur Organisationsinhaber und Projektinhaber können Ausgabenlimits für Projekte festlegen und verwalten. Weitere Informationen findest du unter Rollen und Berechtigungen. Um die Limits auf Organisationsebene zu ändern, öffne deine Organisationseinstellungen, klicke auf Limits und scrolle nach unten zu Nutzungslimits.
Um deine Projektlimits festzulegen, öffne deine Organisationseinstellungen, klicke auf das gewünschte Projekt und wähle Limits aus. Du kannst dein monatliches Ausgabenlimit, deinen Benachrichtigungsschwellenwert und die Modellnutzung ändern.
Mit einem monatlichen Ausgabenlimit kannst du einen weichen Ausgabenschwellenwert für dein Projekt festlegen. Wenn die Nutzung dieses Limit in einem Kalendermonat (UTC) überschreitet, werden API-Anfragen weiterhin ohne Unterbrechung verarbeitet. Diese Funktion hilft dir, die Nutzung mithilfe von Warnungen zu Ausgabenlimits zu überwachen. Sie setzt jedoch keine feste Ausgabenobergrenze durch. Beim Erstellen eines Ausgabenlimits für ein Projekt wird standardmäßig eine Warnung für den Schwellenwert von 100 % eingerichtet. Durch Klicken auf Warnung hinzufügen kannst du weitere Warnungen für andere Schwellenwerte einrichten.
Beachte, dass Organisationsinhaber und Projektinhaber diese Nachrichten immer erhalten. Dies lässt sich nicht anpassen.
Wie lege ich Ausgabenlimits für meine Organisation oder mein Projekt fest?
OpenAI unterstützt jetzt monatliche API-Ausgabenlimits auf Organisations- und Projektebene. Ein Ausgabenlimit kann Ausgaben nur überwachen, ohne sie durchzusetzen. Du kannst es aber auch als festes Limit durchsetzen, sodass API-Anfragen fehlschlagen, sobald die Ausgaben das Limit erreichen. Die aktuellen Schritte zur Konfiguration und das genaue Verhalten findest du unter Ausgabenlimits in der Entwicklerdokumentation.
Wie lösche oder archiviere ich ein Projekt?
Projekte können entweder über die neue Seite Projektübersicht oder in den Einstellungen des jeweiligen Projekts archiviert werden. Ein archiviertes Projekt kann nicht wiederhergestellt werden. Beim Archivieren wirst du aufgefordert, zur Bestätigung den Namen des Projekts einzugeben.
Eine Liste aller archivierten Projekte findest du auf derselben Seite Projektübersicht unter dem Tab „Archiviert“.
Projekte können nicht gelöscht werden. Wir bewahren den Verlauf aller Projekte auf, damit die Nutzungs- und Abrechnungsdaten lückenlos nachvollziehbar bleiben.
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 pro Projekt.
Wenn dieses Kontingent überschritten wird, wird der folgende Fehler angezeigt:
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 Projektinhaber. Warum sehe ich das Nutzungs-Dashboard meines Projekts nicht?
Ob das Nutzungs-Dashboard eines Projekts sichtbar ist, hängt nicht von der Rolle einer Person im Projekt ab. Ausschlaggebend sind stattdessen deine Rolle in der Organisation und die Einstellungen unter https://platform.openai.com/settings/organization/data-controls/visibility.
Wenn du ein Nutzungs-Dashboard nicht sehen kannst, ist diese Einstellung wahrscheinlich auf „Für Organisationsinhaber sichtbar“ festgelegt.