01
Надішли запит у стилі OpenAI
Використовуй офіційний SDK для JavaScript або Python, зміни базовий URL і залиш звичну структуру chat completions.
Спрямуй клієнт OpenAI на Reverie й викликай персонажа замість звичайної моделі. Характер, сценарії, історія та довготривала пам'ять зберігаються на сервері — а та сама розмова залишається доступною на сайті.
Запит на TypeScript
const reply = await client.chat
.completions.create({
model: "Luna [abc12345]",
messages: [{
role: "user",
content: "Ти пам'ятаєш обсерваторію?"
}],
});Відповідь персонажа
стримінг{
"role": "assistant",
"content": "Я пам'ятаю обіцянку, яку ти там дав."
}
Один запит — увесь рушій персонажа
Зберігай звичний клієнтський контракт, а Reverie подбає про вибір персонажа, контекст, пам'ять і збереження даних.
Використовуй офіційний SDK для JavaScript або Python, зміни базовий URL і залиш звичну структуру chat completions.
Поле model вибирає персонажа, сценарій або персонажа за замовчуванням, закріпленого за API-ключем.
Reverie поєднує опис персонажа, поточний сценарій, налаштування, останні повідомлення, підсумки та доречні записи пам'яті.
SSE-фрагменти у форматі OpenAI надходять до клієнта, а розмова й нові записи пам'яті лишаються доступними на кожній платформі.
Більше, ніж обгортка над промптом
Будуй продукт навколо досвіду з персонажем, а не відтворюй особистість і безперервність для кожної інтеграції.
Викликай власних приватних персонажів або публічних персонажів спільноти з їхнім голосом, поведінкою, прикладами та налаштуваннями автора.
Сервер зберігає канонічний чат, тож більшості інтеграцій достатньо надіслати останнє повідомлення користувача, а не всю стенограму.
Сумісні моделі можуть зберігати, оновлювати й видаляти тривалі записи пам'яті, а поступові підсумки зберігають довші сюжетні арки.
Покажи одного персонажа в кількох стартових ситуаціях, а клієнти, що розуміють моделі, можуть подавати сценарії як варіанти на вибір.
Почни в застосунку, продовж на reverie.im, перейди до бота й повернися до API — без розрізнених копій.
Вибір моделі для кожного чату, обрізання токенів, ліміти запитів і облік кредитів працюють за тими самими правилами, що й на сайті Reverie.
Швидкий старт
Для першого запиту не потрібні ні новий SDK, ні власна база даних розмов.
Назви інтеграцію, за бажанням закріпи персонажа за замовчуванням, скопіюй ключ rk_ (він показується один раз) і зберігай його на своєму сервері.
Використовуй клієнт OpenAI з https://reverie.im/api/device/v1 і передавай персонажа чи сценарій через поле model.
Отримуй відповідь потоком одразу. Reverie визначає персонажа й переносить розмову в наступні виклики.
Питання про API AI-персонажів
Сумісність, маршрутизація персонажів, збереження даних і практичні обмеження API.
Створюй із постійними персонажами
Звичайний chat completion повертає текст. Продукту з персонажами потрібні ще особистість, стан сценарію, історія, пам'ять і надійний спосіб визначити, хто говорить. Reverie тримає всі ці шари за одним сумісним ендпоінтом.
Описи персонажів зберігаються в Reverie, і їх можна покращувати без повторного розгортання кожного застосунку, що їх викликає.
Поступові підсумки й обрізання за бюджетом токенів зберігають корисний стан, і клієнту не треба щоразу надсилати дедалі більший масив повідомлень.
Розмова, розпочата у твоєму власному інтерфейсі, залишається доступною у веб-інтерфейсі Reverie, а не замикається в ізольованій інтеграції.
Структура запитів і відповідей залишається знайомою, а поле model свідомо спрямовує до персонажа чи сценарію. Так зберігається сумісність із SDK, і ніхто не вдає, що персонаж — це лише назва моделі.
Використовуй стандартні клієнти OpenAI для JavaScript і Python, парсери стримінгу та інструменти, що дозволяють указати власний базовий URL.
Ендпоінт models повертає нещодавніх персонажів або сценарії персонажа за замовчуванням для ключа у зручному для клієнта форматі.
Помилки автентифікації, відсутнього персонажа, ліміту запитів і квоти повертаються у стандартному форматі помилки з конкретними машинозчитуваними кодами.
Обери наступний крок для своїх персонажів, розмов чи історій.
Один ендпоінт — персонаж із минулим
Створи ключ, вибери персонажа й надішли перший запит, сумісний з OpenAI.