01
Invia una richiesta stile OpenAI
Usa l’SDK ufficiale JavaScript o Python, cambia l’URL base e mantieni chat completions.
API personaggi compatibile OpenAI
La tua app invia un messaggio. Un personaggio risponde.
Punta un client OpenAI a Reverie e chiama un personaggio, non un modello generico. Personalità, scenari, cronologia e memoria restano sul server e la stessa chat è visibile sul web.
- Compatibile con OpenAI SDK
- Streaming predefinito
- Cronologia persistente sul server
POST /v1/chat/completions
200 connessoRichiesta TypeScript
const reply = await client.chat
.completions.create({
model: "Luna [abc12345]",
messages: [{
role: "user",
content: "Ricordi l’osservatorio?"
}],
});Risposta del personaggio
streaming{
"role": "assistant",
"content": "Ricordo la promessa che hai fatto lì."
}
memoria salvata · chat web sincronizzata
Una richiesta, l’intero motore dei personaggi
Compatibile in superficie, stateful all’interno.
Mantieni il contratto client noto mentre Reverie gestisce personaggio, contesto, memoria e persistenza.
02
Risolvi personaggio o scenario
Il campo model sceglie personaggio, scenario o il predefinito della chiave.
03
Componi personalità e contesto
Reverie combina definizione, scenario, preferenze, messaggi, riepiloghi e ricordi.
04
Trasmetti e salva la risposta
I frammenti SSE arrivano al client mentre conversazione e ricordi restano disponibili.
Routing per chiave
Continuità sul server
Formato risposta OpenAI
Più di un wrapper di prompt
Infrastruttura dei personaggi, già pronta.
Costruisci il prodotto senza rifare identità e continuità per ogni integrazione.
Definizioni reali
Usa personaggi privati o pubblici con voce, comportamento, esempi e impostazioni intatti.
Cronologia persistente
Il server conserva la chat canonica; di solito basta l’ultimo messaggio.
Memoria a lungo termine
I modelli supportati salvano ricordi e i riepiloghi preservano archi lunghi.
Routing per scenario
Proponi un personaggio in più situazioni iniziali selezionabili.
Una conversazione ovunque
Inizia in un’app, continua su reverie.im o un bot e torna all’API.
Modelli e crediti integrati
Preferenze, taglio token, limiti e crediti seguono le regole Reverie.
Avvio rapido
Dalla chiave al personaggio in tre passaggi.
Nessun nuovo SDK o database di conversazioni per la prima richiesta.
- 01
Crea una chiave limitata
Nomina l’integrazione, fissa se vuoi un personaggio, copia rk_ una volta e conservala sul server.
- 02
Cambia l’URL base
Usa https://reverie.im/api/device/v1 e passa personaggio o scenario in model.
- 03
Invia un messaggio
Ricevi la risposta in streaming; Reverie conserva la conversazione per le chiamate future.
FAQ API personaggi IA
Il contratto è familiare. Lo stato non è generico.
Compatibilità, routing, persistenza e limiti pratici.
Crea con personaggi persistenti
Un’API per app che richiedono continuità
Un prodotto con personaggi richiede identità, scenario, cronologia, memoria e una scelta affidabile di chi parla. Reverie riunisce tutto dietro un endpoint compatibile.
Usa personaggi, non prompt ricostruiti
Migliora le definizioni in Reverie senza distribuire di nuovo ogni app.
Controlla il costo delle chat lunghe
Riepiloghi e budget token preservano lo stato senza una cronologia infinita.
Passa tra prodotti
Una conversazione iniziata altrove resta disponibile sul web Reverie.
Compatibile OpenAI dove serve
Richieste e risposte restano familiari mentre model instrada a personaggio o scenario.
SDK ufficiali
Usa client OpenAI JavaScript e Python e strumenti con URL base personalizzato.
Scopri personaggi validi
L’endpoint models restituisce personaggi recenti o scenari del personaggio predefinito.
Errori prevedibili
Autenticazione, personaggio mancante, limite e quota usano errori standard con codici leggibili.
Un endpoint, un personaggio con un passato
Collega la tua app a qualcuno, non qualcosa.
Crea una chiave, scegli un personaggio e invia la prima richiesta compatibile OpenAI.