API-Schlüssel
Schlüssel für die API anlegen, zuschneiden und verwalten.
Ein API-Schlüssel authentifiziert Anfragen an Reveries Open API. Schlüssel liegen unter Einstellungen → Mehr → API-Schlüssel, wohin auch die Labs-Kachel Open API führt. Jedes Konto darf welche anlegen — keine Stufenanforderung und keine Obergrenze, wie viele du hältst.
Einen Schlüssel anlegen
Auf „Neuen API-Schlüssel erstellen“ drücken
Auf einer leeren Seite steht auf dem Knopf Erstellen Sie Ihren ersten API-Schlüssel.
Benenne ihn
Name ist Pflicht, 1–100 Zeichen. So ist der Schlüssel in der Liste und in den Nutzungsstatistiken beschriftet — „Lautsprecher Wohnzimmer“, „staging worker“.
Global oder eine bestimmte Figur wählen
Charakterauswahl ist eine Entscheidung zwischen Global (Alle Charaktere) und Spezifischer Charakter, kein optionales Extra. Eine bestimmte Figur wird zur angehefteten Figur des Schlüssels.
Optional Gerätetyp und Ablauf setzen
Gerätetyp ist freier Text (speaker, phone, iot). Ablauf nimmt ein Datum und eine Uhrzeit; genau dann hört der Schlüssel von selbst auf zu arbeiten.
Der Schlüssel erscheint sofort als rk_ gefolgt von 64 hexadezimalen Zeichen.
Schlüssel bleiben abrufbar
Das Geheimnis wird nicht nur einmal gezeigt. Auf der Karte jedes Schlüssels stehen API-Schlüssel anzeigen, API-Schlüssel ausblenden und API-Schlüssel kopieren, jederzeit, solange es den Schlüssel gibt.
Weil das vollständige Geheimnis in deinen Einstellungen lesbar bleibt, ist Zugriff auf das Konto gleichbedeutend mit Zugriff auf den Schlüssel. Bewahre ihn auf einem Server oder in einem Secret-Manager auf, nie in der Versionsverwaltung oder im Browser-Code.
Globale und angeheftete Schlüssel
| Global (Alle Charaktere) | Spezifischer Charakter | |
|---|---|---|
GET /models liefert | Deine letzten Figuren | Die Szenarien dieser Figur, oder die Figur selbst, wenn sie keine hat |
model weggelassen | Fällt auf deinen letzten Chat zurück | Nimmt die angeheftete Figur |
| Kurze Szenario-IDs | Werden nie aufgelöst | Werden gegen die angeheftete Figur aufgelöst |
Deaktivieren, löschen, wechseln
| Aktion | Wirkung | Umkehrbar |
|---|---|---|
| Schalter Aktiv | Solange er aus ist, werden Anfragen mit dem Schlüssel abgewiesen | Ja |
| Löschen | Der Schlüssel wird vernichtet, und Anwendungen, die ihn nutzen, verlieren den Zugang | Nein |
Ein eigenes Widerrufen gibt es nicht — deaktivieren und löschen sind die beiden Möglichkeiten.
Das Löschen eines Schlüssels lässt sich nicht rückgängig machen, und es nimmt die Zuordnung mit: sein bisheriger Verkehr wandert in den Topf Gelöschte Schlüssel der Nutzungsstatistik, wo du nicht mehr erkennst, welche Integration was ausgegeben hat. Deaktiviere den Schlüssel zuerst, wenn du den Verlauf vielleicht noch brauchst.
Zum Wechseln legst du den Ersatz an, bringst ihn in Betrieb und deaktivierst oder löschst danach den alten Schlüssel. Es gibt keinen automatischen Wechsel und keine Schonfrist nach dem Ablauf — ein abgelaufener Schlüssel wird bei der nächsten Anfrage mit api_key_expired abgewiesen.
Berechtigungen
Schlüssel tragen Berechtigungen, und der Anlegen-Dialog zeigt sie nicht. Ein in den Einstellungen erzeugter Schlüssel darf die Chat-Endpunkte aufrufen, und nur die.
Der Endpunkt für den Figuren-Import braucht eine andere Berechtigung, und den passenden Schlüssel bekommst du nur, indem du Labs → Character-Importer-Skill öffnest; dort wird einer namens Reverie Character Importer (Skill) für dich angelegt. Rufst du den Import mit einem gewöhnlichen Einstellungs-Schlüssel auf, kommt ein 403 zurück. Charaktere importieren →
Nutzungsstatistiken
Das Feld Nutzungsstatistiken auf derselben Seite nennt Anfragen, Tokens, Credits und Aktive Schlüssel, nach UTC-Tag gebündelt, mit einer Aufschlüsselung je Schlüssel unter Nutzung nach Schlüssel. Filtere nach einem Schlüssel oder nach Alle Schlüssel, über ein Fenster von 7 bis 90 Tagen — standardmäßig 30. Gezählt werden nur Chats, die über die API entstanden sind.
Nur hier existiert die Ausgabe pro Schlüssel. Deine Guthaben-Historie hält fest, was jede Nachricht gekostet hat, benennt aber nicht den Schlüssel dahinter — nutze also diese Statistik, um Integrationen zu vergleichen.
Anfrage erstellen
Anfrage erstellen öffnet einen Generator: wähle einen deiner aktiven Schlüssel, wähle eine Figur oder ein Szenario aus der Liste, die dieser Schlüssel sieht, tippe eine Nachricht, entscheide über Streaming und Temperatur, und kopiere dann lauffähiges cURL, TypeScript oder Python.
Der Schlüssel wird in deinem Browser nur benutzt, um die Figurenliste zu laden. Der erzeugte Code liest REVERIE_API_KEY aus der Umgebung, statt das Geheimnis einzubetten.
Grenzen
| Grenze | Wert |
|---|---|
| Schlüssel pro Konto | Keine Grenze |
| Ratenlimit pro Schlüssel | Keines |
| Obergrenze gleichzeitiger Anfragen pro Schlüssel | Keine |
| Was die Nutzung wirklich begrenzt | Dein Guthabenstand und das Fenster für kostenlose Modelle |
Verwandt
- Open API — Endpunkte, Aufbau der Anfrage und Fehler
- Charaktere importieren — wofür der Import-Schlüssel da ist
- Reverie Labs — die Kacheln Open API und Import
- Sicherheit — die übrigen Zugriffseinstellungen deines Kontos