API ouverte

Reverie expose un endpoint Chat Completions compatible OpenAI. Pointez n'importe quel client OpenAI dessus, passez une clé API Reverie, et utilisez le champ model pour nommer un personnage ou un scénario plutôt qu'un LLM. Reverie garde la conversation, les souvenirs et les résumés de son côté, si bien que chaque requête n'a besoin que de votre nouveau message.

N'importe quel compte connecté peut l'utiliser. Il n'y a ni palier d'abonnement ni liste d'attente — il vous faut une clé API, et c'est tout. En créer une →

URL de base et authentification

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

Paramètres → Plus → Clés API affiche l'URL de base exacte dans la carte API Endpoint, avec un bouton de copie.

Démarrage rapide

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
}'

Paramètres → Plus → Clés API propose aussi un constructeur de requêtes qui génère ces trois extraits à partir d'une de vos vraies clés et d'un vrai personnage.

Le champ model désigne un personnage

Ce qui décide si un ID court se résout :

• Le [...] doit être à la fin de la chaîne.
• Un suffixe de 8 caractères ou moins n'est comparé qu'aux personnages avec lesquels vous avez déjà une conversation, sur le web ou via l'API. L'ID court d'un personnage jamais ouvert échoue silencieusement.
• La recherche de scénario ne s'exécute que lorsque la clé est épinglée à un personnage. Avec une clé globale, un ID court de scénario ne peut jamais se résoudre.
• Au-delà de 8 caractères, c'est traité comme un ID complet.

Lister ce à quoi vous pouvez parler

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

Une clé globale renvoie vos personnages récents. Une clé épinglée à un personnage renvoie plutôt les scénarios de ce personnage, ou le personnage lui-même s'il n'en a aucun. Chaque entrée ressemble à ceci :

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

Copiez id directement dans model. Les erreurs de cet endpoint utilisent une forme d'erreur simple plutôt que l'enveloppe OpenAI.

Ce que le corps de la requête lit

Quatre champs sont lus. Tout le reste est accepté puis silencieusement écarté.

Ignorés sans avertissement : max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

Comment messages est traité :

• Les messages system sont jetés. La personnalité et le comportement viennent des champs du personnage, pas de la requête. Champs du prompt →
• Il n'y a pas de support de la vision. Le contenu peut être une chaîne ou un tableau de parties, mais seules les parties text sont lues ; les parties image sont ignorées.
• Seul le dernier message user est ajouté à la conversation. Les messages utilisateur précédents sont ignorés.
• Les messages d'assistant ne servent qu'à la synchronisation de l'historique (ci-dessous).
• Un dernier message utilisateur vide ou composé d'espaces renvoie missing_user_message.

Réponses

Une réponse sans streaming est un objet chat.completion classique. finish_reason vaut toujours stop — les appels d'outils internes ne sont jamais exposés — et les compteurs usage sont à zéro : mesurez les tokens depuis les statistiques d'usage de la page des clés API, pas depuis la réponse.

Une réponse en streaming est un text/event-stream :

1. Fragments de contenu : des objets chat.completion.chunk avec delta.content. Aucun fragment initial delta: {"role": "assistant"} n'est envoyé.
2. Un fragment de fin, avec finish_reason valant stop, length ou content_filter. Les fins dues à un appel d'outil sont signalées comme stop.
3. Un fragment d'usage avec un tableau choices vide.
4. data: [DONE].

Si la génération échoue en cours de route, le flux émet data: {"error": {...}} puis [DONE].

État de la conversation

Reverie stocke la conversation. Il existe une conversation par couple clé-personnage, elle apparaît dans l'application web à côté de vos autres conversations, et chaque tour est bâti à partir du prompt système et du scénario du personnage, du canon des livres du monde, des souvenirs de long terme, des résumés successifs, du style de narration du personnage, de la longueur de réponse et des réglages NSFW, d'un verrou de langue tiré de la langue de votre compte, et d'autant d'historique récent que la fenêtre de contexte du modèle peut en contenir. Les outils de mémoire s'exécutent lorsque le modèle gère les outils.

Comme le serveur détient l'historique, vous n'avez pas à le rejouer.

Quel LLM répond

C'est le personnage qui décide, pas la requête — sauf si vous nommez un LLM. Priorité, de la plus faible à la plus forte : le modèle de chat par défaut, puis le réglage de modèle du personnage, puis un ID de modèle Reverie passé dans model, et enfin la préférence de modèle que vous avez fixée pour cette conversation dans l'application web, qui l'emporte sur tout le reste. Modèles →

Erreurs

Les erreurs de /chat/completions utilisent l'enveloppe OpenAI : {"error": {"message", "type", "param": null, "code"}}.

Deux cas sortent de cette enveloppe : les erreurs de GET /models, et les corps de requête rejetés par la validation (une temperature hors plage, par exemple) — les deux renvoient une forme d'erreur simple.

Limites de débit et quotas

Cette API n'a ni limite de débit par clé, ni plafond de concurrence, ni quota de requêtes. Deux choses seulement bornent votre usage :

La fenêtre des modèles gratuits est partagée avec le chat web, les histoires, les romans et les bots — c'est une seule enveloppe par compte, pas une par surface. Modèles gratuits →

Reverie n'envoie aucun webhook sortant ; il n'y a rien à quoi s'abonner pour être prévenu d'une fin de génération.

Importer des personnages

Un second endpoint, POST /api/v1/characters/import, crée un personnage à partir d'une fiche de personnage. Il exige une clé disposant de la portée d'import, qui n'est pas le type de clé créé par la page des réglages. Clés API → et Importer des personnages →

Voir aussi

• Clés API — créer, épingler, faire expirer et surveiller des clés
• Modèles — IDs de modèle et multiplicateurs de crédits
• Limites — les autres plafonds du produit
• Crédits — comment les requêtes sont facturées