Open API

Reverie stellt einen OpenAI-kompatiblen Chat-Completions-Endpunkt bereit. Richte irgendeinen OpenAI-Client darauf, gib einen Reverie-API-Schlüssel mit, und nenne im Feld model eine Figur oder ein Szenario statt eines LLM. Reverie hält Unterhaltung, Erinnerungen und Zusammenfassungen auf seiner Seite, deshalb braucht jede Anfrage nur deine neue Nachricht.

Jedes angemeldete Konto kann ihn nutzen. Es gibt keine Abostufe und keine Warteliste — du brauchst einen API-Schlüssel, mehr nicht. Einen anlegen →

Basis-URL und Authentifizierung

https://www.reverie.im/api/device/v1
Authorization: Bearer rk_...

Einstellungen → Mehr → API-Schlüssel zeigt die genaue Basis-URL in der Karte API Endpoint, mit Kopierknopf.

Schnellstart

curl --no-buffer https://www.reverie.im/api/device/v1/chat/completions \
  -H "Authorization: Bearer $REVERIE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "Luna [abc12345]",
  "messages": [
    {
      "role": "user",
      "content": "Hi"
    }
  ],
  "stream": true,
  "temperature": 0.8
}'

Einstellungen → Mehr → API-Schlüssel hat außerdem einen Anfragen-Baukasten, der diese drei Schnipsel mit einem deiner echten Schlüssel und einer echten Figur erzeugt.

Das Feld model nennt eine Figur

Was darüber entscheidet, ob eine kurze ID aufgelöst wird:

• Das [...] muss am Ende der Zeichenkette stehen.
• Ein Suffix von 8 Zeichen oder weniger wird nur gegen Figuren geprüft, mit denen du bereits einen Chat hast, im Web oder über die API. Die kurze ID einer nie geöffneten Figur läuft stillschweigend ins Leere.
• Die Szenariosuche läuft nur, wenn der Schlüssel an eine Figur geheftet ist. Mit einem globalen Schlüssel kann eine kurze Szenario-ID nie aufgelöst werden.
• Mehr als 8 Zeichen gelten als vollständige ID.

Auflisten, mit wem du reden kannst

curl https://www.reverie.im/api/device/v1/models \
  -H "Authorization: Bearer $REVERIE_API_KEY"

Ein globaler Schlüssel gibt deine letzten Figuren zurück. Ein an eine Figur gehefteter Schlüssel gibt stattdessen die Szenarien dieser Figur zurück, oder die Figur selbst, wenn sie keine hat. Ein Eintrag sieht so aus:

{
	"id": "Luna [abc12345]",
	"object": "model",
	"created": 1759200000,
	"owned_by": "character",
	"permission": [],
	"root": "<full character id>",
	"parent": null
}

Kopier id direkt in model. Fehler dieses Endpunkts nutzen eine schlichte Fehlerform statt der OpenAI-Hülle.

Was vom Anfragekörper gelesen wird

Vier Felder werden gelesen. Alles andere wird angenommen und stillschweigend verworfen.

Ohne Warnung ignoriert: max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

Wie messages behandelt wird:

• system-Nachrichten werden verworfen. Persönlichkeit und Verhalten stammen aus den Feldern der Figur, nicht aus der Anfrage. Prompt-Felder →
• Es gibt keine Bildverarbeitung. Der Inhalt darf ein String oder ein Array von Teilen sein, gelesen werden aber nur text-Teile; Bildteile werden ignoriert.
• Nur die letzte user-Nachricht wird der Unterhaltung hinzugefügt. Frühere Nutzernachrichten werden ignoriert.
• Assistenten-Nachrichten dienen allein dem Abgleich des Verlaufs (siehe unten).
• Eine leere oder nur aus Leerzeichen bestehende letzte Nutzernachricht liefert missing_user_message.

Antworten

Eine Antwort ohne Streaming ist ein gewöhnliches chat.completion-Objekt. finish_reason ist immer stop — interne Werkzeugaufrufe werden nie sichtbar — und die usage-Zähler stehen auf null, miss Tokens also über die Nutzungsstatistik auf der Seite der API-Schlüssel statt über die Antwort.

Eine Streaming-Antwort ist ein text/event-stream:

1. Inhaltsblöcke: chat.completion.chunk-Objekte mit delta.content. Ein einleitender delta: {"role": "assistant"}-Block wird nicht gesendet.
2. Ein Abschlussblock mit finish_reason stop, length oder content_filter. Abschlüsse durch Werkzeugaufrufe werden als stop gemeldet.
3. Ein Nutzungsblock mit leerem choices-Array.
4. data: [DONE].

Scheitert die Generierung mitten im Stream, sendet der Stream data: {"error": {...}} und danach [DONE].

Zustand der Unterhaltung

Reverie speichert die Unterhaltung. Pro Schlüssel-und-Figur-Paar existiert ein Chat, er taucht in der Web-App neben deinen anderen Chats auf, und jeder Zug wird gebaut aus dem System-Prompt und dem Szenario der Figur, dem Kanon aus Weltbüchern, Langzeit-Erinnerungen, laufenden Zusammenfassungen, dem Erzählstil der Figur, Antwortlänge und NSFW-Einstellungen, einer Sprachfestlegung aus der Sprache deines Kontos und so viel jüngerem Verlauf, wie das Kontextfenster des Modells fasst. Erinnerungs-Werkzeuge laufen, wenn das Modell Werkzeuge unterstützt.

Da der Server den Verlauf hält, musst du ihn nicht noch einmal mitschicken.

Welches LLM antwortet

Das entscheidet die Figur, nicht die Anfrage — es sei denn, du nennst ein LLM. Reihenfolge von schwach nach stark: das Standard-Chatmodell, dann die Modelleinstellung der Figur, dann eine als model übergebene Reverie-Modell-ID, und zuletzt die Modellvorliebe, die du in der Web-App für diesen Chat gesetzt hast — sie schlägt alle anderen. Modelle →

Fehler

Fehler von /chat/completions nutzen die OpenAI-Hülle: {"error": {"message", "type", "param": null, "code"}}.

Zwei Fälle fallen aus dieser Hülle heraus: Fehler von GET /models und Anfragekörper, die an der Prüfung scheitern (etwa eine temperature außerhalb des Bereichs) — beide liefern eine schlichte Fehlerform.

Ratenlimits und Kontingente

Diese API hat kein Ratenlimit pro Schlüssel, keine Obergrenze für gleichzeitige Anfragen und kein Anfragekontingent. Nur zwei Dinge begrenzen deine Nutzung:

Das Fenster für kostenlose Modelle teilst du mit dem Web-Chat, Geschichten, Romanen und den Bots — es ist ein Kontingent pro Konto, nicht eines pro Oberfläche. Kostenlose Modelle →

Reverie sendet keine ausgehenden Webhooks; es gibt nichts zu abonnieren, um vom Ende einer Generierung zu erfahren.

Figuren importieren

Ein zweiter Endpunkt, POST /api/v1/characters/import, legt aus einer Figurenkarte eine Figur an. Er verlangt einen Schlüssel mit Import-Berechtigung, und das ist nicht die Art Schlüssel, die die Einstellungsseite anlegt. API-Schlüssel → und Charaktere importieren →

Verwandt

• API-Schlüssel — Schlüssel anlegen, anheften, ablaufen lassen und beobachten
• Modelle — Modell-IDs und Guthaben-Multiplikatoren
• Limits — die übrigen Obergrenzen im Produkt
• Credits — wie Anfragen bepreist werden