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, erreicht ausschließlich die Completion-Endpunkte und verbraucht das Nutzungsbudget dieses Mitglieds. Du entscheidest also, wer Zugriff bekommt und wie viel ausgegeben werden kann.
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.
In Dedicated Deployments laufen Workspace-API-Keys weiterhin als die Person, die sie erstellt hat.