Zum Hauptinhalt springen

API-Schlüssel

API-Schlüssel, unter Verbindungen, enthält die Schlüssel, mit denen sich Ihre eigenen Systeme bei Reelwire anmelden: ein Skript, das Ereignisse an einen eigenen Feed sendet, ein Empfänger, der Beiträge zurückmeldet, ein Veröffentlichungswerkzeug und ein über MCP verbundener KI-Assistent, der dieselben Schlüssel verwendet. Schlüssel gibt es in jedem Tarif, auch in Free.

Nur der Inhaber und wer die Berechtigung Verwaltung hat, kann sie öffnen. Ihre erste Karte, API-Schlüssel für Reelwire, die hier beschrieben wird, enthält die Schlüssel, mit denen Ihre eigenen Systeme Reelwire erreichen. Die vier Karten darunter, API-Schlüssel für die KI-Text- und Schrifterzeugung, API-Schlüssel für die KI-Bilderzeugung, API-Schlüssel für die KI-Videoerzeugung und API-Schlüssel für die KI-Musikerzeugung, enthalten die andere Richtung: Ihre Schlüssel für die KI-Dienste, mit denen der KI-Assistent Bilder, Videos, Musik, Schriften und Texte erstellt. Sie sind auf dieser Seite beschrieben.

Die Karte API-Schlüssel für Reelwire

Ein Schlüssel ist ein Bearer-Token, mit dem sich Ihre eigenen Systeme authentifizieren. Jeder Schlüssel darf nur, was Sie erlauben, der Schlüssel in einem Veröffentlichungsskript kann also Ihre Rechnungen nicht lesen.

Die Liste​

Die Liste zeigt für jeden Schlüssel seinen Namen und die ersten und letzten vier Zeichen seines Secrets, was er darf, wann er zuletzt verwendet wurde, wann er abläuft und seinen Status: AKTIV, WIDERRUFEN oder ABGELAUFEN. Ein Schlüssel, der noch funktioniert, hat drei Schaltflächen, Berechtigungen, Kopieren und Widerrufen. Die Suche über der Liste liest die Namen, diese Zeichen und die Berechtigungen.

Einen Schlüssel erstellen​

Schlüssel erstellen, unter der Liste, fragt nach einem Namen (bis zu 80 Zeichen), wann der Schlüssel abläuft, dann was der Schlüssel darf. Die Berechtigungen sind unter denselben Überschriften gruppiert wie das Menü links, und jeder Bereich hat zwei Kästchen, Lesen und Schreiben. Nichts angehakt bedeutet kein Zugriff, und ein Schlüssel, bei dem gar nichts angehakt ist, kann nicht erstellt werden.

Wenn Sie Schreiben anhaken, wird Lesen mit angehakt und gesperrt. Das ist keine Pedanterie der Seite: Ein Schlüssel, der etwas ändern darf, darf es schon ansehen, und Lesen unter Schreiben anhakbar zu lassen, würde es erlauben, eine Berechtigung abzuhaken, die der Schlüssel weiterhin hat.

Zwei Kästchen vergibt nur, wer hat, was sie öffnen: Schreiben bei Beiträge, Freigaben, wer die Berechtigung Freigaben hat, und Lesen bei Tarif, der Inhaber, da der Tarif die Preise und die nächste Rechnung enthält. Für alle anderen ist das Kästchen ausgegraut, mit einem gelben Hinweis unter der Zeile, wer es anhaken darf. Ein Schlüssel, der eines bereits hat, behält es, wenn jemand anderes ihn bearbeitet, und dieser darf es entziehen, nicht geben. Ein von einer Person verbundener KI-Assistent erhält, was diese Person einem Schlüssel geben könnte, und nicht mehr.

Wo ein Bereich nichts zu lesen hat, ist sein Kästchen Lesen ausgegraut. Rohdaten senden ist der eine: Es ist ein Push, und es gibt keine Route dahinter zum Ansehen. Wo ein Bereich nichts hat, was ein Schlüssel ändern darf, ist sein Kästchen Schreiben ausgegraut: Zeitplan und Aktivität sind Aufzeichnungen zum Lesen, und ein Schlüssel darf Ihr Kontingent und Ihren Tarif lesen, aber etwas zu kaufen, zu behalten oder zurückzugeben bewegt Geld und braucht daher eine angemeldete Person. Ein Bereich, den Ihr Tarif nicht enthält, wird gar nicht angeboten: Syndikation unterhalb von Enterprise, Team in Free und Individual.

Was auch immer Sie wählen, kein Schlüssel kann Schlüssel erstellen oder widerrufen, jemanden anmelden oder einen anderen Workspace erreichen.

Das Secret wird angezeigt in einem Dialog, der sich öffnet, sobald der Schlüssel erstellt ist, Ihr neuer API-Schlüssel, mit Kopieren daneben; Ich habe es gespeichert schließt ihn. Der Inhaber erhält eine E-Mail zu jedem neuen Schlüssel, ebenso wer ihn erstellt hat; die E-Mail nennt den Schlüssel, nie sein Secret.

Einen Schlüssel erneut anzeigen​

