Skip to main content
API-Einstellungen mit den Tabs Workspace-API-Keys und Persönliche API-Keys, wobei der Tab Persönliche API-Keys ausgewählt ist
Mit persönlichen API-Keys nutzen Mitglieder die Modelle deines Workspace in Coding-Tools und eigenen Projekten, ohne dass du einen gemeinsamen Workspace-Key herausgeben musst. Jeder Key gehört dem Mitglied, das ihn erstellt hat, und zählt zum Nutzungsbudget dieses Mitglieds. Du entscheidest, wer Zugriff bekommt, welche Ausgabenlimits gelten und welche zusätzlichen API-Scopes Mitglieder nutzen dürfen. Der Completion-Scope ist für persönliche API-Keys standardmäßig enthalten. Du kannst zusätzlich die Workflow-Schreib-API erlauben. Erstellen, Aktualisieren und Veröffentlichen laufen dann als dieses Mitglied. Bestehende Keys behalten die Scopes, mit denen sie erstellt wurden, bis ein Mitglied nach der Freigabe einen neuen Key anlegt. Die Workflow-Lösch-API kannst du einem persönlichen Key nicht geben.
Der Tab Persönliche API-Keys erscheint erst, wenn die Funktion für deinen Workspace freigeschaltet ist. Mitglieder sehen API-Schlüssel in ihren Account-Einstellungen erst, nachdem du ihnen Zugriff gegeben hast.

​
Mitgliedern Zugriff geben

1

Einstellungen für persönliche API-Keys öffnen

Gehe zu Einstellungen > Workspace > Produkte > API und öffne Persönliche API-Keys.
2

Zugriff festlegen

Öffne den Zugriff für den ganzen Workspace oder beschränke ihn auf die Personen, die ihn brauchen:
Aktiviere Allgemeiner Zugriff, damit alle im Workspace einen persönlichen API-Key erstellen können.
Aktivierter Schalter Allgemeiner Zugriff, damit alle im Workspace einen persönlichen API-Key erstellen können
3

Budget bereitstellen

Ausgabenlimits für Nutzer, Gruppen und Agenten mit geöffnetem Tab Nutzer, inklusive Plan, Nutzung und Limit für Extra-Nutzung eines Mitglieds
Die Nutzung persönlicher API-Keys geht vom selben Budget ab wie die Nutzung des Mitglieds in Chat und Agenten. Aktiviere unter Einstellungen > Workspace > Nutzung die Extra-Nutzung und setze für jedes berechtigte Mitglied ein effektives Limit über null. Achte darauf, dass das Workspace-Ausgabenlimit ebenfalls ausreichend Spielraum für die persönliche API-Nutzung hat.
Ein Mitglied mit Zugriff, aber ohne verfügbares Budget kann die Seite für persönliche API-Keys öffnen, aber keinen Key erstellen. Persönliche API-Anfragen geben einen Fehler zurück und verwenden kein Fallback-Modell, wenn das effektive Budget des Mitglieds aufgebraucht ist. Sind Nutzungslimit-Anfragen aktiviert, kann es dort direkt ein höheres individuelles Limit anfragen. Wenn das Workspace-Ausgabenlimit erreicht ist, stellt ein höheres individuelles Limit den API-Zugriff nicht wieder her. Persönliche API-Anfragen geben weiterhin einen Fehler zurück, bis du das Workspace-Limit erhöhst, auf Unbegrenzt setzt oder wartest, bis der aktuelle Abrechnungszeitraum zurückgesetzt wird.
In BYOK und Dedicated Deployments setzt du stattdessen für jedes Mitglied ein individuelles Limit für Extra-Nutzung über null. Limits aus Plänen oder Gruppen gelten dort nicht für persönliche Keys, und Extra-Nutzung muss nicht aktiviert sein. Wie die Limits zusammenspielen, steht unter Nutzungslimits bei BYOK.

​
Nutzung einsehen und Keys widerrufen

Unter Nutzungseinblicke siehst du die API-Ausgaben im aktuellen Monat, wie viele Keys aktiv sind, wie viele Mitglieder einen Key haben und die täglichen Ausgaben pro Mitglied der letzten 14 Tage.
Karten der Nutzungseinblicke mit den API-Ausgaben dieses Monats, der Anzahl aktiver Keys und der Anzahl der Mitglieder mit Key
Unter Alle persönlichen Keys prüfst du einzelne Keys. Du kannst nach Mitgliedern suchen, nach Ausgaben oder Aktivität filtern, Besitzer, letzte Nutzung, Verbrauch im aktuellen Monat und Status jedes Keys einsehen und einen Key widerrufen. Ein Widerruf gilt sofort und lässt sich nicht zurücknehmen. Ein persönlicher Key funktioniert außerdem nicht mehr, wenn du einem Mitglied den Zugriff auf persönliche API-Keys entziehst oder seine Workspace-Mitgliedschaft deaktivierst.

​
Wann sollte ich einen persönlichen Key nutzen?

Nimm einen persönlichen API-Key, wenn ein einzelnes Mitglied API-Zugriff mit der eigenen Identität und dem eigenen Budget braucht. Für gemeinsame Anwendungen und Automatisierungen, die nicht am Account einer einzelnen Person hängen sollen, nimm einen Workspace-API-Key. Ein Workspace-API-Key läuft als Service Account. Er nutzt nicht die persönlichen Verbindungen der Person, die ihn erstellt hat. Für Agenten, die du mit einem Workspace-API-Key aufrufst, wähle eine Verbindung voraus oder teile die Verbindung mit diesem Key. Ist eine Aktion nicht für den gesamten Workspace verfügbar, teile diese Aktion mit dem Key.