API-Schlüssel

Generieren, kopieren, identifizieren und widerrufen Sie einen persönlichen Runner-API-Schlüssel sicher.

API-Schlüssel sind persönliche Geheimnisse für programmatischen Runner-Zugriff. Erstellen Sie einen nur für eine Anwendung, der Sie vertrauen, speichern Sie ihn sicher und widerrufen Sie ihn, wenn er nicht mehr benötigt wird.

Was dieser Leitfaden abdeckt

Sie werden wissen, wie Sie das einmalige Geheimnis erstellen und speichern, vorhandene Schlüssel identifizieren, ohne sie offenzulegen, und einen Schlüssel mit Bestätigung widerrufen.

Verfügbarkeit und Voraussetzungen

API-Schlüssel ist bedingt und wird nur angezeigt, wenn es für Ihr Konto aktiviert ist.
Schlüssel gehören zu Ihrem persönlichen Konto, nicht zu einem Shop.
Geben Sie niemals einen vollständigen Schlüssel in Chat, Agent Memory, eine Skill, einen Screenshot, die Quellcodeverwaltung oder die Produktdokumentation ein.

Eingabepfad

Wählen Sie Avatar → Einstellungen → Persönlich → API-Schlüssel. Wenn der Eintrag fehlt, ist die Funktion nicht für das aktuelle Konto verfügbar.

Steuerelemente

Eintrag oder Schaltfläche	Warum es nützlich ist	Was passiert als Nächstes
Neuen Schlüssel generieren	Erstellen Sie eine neue Anmeldeinformation.	Ein Dialog wird mit einem optionalen Namensfeld geöffnet.
Name	Identifizieren Sie die Anwendung später, ohne das Geheimnis offenzulegen.	Der Name wird in der Schlüsseltabelle angezeigt; leer erstellt einen unbenannten Schlüssel.
Schlüssel erstellen	Generieren Sie die Anmeldeinformation.	Runner öffnet API-Schlüssel generiert und zeigt das vollständige Geheimnis einmal an.
Augensymbol	Überprüfen Sie den vollständigen neu generierten Wert, bevor Sie ihn speichern.	Der einmalige Wert wird im Erfolgsdialog angezeigt oder verborgen.
Kopiersymbol	Kopieren Sie den neuen Schlüssel genau.	Runner kopiert ihn in die Zwischenablage und zeigt eine Bestätigung an.
Ich habe es gespeichert	Schließen Sie die einmalige Geheimnisansicht.	Der vollständige Wert wird aus dem Dialog gelöscht und kann dort nicht erneut angezeigt werden.
Vorhandene Schlüsseltabelle	Identifizieren Sie Schlüssel sicher.	Runner zeigt Name, Präfix, Erstellt und Zuletzt verwendet an, nicht das vollständige Geheimnis.
Löschsymbol	Widerrufen Sie einen vorhandenen Schlüssel.	Eine Bestätigung erklärt, dass der Widerruf nicht rückgängig gemacht werden kann.
Widerrufen	Deaktivieren Sie den ausgewählten Schlüssel.	Nach dem Erfolg wird der Schlüssel aus der Liste entfernt und kann sich nicht mehr authentifizieren.

Generieren und speichern Sie einen Schlüssel

Öffnen Sie Persönlich → API-Schlüssel.
Wählen Sie Neuen Schlüssel generieren.
Geben Sie einen beschreibenden Namen ein, z. B. die Anwendung oder Umgebung. Geben Sie kein Geheimnis in den Namen ein.
Wählen Sie Schlüssel erstellen.
Geben Sie in API-Schlüssel generiert den Schlüssel nur bei Bedarf frei und wählen Sie Kopieren.
Speichern Sie ihn in einem vertrauenswürdigen Secret Manager.
Bestätigen Sie den gespeicherten Wert, bevor Sie Ich habe es gespeichert wählen.
Verwenden Sie das Tabellenpräfix, um den Schlüssel später zu identifizieren, ohne den vollständigen Wert offenzulegen.

Runner warnt, dass der vollständige Schlüssel nicht erneut angezeigt wird. Wenn Sie den Dialog schließen, ohne ihn zu speichern, widerrufen Sie diesen Schlüssel und erstellen Sie einen Ersatz, anstatt zu versuchen, das Geheimnis wiederherzustellen.

Widerrufen Sie einen Schlüssel

Stimmen Sie den beabsichtigten Schlüssel nach Name und Präfix ab.
Wählen Sie sein Löschsymbol.
Überprüfen Sie die Widerrufen-Bestätigung.
Wählen Sie Widerrufen nur, wenn die abhängige Anwendung bereit ist, ihn nicht mehr zu verwenden.
Bestätigen Sie API-Schlüssel widerrufen und entfernen Sie das alte Geheimnis aus der Anwendung.

Der Widerruf ist destruktiv und kann nicht rückgängig gemacht werden. Erstellen Sie einen neuen Schlüssel, wenn der Zugriff später erforderlich ist.

Zustände und Limits

Noch keine API-Schlüssel ist der normale leere Zustand.
Der vollständige Wert eines neuen Schlüssels wird nur in seinem Erfolgsdialog angezeigt.
Vorhandene Zeilen zeigen ein Präfix und Nutzungsdaten an, keinen wiederherstellbaren Schlüssel.
Nie unter Zuletzt verwendet bedeutet, dass Runner keine Anfrage für diesen Schlüssel aufgezeichnet hat.
Die Schaltflächen Erstellen und Widerrufen zeigen den Fortschritt an und sollten nicht wiederholt eingereicht werden.

Fehlerbehebung

Wenn API-Schlüssel fehlen, verwenden Sie keinen kopierten direkten Link; die Funktion ist für dieses Konto deaktiviert.
Wenn das Kopieren in die Zwischenablage fehlschlägt, geben Sie den neuen Wert frei und kopieren Sie ihn manuell in einen sicheren Secret Manager, dann verbergen Sie ihn erneut.
Wenn Sie einen vollständigen Schlüssel verloren haben, widerrufen Sie seine Zeile und generieren Sie einen Ersatz.
Wenn eine Anwendung nach dem Widerruf nicht mehr funktioniert, aktualisieren Sie sie mit einem neu erstellten Schlüssel; der alte Schlüssel kann nicht wiederhergestellt werden.
Wenn der falsche Schlüssel ausgewählt wurde, brechen Sie die Bestätigung ab und vergleichen Sie Name und Präfix erneut.