Kopieren in der Zeile eines Schlüssels zeigt ihn erneut, nachdem Sie das Passwort eingegeben haben, mit dem Sie sich anmelden, und auf Schlüssel anzeigen geklickt haben: Dann erscheint der Schlüssel mit Kopieren daneben. Das können nur Personen, die Schlüssel erstellen dürfen, falsche Passwörter zählen zum selben Limit wie die Anmeldung, und jeder erneut angezeigte Schlüssel wird im Audit-Protokoll des Workspaces festgehalten. Der Schlüssel wird dafür verschlüsselt aufbewahrt; Anfragen werden weiterhin nur an seinem Fingerabdruck geprüft. Ein Schlüssel, der erstellt wurde, bevor Schlüssel erneut angezeigt werden konnten, wurde nur als Fingerabdruck aufbewahrt, daher sagt sein Kopieren, dass er nicht angezeigt werden kann: Erstellen Sie einen neuen Schlüssel, setzen Sie ihn dort ein, wo der alte verwendet wird, und widerrufen Sie dann den alten. Die Verbindung eines KI-Assistenten hat kein Kopieren: Ihr Token erneuert sich jede Stunde von selbst.

Widerrufen und entfernen​

Widerrufen fragt noch einmal nach, dann funktioniert der Schlüssel sofort nicht mehr und bleibt mit seinem Datum der letzten Verwendung in der Liste, woran Sie erkennen, ob der Schlüssel, den Sie gerade beendet haben, noch in Gebrauch war. Ein widerrufener oder abgelaufener Schlüssel hat dann Entfernen in seiner Zeile: Es fragt noch einmal nach und nimmt die Zeile endgültig aus der Liste. Wann er zuletzt verwendet wurde, bleibt im Audit-Protokoll des Workspaces. Die Verbindung eines KI-Assistenten zu widerrufen beendet sie: Der Assistent muss sich erneut verbinden.

Ablauf, und einen Schlüssel ändern​

Ein Schlüssel kann von selbst ablaufen. Wählen Sie Nie, einen Zeitraum (1, 7, 30 oder 90 Tage oder ein Jahr) oder ein genaues Datum mit Uhrzeit in UTC, dieselbe Auswahl, die der Zeitplan eines Beitrags verwendet. In diesem Moment funktioniert der Schlüssel nicht mehr, genau als wäre er widerrufen worden, und seine Zeile zeigt ABGELAUFEN statt WIDERRUFEN, damit Sie einen Schlüssel, der ausgelaufen ist, von einem unterscheiden können, den jemand abgeschaltet hat. Ist ein Ablauf festgelegt, sendet Vor dem Ablauf per E-Mail erinnern eine Woche vorher und noch einmal einen Tag vorher eine Erinnerung an den Inhaber und alle mit der Berechtigung Verwaltung, damit ein neuer Schlüssel bereitsteht, bevor der alte aufhört.

Berechtigungen bei einem Schlüssel, der noch funktioniert, ändert seinen Namen, seinen Ablauf, seine Erinnerung und was er darf, und Berechtigungen speichern behält die Änderung. Ein abgelaufener Schlüssel lässt sich nicht zurückholen; erstellen Sie einen neuen.

Die Verbindung eines KI-Assistenten​

Eine Verbindung, die ein KI-Assistent über MCP herstellt, ist eine eigene Zeile, die sich selbst erneuert: Ihr Ablauf zeigt „Vom Assistenten erneuert“, und es gibt keinen festzulegen. Sie hat auch keine Schaltfläche Berechtigungen: Sie darf, was bei der Verbindung vereinbart wurde, nie mehr, als die Person, die sie hergestellt hat, einem Schlüssel geben könnte, bei jeder Erneuerung stündlich neu geprüft. Sie hat nie Schreiben bei Team oder bei Webhook und gibt Beiträge nur frei, wo die Person, die sie verbindet, das eingeschaltet hat: Das bleibt bei einem hier von Hand erstellten Schlüssel. Um zu ändern, was sie darf, widerrufen Sie sie und verbinden Sie den Assistenten erneut. Wie man einen verbindet, steht unter Installieren im Handbuch KI-Assistenten.

Schlüssel benennen​

Benennen Sie einen Schlüssel danach, wo er liegt, nicht danach, was er tut. Wenn Sie in Eile einen widerrufen müssen, lautet die Frage, die Sie beantworten werden, „auf welchem Rechner ist das“.

Siehe Authentifizierung in der API-Referenz dazu, wie er gesendet wird.

Wenn das Abonnement gekündigt ist​

Die Sperre gilt dem Erstellen, nicht dem Betrieb. Ein gekündigter Workspace behält die Schlüssel, die er schon hat, nichts hält also ein Skript auf, das bereits einen verwendet. Was gestoppt wird, ist das Erstellen neuer, und ein erneutes Abonnieren in jedem Tarif, Free eingeschlossen, öffnet es wieder. Solange er gekündigt ist, sind API-Schlüssel und Eigene Feeds auch nicht im Menü; ein erneutes Abonnieren bringt sie zurück.