API abierta

Reverie expone un endpoint de Chat Completions compatible con OpenAI. Apunta cualquier cliente de OpenAI hacia él, pásale una clave API de Reverie y usa el campo model para nombrar un personaje o escenario en lugar de un LLM. Reverie guarda la conversación, las memorias y los resúmenes de su lado, así que cada petición solo necesita tu mensaje nuevo.

Cualquier cuenta con sesión iniciada puede usarlo. No hay nivel de suscripción ni lista de espera: solo necesitas una clave API, y ya está. Crear una →

URL base y autenticación

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

Ajustes → Más → Claves API muestra la URL base exacta en la tarjeta API Endpoint, con un botón para copiarla.

Inicio rápido

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

Ajustes → Más → Claves API también tiene un constructor de peticiones que genera estos tres fragmentos con una de tus claves reales y un personaje real.

El campo model nombra un personaje

Detalles que deciden si un ID corto se resuelve:

• El [...] tiene que ir al final de la cadena.
• Un sufijo de 8 caracteres o menos solo se compara con personajes con los que ya tienes un chat, en la web o por la API. El ID corto de un personaje que nunca has abierto falla en silencio.
• La búsqueda de escenarios solo se ejecuta cuando la clave está fijada a un personaje. Con una clave global, un ID corto de escenario no puede resolverse nunca.
• Más de 8 caracteres se trata como un ID completo.

Ver con qué puedes hablar

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

Una clave global devuelve tus personajes recientes. Una clave fijada a un personaje devuelve los escenarios de ese personaje, o el propio personaje si no tiene ninguno. Cada entrada se ve así:

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

Copia id tal cual en model. Los errores de este endpoint usan una forma de error simple, no el envoltorio de OpenAI.

Qué lee el cuerpo de la petición

Se leen cuatro campos. Todo lo demás se acepta y se descarta en silencio.

Se ignoran sin avisar: max_tokens, top_p, n, stop, presence_penalty, frequency_penalty, logit_bias, seed, user, response_format, tools, tool_choice, logprobs, stream_options.

Cómo se trata messages:

• Los mensajes system se descartan. La personalidad y el comportamiento vienen de los campos del propio personaje, no de la petición. Campos del prompt →
• No hay soporte de visión. El contenido puede ser una cadena o un array de partes, pero solo se leen las partes text; las partes de imagen se ignoran.
• Solo se añade a la conversación el último mensaje user. Los mensajes de usuario anteriores se ignoran.
• Los mensajes de asistente solo se usan para sincronizar el historial (abajo).
• Un último mensaje de usuario vacío o con solo espacios devuelve missing_user_message.

Respuestas

Una respuesta sin streaming es un objeto chat.completion normal. finish_reason es siempre stop —las llamadas internas a herramientas nunca se exponen— y los contadores de usage están a cero, así que mide los tokens con las estadísticas de uso de la página de claves API y no con la respuesta.

Una respuesta en streaming es text/event-stream:

1. Fragmentos de contenido: objetos chat.completion.chunk con delta.content. No se envía un fragmento inicial delta: {"role": "assistant"}.
2. Un fragmento de cierre, con finish_reason igual a stop, length o content_filter. Los cierres por llamada a herramienta se reportan como stop.
3. Un fragmento de uso con el array choices vacío.
4. data: [DONE].

Si la generación falla a mitad del stream, el stream emite data: {"error": {...}} y luego [DONE].

Estado de la conversación

Reverie guarda la conversación. Existe un chat por cada par de clave y personaje, aparece en la aplicación web junto a tus otros chats, y cada turno se construye con el prompt de sistema y el escenario del personaje, el canon de los libros del mundo, las memorias a largo plazo, los resúmenes que se van acumulando, el estilo de narración del personaje, la longitud de respuesta y los ajustes NSFW, un bloqueo de idioma tomado del idioma de tu cuenta, y todo el historial reciente que quepa en la ventana de contexto del modelo. Las herramientas de memoria se ejecutan cuando el modelo admite herramientas.

Como el servidor guarda el historial, no hace falta que lo vuelvas a enviar.

Qué LLM responde

Lo decide el personaje, no la petición, salvo que nombres un LLM. Precedencia, de menor a mayor: el modelo de chat por defecto, luego el ajuste de modelo del propio personaje, luego un ID de modelo de Reverie pasado como model, y por último la preferencia de modelo que fijaste para ese chat en la aplicación web, que gana a todas. Modelos →

Errores

Los errores de /chat/completions usan el envoltorio de OpenAI: {"error": {"message", "type", "param": null, "code"}}.

Dos casos quedan fuera de ese envoltorio: los errores de GET /models y los cuerpos de petición rechazados por la validación (una temperature fuera de rango, por ejemplo). Ambos devuelven una forma de error simple.

Límites de uso y cuotas

Esta API no tiene límite de peticiones por clave, ni tope de concurrencia, ni cuota de peticiones. Solo dos cosas acotan tu uso:

La ventana de modelos gratuitos se comparte con el chat web, las historias, las novelas y los bots: es una asignación por cuenta, no una por sitio. Modelos gratuitos →

Reverie no envía webhooks salientes; no hay nada a lo que suscribirse para recibir avisos de finalización.

Importar personajes

Un segundo endpoint, POST /api/v1/characters/import, crea un personaje a partir de una ficha de personaje. Necesita una clave con permiso de importación, que no es el tipo de clave que crea la página de ajustes. Claves API → e Importar personajes →

Relacionado

• Claves API — crear, fijar, caducar y vigilar claves
• Modelos — IDs de modelo y multiplicadores de créditos
• Límites — los demás topes del producto
• Créditos — cómo se cobran las peticiones