# API-Schlüssel

> Schlüssel für die API anlegen, zuschneiden und verwalten.

Source: https://reverie.im/de/docs/integrations/api-keys
Language: de

Ein API-Schlüssel authentifiziert Anfragen an Reveries [Open API](https://reverie.im/de/docs/integrations/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 \[#create-a-key]

### Auf „Neuen API-Schlüssel erstellen“ drücken \[#press-create-new-api-key]

Auf einer leeren Seite steht auf dem Knopf **Erstellen Sie Ihren ersten API-Schlüssel**.

### Benenne ihn \[#name-it]

**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 \[#choose-global-or-a-specific-character]

**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 \[#optionally-set-a-device-type-and-an-expiry]

**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 \[#keys-stay-retrievable]

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-keys-and-pinned-keys]

|                       | **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 \[#disable-delete-rotate]

| 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 \[#scopes]

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 →](https://reverie.im/de/docs/characters/import-characters)

## Nutzungsstatistiken \[#usage-statistics]

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 \[#build-a-request]

**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 \[#limits]

| 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 \[#related]

* [Open API](https://reverie.im/de/docs/integrations/open-api) — Endpunkte, Aufbau der Anfrage und Fehler
* [Charaktere importieren](https://reverie.im/de/docs/characters/import-characters) — wofür der Import-Schlüssel da ist
* [Reverie Labs](https://reverie.im/de/docs/integrations/labs) — die Kacheln Open API und Import
* [Sicherheit](https://reverie.im/de/docs/account/security) — die übrigen Zugriffseinstellungen deines Kontos