Как реализовать чат-бота на сайте: пошаговое руководство
Внедрение чат-бота на сайт сводится к трём частям: чат-виджет в браузере, небольшой бэкенд, хранящий ваш API-ключ, и вызов эндпоинта, совместимого с OpenAI. Это руководство создает каждую часть с рабочим кодом.
Обновлено

Ключевые моменты
- Никогда не вызывайте API из кода браузера. Храните ключ на сервере и откройте свой маршрут /api/chat.
- API совместим с OpenAI, поэтому стандартные SDK работают после установки базового URL и использования модели uncensored.
- Используйте потоковую передачу ответов, чтобы страница казалась быстрой, и ограничьте историю на сервере.
- Обрабатывайте ответы 429 и устанавливайте лимит на посетителя, так как полный ключ позволяет 8 параллельных запросов.
Архитектура на одной картинке
Обычная схема чат-бота на сайте — трёхэтапная ретрансляция. Посетитель вводит сообщение в чат. Ваша страница отправляет сообщение на ваш собственный сервер. Ваш сервер вызывает API модели с вашим секретным ключом и передает ответ обратно. Браузер никогда не видит ключ.
Это важно, потому что все во фронтенд-JavaScript является общедоступным. Если вы поместите ключ в тег script, любой, кто откроет инструменты разработчика, сможет скопировать его и потратить ваш баланс. Маршрут бэкенда также дает вам одно место для добавления лимитов запросов, обрезки истории, ведения журнала и проверки возраста. Для более подробного обзора готовой страницы см. руководство по веб-чату.
Шаг 1: получите ключ и проверьте эндпоинт
Зарегистрируйтесь через Google или с помощью электронной почты и пароля, затем получите бесплатный пробный баланс на странице API-ключей. Пробный баланс составляет $0,50, действителен в течение 7 дней, один на человека, и не требует оплаты. Сохраните ключ как переменную окружения, а не в коде.
Проверьте работоспособность с помощью curl перед написанием кода приложения:
export API_KEY="YOUR_KEY"
curl https://api.uncensoredchatbotapi.com/v1/models -H "Authorization: Bearer $API_KEY"
curl https://api.uncensoredchatbotapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello in five words."}]}'Первый вызов перечисляет модели, а второй возвращает завершение чата. Если оба успешны, ключ и базовый URL верны. Ошибка 401 означает, что ключ неверен или отсутствует префикс Bearer.
Шаг 2: напишите маршрут бэкенда
Пример ниже использует Node 18 или новее, Express и официальный пакет openai. Установите их с помощью npm install express openai и установите "type": "module" в package.json.
import express from "express";
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredchatbotapi.com/v1",
apiKey: process.env.API_KEY,
});
const SYSTEM = "You are a helpful assistant for our website. Keep answers under 150 words.";
const app = express();
app.use(express.json({ limit: "100kb" }));
app.use(express.static("public"));
app.post("/api/chat", async (req, res) => {
const incoming = Array.isArray(req.body.messages) ? req.body.messages : [];
const history = incoming.slice(-10).map((m) => ({
role: m.role === "assistant" ? "assistant" : "user",
content: String(m.content).slice(0, 4000),
}));
try {
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "system", content: SYSTEM }, ...history],
stream: true,
});
res.setHeader("Content-Type", "text/plain; charset=utf-8");
for await (const chunk of stream) {
const text = chunk.choices[0]?.delta?.content;
if (text) res.write(text);
}
} catch (err) {
if (res.headersSent === false) res.status(err.status === 429 ? 429 : 502);
}
res.end();
});
app.listen(3000, () => console.log("Listening on http://localhost:3000"));Три детали выполняют реальную работу здесь. Сервер самостоятельно перестраивает список сообщений, поэтому посетитель не может внедрить поддельное системное сообщение. Он хранит только последние 10 сообщений и обрезает каждое до 4 000 символов, что контролирует расходы. И он всегда явно устанавливает роли, сопоставляя всё неизвестное с user.
Шаг 3: создайте чат-виджет
Поместите это в public/index.html. Он использует чистый JavaScript без фреймворков, поэтому вы можете вставить его в существующий шаблон.
<div id="log"></div>
<form id="form">
<input id="input" autocomplete="off" required />
<button>Send</button>
</form>
<script>
const messages = [];
const log = document.getElementById("log");
document.getElementById("form").addEventListener("submit", async (e) => {
e.preventDefault();
const input = document.getElementById("input");
messages.push({ role: "user", content: input.value });
log.insertAdjacentHTML("beforeend", "<p></p>");
log.lastElementChild.textContent = "You: " + input.value;
input.value = "";
const reply = document.createElement("p");
log.appendChild(reply);
const res = await fetch("/api/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ messages }),
});
if (res.ok === false) { reply.textContent = "Busy, please try again in a moment."; return; }
const reader = res.body.getReader();
const decoder = new TextDecoder();
let full = "";
while (true) {
const { done, value } = await reader.read();
if (done) break;
full += decoder.decode(value, { stream: true });
reply.textContent = full;
}
messages.push({ role: "assistant", content: full });
});
</script>Использование textContent вместо innerHTML для вывода модели предотвращает внедрение разметки ответом в вашу страницу. Сохраняйте эту привычку, даже если модель ведет себя хорошо.
Шаг 4: обработка ограничений и ошибок
Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту. Пробный ключ позволяет 2 параллельных и 60 в минуту. Когда вы превысите лимит, API вернет HTTP 429 с кодом ошибки: rate_limited для запросов в минуту или concurrency для слишком многих одновременно. При временной перегрузке он также возвращает 429 с заголовком Retry-After: 5.
Следуют два практических правила. Во-первых, повторите запрос 429 после задержки с небольшим увеличением интервала и покажите посетителю дружелюбное сообщение, если ошибка повторяется. Во-вторых, помните, что потоковый запрос удерживает слот параллельных запросов до завершения потока. Если десять посетителей одновременно отправляют потоковые запросы с полным ключом, двое из них будут отклонены, поэтому добавьте небольшую очередь или ограничение на посетителя на вашем сервере. Простого счетчика в памяти с ключом по IP достаточно для небольшого сайта.
Заголовки ответа помогают вам отлаживать: X-Request-Id идентифицирует вызов, если вы обратитесь в поддержку, а X-Balance-USD показывает ваш оставшийся кредит. Лимит тела запроса составляет 8 МБ, что значительно выше того, что нужно для чата, а контекстное окно составляет 100 000 токенов.
Подводные камни при развертывании
Приведенный выше код работает на localhost. Это проблемы, которые возникают, когда он находится на реальном сервере.
- Прокси с буферизацией. Некоторые обратные прокси удерживают потоковые ответы до их завершения, поэтому ответ появляется сразу целиком. Если вы используете nginx, отключите буферизацию ответов для маршрута чата. Тестируйте потоковую передачу через ту же цепочку прокси, что и в продакшене, а не только на ноутбуке.
- Ключи в репозитории. Храните ключ в переменной окружения или хранилище секретов и добавьте любой локальный файл env в список игнорируемых. Если ключ когда-либо попадет в публичный репозиторий, создайте новый и прекратите использовать старый.
- Доверие клиенту. Браузер отправляет историю чата, поэтому посетитель может ее отредактировать. Именно поэтому сервер на шаге 2 сам устанавливает роли и обрезает длину сообщения. Никогда не принимайте системное сообщение от клиента.
- Междоменные запросы. Если ваша страница и бэкенд находятся на разных доменах, браузер заблокирует запрос, пока ваш сервер не отправит правильные CORS-заголовки. Размещение обоих на одном источнике (origin) решает эту проблему.
- Неконтролируемые расходы. Один скриптовый посетитель может отправить сотни сообщений. Подсчитывайте запросы по IP или сессии на сервере и отказывайте, когда количество слишком велико. Также ограничивайте длину сообщения, как в примере.
- Markdown и ссылки. Модели часто отвечают списками и блоками кода. Решите, будете ли вы их рендерить или показывать обычный текст, и никогда не вставляйте текст ответа как необработанный HTML.
Последняя проверка — мобильный макет. Большая часть трафика чатов на публичных сайтах поступает с телефонов, поэтому тестируйте с узким экраном, открытой программной клавиатурой и нестабильным соединением. Если поток прерывается на полпути, посетитель должен иметь возможность отправить сообщение повторно, не теряя нить разговора.
Расширение бота в будущем
Как только базовая ретрансляция заработает, тот же маршрут может делать больше, так как API поддерживает стандартные функции OpenAI. Вы можете запросить структурированный вывод с помощью JSON-режима, установив response_format в {"type": "json_object"} и указав в промпте, что ответ должен быть JSON. Это подходит для формы лидов, которая превращает сообщение с произвольным текстом в поля, такие как имя, тема и срочность.
Вызов функций позволяет модели запросить у вашего сервера запуск функции, например, поиск заказа или проверка времени работы. Вы передаете список tools, читаете tool_calls в ответе, запускаете функцию самостоятельно и отправляете результат обратно как сообщение с role: "tool". Модель затем пишет окончательный ответ на основе ваших данных. Вот как бот на сайте получает реальную информацию, а не гадает.
Параметры сэмплирования также доступны вам. Более низкая температура подходит для справочных служб с фактами, а более высокая — для рассказов. Вносите одно изменение за раз и сравнивайте результаты на тех же пяти тестовых вопросах.
Шаг 5: настройте бота и запустите
Системный промпт определяет вашего бота. Скажите ему, кто он, что он покрывает и насколько длинными должны быть ответы. Если у персонажа есть личность, заметки о дизайне персоны раскрывают это глубже. Поскольку модель настроена отвечать без отказов по контенту для законного использования взрослыми, защитные меры для вашей аудитории — это то, что вы пишете сами: подтверждение возраста, ссылка на отчет и четкий список того, что бот обсуждать не будет. Сексуальный контент с участием несовершеннолетних никогда не разрешен. См. страницу о ответственном использовании и мерах защиты перед запуском.
Что касается стоимости, вы платите $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов. Ответ с 1200 входными токенами и 300 выходными токенами стоит $0,00018 плюс $0,00015, что составляет $0,00033. Пополнение на $20 покрывает более 60 000 таких ответов. Пополнения варьируются от $20 до $500, с +5% от $50, +10% от $100 и +15% от $200, оплачиваемые в USDT по сети TRC20 или USDC на сети Base. Баланс не сгорает. Страница цен содержит детали, а документация перечисляет каждый поддерживаемый параметр, включая вызов функций и JSON-режим.
Перед запуском протестируйте с несколькими длинными разговорами, наблюдайте за журналами на наличие 429 и подтвердите, что ваш сервер обрезает историю. Промпты не используются для обучения, но вы все равно должны сообщить своим посетителям, что вы храните.
Дополнительные руководства
Вопросы и ответы
Можно ли вызывать API напрямую из JavaScript в браузере?
Можно, но не стоит. Ключ будет виден всем посетителям. Направляйте запросы через свой сервер и храните ключ в переменной окружения.
Какие языки и SDK поддерживаются?
Любой SDK OpenAI или HTTP-клиент. Установите базовый URL в https://api.uncensoredchatbotapi.com/v1, используйте ключ как Bearer-токен и укажите модель uncensored. Python, Node и curl все работают.
Работает ли потоковая передача в браузере?
Да. API использует потоковую передачу через SSE при установке stream в true. В примере текст передается через ваш сервер с помощью fetch и reader потока.
Что происходит при достижении лимита запросов?
Вы получите HTTP 429 с кодом rate_limited или concurrency. Подождите и повторите запрос. При временной перегрузке заголовок Retry-After равен 5 секундам.
Ваш ключ — всего в одной форме
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.