API-sleutels
Maak, begrens en beheer sleutels voor de API.
Een API-sleutel authenticeert verzoeken aan de Open API van Reverie. Sleutels staan onder Instellingen → Meer → API-sleutels, waar ook de Labs-tegel Open API naartoe leidt. Elk account kan ze maken — er is geen abonnementsvereiste en geen maximum aan hoeveel je er hebt.
Een sleutel maken
Op ‘Nieuwe API-sleutel maken’ drukken
Op een lege pagina staat op de knop Maak je eerste API-sleutel.
Geef hem een naam
Naam is verplicht, 1–100 tekens. Zo heet de sleutel in de lijst en in de gebruiksstatistieken — ‘Speaker in de woonkamer’, ‘staging worker’.
Globaal of een specifiek personage kiezen
Personagekeuze is een keuze tussen Globaal (alle personages) en Specifiek personage, geen optionele extra. Een specifiek personage wordt het vastgezette personage van de sleutel.
Eventueel een apparaattype en een vervaldatum instellen
Apparaattype is vrije tekst (speaker, phone, iot). Vervaldatum neemt een datum en een tijd; op dat moment stopt de sleutel automatisch met werken.
De sleutel verschijnt meteen als rk_ gevolgd door 64 hexadecimale tekens.
Sleutels blijven opvraagbaar
Het geheim wordt niet maar één keer getoond. Op de kaart van elke sleutel staan API-sleutel tonen, API-sleutel verbergen en API-sleutel kopiëren, op elk moment, zolang de sleutel bestaat.
Omdat het volledige geheim leesbaar blijft in je instellingen, staat toegang tot je account gelijk aan toegang tot de sleutel. Bewaar de sleutel op een server of in een secretmanager, nooit in versiebeheer of in browsercode.
Globale sleutels en vastgezette sleutels
| Globaal (alle personages) | Specifiek personage | |
|---|---|---|
GET /models geeft terug | Je recente personages | De scenario's van dat personage, of het personage zelf als het er geen heeft |
model weggelaten | Valt terug op je meest recente chat | Gebruikt het vastgezette personage |
| Korte scenario-ID's | Worden nooit opgelost | Worden opgelost tegen het vastgezette personage |
Uitschakelen, verwijderen, vervangen
| Actie | Effect | Omkeerbaar |
|---|---|---|
| Schakelaar Actief | Verzoeken met de sleutel worden geweigerd zolang hij uit staat | Ja |
| Verwijderen | De sleutel wordt vernietigd en apps die hem gebruiken verliezen toegang | Nee |
Er is geen aparte actie om in te trekken — uitschakelen en verwijderen zijn de twee opties.
Een sleutel verwijderen kan niet ongedaan worden gemaakt, en de toewijzing verdwijnt mee: het eerdere verkeer van die sleutel verhuist naar een bak Verwijderde sleutels in de gebruiksstatistieken, waar je niet meer kunt zien welke integratie wat heeft uitgegeven. Schakel een sleutel eerst uit als je de geschiedenis misschien nog wilt hebben.
Om te vervangen maak je eerst de nieuwe sleutel, zet je die in gebruik, en schakel je daarna de oude uit of verwijder je hem. Er is geen automatische vervanging en geen respijtperiode na het verlopen — een verlopen sleutel wordt bij het volgende verzoek geweigerd met api_key_expired.
Bereik
Sleutels hebben een bereik (scopes), en het dialoogvenster voor het maken toont dat niet. Een sleutel die je in Instellingen maakt, kan de chat-endpoints aanroepen, en alleen die.
Het endpoint van de personage-importer heeft een ander bereik nodig, en de enige manier om zo'n sleutel te krijgen is door Labs → Skill voor personage-import te openen; daar wordt er een voor je gemaakt met de naam Reverie Character Importer (Skill). Roep je de importer aan met een gewone sleutel uit de instellingen, dan krijg je een 403 terug. Personages importeren →
Gebruiksstatistieken
Het paneel Gebruiksstatistieken op dezelfde pagina toont Verzoeken, Tokens, Credits en Actieve sleutels, gegroepeerd per UTC-dag, met een uitsplitsing per sleutel onder Gebruik per sleutel. Filter op één sleutel of op Alle sleutels, over een periode van 7 tot 90 dagen — standaard 30. Alleen chats die via de API zijn gemaakt, worden meegeteld.
Dit paneel is de enige plek waar uitgaven per sleutel bestaan. Je creditgeschiedenis houdt bij wat elk bericht kostte, maar koppelt een transactie niet aan de sleutel die hem deed, dus gebruik de statistieken hier om integraties te vergelijken.
Een verzoek opbouwen
Verzoek opbouwen opent een generator: kies een van je actieve sleutels, kies een personage of scenario uit de lijst die die sleutel kan zien, typ een bericht, kies streaming en temperatuur, en kopieer dan werkende cURL-, TypeScript- of Python-code.
De sleutel wordt in je browser alleen gebruikt om de lijst met personages te laden. De gegenereerde code leest REVERIE_API_KEY uit de omgeving in plaats van het geheim erin op te nemen.
Limieten
| Limiet | Waarde |
|---|---|
| Sleutels per account | Geen limiet |
| Snelheidslimiet per sleutel | Geen |
| Maximum aan gelijktijdige verzoeken per sleutel | Geen |
| Wat het gebruik echt begrenst | Je creditsaldo, plus het venster van het gratis model |
Gerelateerd
- Open API — endpoints, opbouw van verzoeken en fouten
- Personages importeren — waar de importersleutel voor is
- Reverie Labs — de tegels Open API en importer
- Beveiliging — de overige toegangsinstellingen van je account