Projekte in der API-Plattform verwalten

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?

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 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.

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.

Mitglied zu einem Projekt hinzufügen

Wenn du auf die Schaltfläche + Add member klickst, siehst du eine Liste der Personen in deiner Organisation mit der Rolle Reader. Wenn du eine Person hinzufügen möchtest, die derzeit nicht zu deiner Organisation gehört, musst du sie zuerst zur Organisation hinzufügen. Du kannst das Kontrollkästchen „Zum Standardprojekt hinzufügen“ deaktiviert lassen, wenn du diesen Personen keinen weitergehenden Zugriff geben möchtest. Diese Liste enthält keine Servicekonten. In diesem Schritt kannst du auswählen, ob ihre 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 Ausgabenlimits für Projekte ä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:

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.

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 Ausgabenlimits für die Projekte meiner Organisation fest und verwalte sie?

Nur Owner einer Organisation und Owner eines Projekts können Ausgabenlimits für Projekte 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 dein Monthly spend limit, den Notification threshold und die Model Usage aktualisieren.

Mit einem monatlichen Ausgabenlimit kannst du flexible Ausgabenschwellen für dein Projekt festlegen. Wenn die Nutzung dieses Limit in einem bestimmten Kalendermonat (UTC) überschreitet, werden API-Anfragen ohne Unterbrechung weiter verarbeitet. Diese Funktion hilft dir, die Nutzung über Benachrichtigungen zu Ausgabenlimits im Blick zu behalten. Sie setzt jedoch keine feste Obergrenze für Ausgaben durch. Wenn ein Ausgabenlimit für ein Projekt erstellt wird, wird standardmäßig eine Benachrichtigung bei 100 % angelegt. Weitere Benachrichtigungen mit anderen Schwellenwerten kannst du einrichten, indem du auf Add Alert klickst.

Bitte beachte, dass die Owner der Organisation und die Owner des Projekts diese Nachrichten immer erhalten. Das 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 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.

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:

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.