Open API

Reverie biedt een OpenAI-compatibel Chat Completions-endpoint. Richt een willekeurige OpenAI-client erop, geef een Reverie-API-sleutel mee en gebruik het veld model om een personage of scenario te noemen in plaats van een LLM. Reverie bewaart het gesprek, de herinneringen en de samenvattingen aan zijn kant, dus elk verzoek heeft alleen je nieuwe bericht nodig.

Elk ingelogd account kan het gebruiken. Er is geen abonnementsniveau en geen wachtlijst — je hebt een API-sleutel nodig, en dat is alles. Maak er een →

Basis-URL en authenticatie

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

Instellingen → Meer → API-sleutels toont de exacte basis-URL in de kaart API-endpoint, met een kopieerknop.

Snel aan de slag

curl --no-buffer https://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
}'

Instellingen → Meer → API-sleutels heeft ook een verzoekbouwer die deze drie fragmenten genereert met een van je echte sleutels en een echt personage.

Het veld model noemt een personage

Details die bepalen of een korte ID wordt opgelost:

• De [...] moet aan het einde van de string staan.
• Een achtervoegsel van 8 tekens of minder wordt alleen vergeleken met personages waarmee je al een chat hebt, op het web of via de API. Een korte ID voor een personage dat je nooit hebt geopend, valt stilletjes door.
• Scenario's worden alleen opgezocht als de sleutel aan een personage is vastgezet. Met een globale sleutel kan een korte scenario-ID nooit worden opgelost.
• Meer dan 8 tekens wordt behandeld als een volledige ID.

Opvragen met wie je kunt praten

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

Een globale sleutel geeft je recente personages terug. Een sleutel die aan een personage is vastgezet, geeft in plaats daarvan de scenario's van dat personage terug, of het personage zelf als het er geen heeft. Elk item ziet er zo uit:

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

Kopieer id direct naar model. Fouten van dit endpoint gebruiken een eenvoudige foutvorm in plaats van de OpenAI-envelop.

Wat er uit de request body wordt gelezen

Er worden vier velden gelezen. Al het andere wordt geaccepteerd en stilletjes genegeerd.

Zonder waarschuwing genegeerd: max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

Hoe messages wordt verwerkt:

• system-berichten worden weggegooid. Persona en gedrag komen uit de eigen velden van het personage, niet uit het verzoek. Promptvelden →
• Er is geen ondersteuning voor beeldinvoer. De inhoud mag een string of een array met onderdelen zijn, maar alleen text-onderdelen worden gelezen; afbeeldingsonderdelen worden genegeerd.
• Alleen het laatste user-bericht wordt aan het gesprek toegevoegd. Eerdere gebruikersberichten worden genegeerd.
• Assistant-berichten worden alleen gebruikt om de geschiedenis te synchroniseren (zie hieronder).
• Een leeg laatste gebruikersbericht, of een dat alleen uit witruimte bestaat, geeft missing_user_message.

Antwoorden

Een antwoord zonder streaming is een normaal chat.completion-object. finish_reason is altijd stop — interne toolaanroepen worden nooit getoond — en de usage-tellers staan op nul, dus meet tokens via de gebruiksstatistieken op de pagina met API-sleutels in plaats van via het antwoord.

Een streamingantwoord is text/event-stream:

1. Inhoudschunks: chat.completion.chunk-objecten met delta.content. Er wordt geen eerste chunk delta: {"role": "assistant"} verstuurd.
2. Een afsluitende chunk, met finish_reason stop, length of content_filter. Afsluitingen door toolaanroepen worden gemeld als stop.
3. Een usage-chunk met een lege choices-array.
4. data: [DONE].

Mislukt het genereren halverwege de stream, dan stuurt de stream data: {"error": {...}} en daarna [DONE].

Gespreksstatus

Reverie slaat het gesprek op. Er bestaat één chat per combinatie van sleutel en personage, die verschijnt in de webapp naast je andere chats, en elke beurt wordt opgebouwd uit de systeemprompt en het scenario van het personage, canon uit wereldboeken, langetermijnherinneringen, doorlopende samenvattingen, de vertelstijl van het personage, de antwoordlengte en NSFW-instellingen, een taalvergrendeling op basis van de taal van je account, en zoveel van de recente geschiedenis als het contextvenster van het model toelaat. Geheugentools draaien als het model tools ondersteunt.

Omdat de server de geschiedenis bewaart, hoef je die niet opnieuw mee te sturen.

Welk LLM antwoordt

Het personage beslist, niet het verzoek — tenzij je een LLM noemt. Rangorde, van laag naar hoog: het standaard chatmodel, dan de eigen modelinstelling van het personage, dan een Reverie-model-ID die je als model meegeeft, en tot slot de modelvoorkeur per chat die je in de webapp hebt ingesteld, die van alle andere wint. Modellen →

Fouten

Fouten van /chat/completions gebruiken de OpenAI-envelop: {"error": {"message", "type", "param": null, "code"}}.

Twee gevallen vallen buiten die envelop: fouten van GET /models, en request bodies die bij de validatie worden geweigerd (bijvoorbeeld een temperature buiten het bereik) — beide geven een eenvoudige foutvorm terug.

Snelheidslimieten en quota

Deze API heeft geen snelheidslimiet per sleutel, geen maximum aan gelijktijdige verzoeken en geen quotum voor verzoeken. Twee dingen begrenzen je gebruik:

Het venster van het gratis model deel je met de webchat, verhalen, romans en de bots — het is één tegoed per account, niet één per onderdeel. Gratis modellen →

Reverie stuurt geen uitgaande webhooks; er is niets waarop je je kunt abonneren voor afrondingsgebeurtenissen.

Personages importeren

Een tweede endpoint, POST /api/v1/characters/import, maakt een personage aan op basis van een personagekaart. Daarvoor is een sleutel met het importbereik nodig, en dat is niet het soort sleutel dat de instellingenpagina aanmaakt. API-sleutels → en Personages importeren →

Gerelateerd

• API-sleutels — sleutels maken, vastzetten, laten verlopen en volgen
• Modellen — model-ID's en creditvermenigvuldigers
• Limieten — de andere grenzen in het product
• Credits — hoe verzoeken worden geprijsd