Обновлено
Приложение для ролевой игры без цензуры: создание через API
API для ИИ-подруги предоставляет специализированный интерфейс для чат-приложений, имитирующих романтическое или компаньонское взаимодействие с помощью больших языковых моделей. Это руководство сравнивает технические подходы, уделяя особое внимание моделям без цензуры, которые обрабатывают контекст ролевой игры без стандартных отказов.

Архитектура на одной картинке
Браузер отправляет сообщение пользователя на ваш сервер. Ваш сервер добавляет персонажа и недавнюю историю, вызывает модель с stream: true и пересылает каждый чанк обратно. Ничего больше не требуется.
- Браузер: текстовое поле и div, который растёт по мере поступления токенов.
- Ваш сервер: хранит API-ключ, формирует список сообщений, применяет ваши собственные лимиты для каждого пользователя.
- API модели:
POST /v1/chat/completionsпо адресуhttps://api.nofilterai.top/v1с модельюuncensored. - Хранение: таблица или файл сообщений для каждого диалога. SQLite достаточно для начала.
Модель представляет собой одну модель с открытыми весами, настроенную на ответы без отказов по контенту для законного использования взрослыми. Она работает только с текстом. Если вам нужна графика персонажей или голос, добавьте другой сервис самостоятельно.
Настройте системный промпт
Для ролевых игр системный промпт делает большую часть работы. Разделите его на три коротких блока, чтобы вы могли заменять каждый из них независимо: мир, персонаж и правила формата.
{
"world": "A rain-soaked port city in 1920s Europe, run by rival smuggling families.",
"character": "Ilse, a sharp-tongued ferry captain who trusts nobody but her brother.",
"format": "Write in third person past tense. 2 to 4 short paragraphs. Never write the user's actions or lines."
}
Объедините их в одно системное сообщение в момент запроса. Сохранение их в отдельности позволяет пользователям независимо выбирать мир и персонажа, что является основной потребностью большинства приложений для ролевых игр. Поскольку взрослая художественная литература разрешена для законного использования взрослыми, укажите это один раз в ваших собственных условиях использования и добавьте проверку возраста. Единственное, что API не будет генерировать, — это сексуальный контент с участием несовершеннолетних, и вашему приложению не следует этого пытаться.
Потоковый бэкенд
Этот маршрут Express принимает идентификатор беседы и сообщение, загружает историю и передает поток браузеру как события SSE. Он использует официальный пакет openai.
import express from "express";
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nofilterai.top/v1",
apiKey: process.env.API_KEY,
});
const app = express();
app.use(express.json());
const store = new Map(); // conversationId -> messages
app.post("/chat", async (req, res) => {
const { id, text, persona } = req.body;
const history = store.get(id) ?? [];
history.push({ role: "user", content: text });
res.setHeader("Content-Type", "text/event-stream");
res.setHeader("Cache-Control", "no-cache");
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "system", content: persona }, ...trim(history)],
stream: true,
temperature: 0.9,
});
let reply = "";
for await (const chunk of stream) {
const piece = chunk.choices[0]?.delta?.content ?? "";
if (piece) {
reply += piece;
res.write("data: " + JSON.stringify(piece) + "\n\n");
}
}
history.push({ role: "assistant", content: reply });
store.set(id, history);
res.write("data: [DONE]\n\n");
res.end();
});
app.listen(3000);
Последний чанк потока содержит данные об использовании, которые вы можете логировать, чтобы видеть стоимость каждой беседы. В продакшене замените Map на базу данных и добавьте обработку ошибок вокруг вызова.
Обрезка истории в рамках 100k окна
Контекстное окно составляет 100 000 токенов для промпта плюс генерация. Сессии ролевых игр растут медленно, но растут. Функция обрезки, работающая по размеру, избегает сюрпризов. Грубая оценка в 4 символа на токен достаточно хороша для планирования бюджета.
function trim(history, maxChars = 120000) {
let total = 0;
const kept = [];
for (let i = history.length - 1; i >= 0; i--) {
total += history[i].content.length;
if (total > maxChars) break;
kept.unshift(history[i]);
}
return kept;
}
120 000 символов — это около 30 000 токенов, что далеко ниже лимита, и это делает каждый вызов дешевым. Увеличьте его только если вашей истории нужна долгая память. Помните о правиле стоимости: каждый ход пересылает сохраненную историю как входные данные по цене $0,15 за 1 млн токенов, поэтому промпт на 30 000 токенов стоит 30 000 / 1 000 000 x $0,15 = $0,0045 за ход до ответа.
Клиент в браузере
Страница читает поток SSE с помощью fetch и добавляет текст по мере поступления. Поскольку запрос является POST, EventSource не подходит, поэтому парсите поток вручную.
async function send(text) {
const out = document.getElementById("reply");
out.textContent = "";
const r = await fetch("/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ id: "demo", text, persona: PERSONA }),
});
const reader = r.body.getReader();
const dec = new TextDecoder();
let buf = "";
while (true) {
const { value, done } = await reader.read();
if (done) break;
buf += dec.decode(value, { stream: true });
const parts = buf.split("\n\n");
buf = parts.pop();
for (const p of parts) {
if (p === "data: [DONE]") break;
if (p.startsWith("data: ")) {
out.textContent += JSON.parse(p.slice(6));
}
}
}
}Функции, делающие приложение похожим на полноценное
- Регенерация и редактирование. Сохраняйте идентификаторы сообщений. Регенерация означает удаление последнего сообщения ассистента и повторный вызов API с той же историей. Редактирование означает переписывание сохраненного сообщения перед следующим вызовом.
- Настройки для каждого персонажа. Храните
temperature,top_pи штрафы вместе с каждым персонажем. Спокойным персонажам подходит 0,7, хаотичным — 1,0. Передавайтеseed, когда хотите воспроизводимые тестовые запуски. - Отображение стоимости. Прочитайте заголовок ответа
X-Balance-USDили вызовитеGET /v1/balanceи покажите пользователю, сколько предоплаченного баланса осталось. Если вы перепродаете доступ своим пользователям, это сэкономит вам массу вопросов в поддержку. - Ваши собственные механизмы безопасности. Добавьте возрастное ограничение, кнопку жалобы и правило, блокирующее любой запрос с участием несовершеннолетних до того, как он достигнет API. Платформа также применяет этот лимит, но ваше приложение тоже должно.
Ограничения, ошибки и бюджеты
Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту. Запрос с потоковой передачей занимает слот параллельности до конца потока, поэтому приложение для ролевых игр с 20 активными пользователями достигнет предела в загруженные минуты. API отвечает HTTP 429 с кодом concurrency или rate_limited, а при временной перегрузке добавляет Retry-After: 5. Ставьте запросы в очередь на своём сервере и повторяйте их после этой задержки.
Неудачные или отклоненные запросы не оплачиваются, поэтому повторные попытки не стоят вам денег. Для планирования бюджета: типичный ход из 3 000 входных токенов и 300 выходных токенов стоит $0,00045 + $0,00015 = $0,0006. Кредит предоплачивается от $20 и не сгорает. Этот сайт принимает криптовалюту, USDT на TRC20 или USDC на Base; на странице цен указаны бонусы от $50 и выше.
Куда двигаться дальше
Получите ключ и протестируйте с бесплатным пробным балансом: на странице API-ключа предлагается $0,50 кредита после входа, действительный в течение 7 дней, без указания платежных данных. Пробный ключ позволяет 2 параллельных запроса, чего достаточно для прототипа для одного пользователя. В документации перечислены все параметры, включая вызов функций, если вы хотите, чтобы броски кубиков или инвентарь обрабатывались как вызовы функций.
Для варианта в стиле компаньона с одним постоянным персонажем см. статью API для AI-компаньонов. Для чат-бота внутри сервера прочитайте руководство по Discord-ботам.
Дополнительные руководства
Вопросы и ответы
Можно ли обращаться к API напрямую из браузера?
Можно, но тогда ваш ключ будет доступен всем посетителям. Храните ключ на сервере и открывайте только свой эндпоинт.
Как запретить модели описывать действия моего персонажа?
Укажите это в системном промпте и, если используете формат транскрипта, добавьте стоп-последовательность. Оба варианта работают с параметрами прокси.
Нужно ли приложению сохранять разговоры?
Сам API не сохраняет состояние, поэтому вы отправляете историю каждый ход. Промпты не используются для обучения.
Какой самый дешевый способ создать прототип?
Используйте пробный ключ и Map в памяти. Переходите к базе данных и ключу с балансом, когда цикл заработает.
Ваш ключ — всего в одной форме
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.
Получить API-ключ