VI ▾
Uncensored Chatbot APITruy cập API trực tiếp vào một LLM không kiểm duyệtLấy khóa API

Uncensored Chatbot APIAn toàn

Cách triển khai chatbot trên website từng bước

Học cách triển khai chatbot trong các dự án web bao gồm ba phần chính: hộp chat trên trình duyệt, backend nhỏ lưu giữ khóa API của bạn và lệnh gọi đến endpoint tương thích OpenAI. Hướng dẫn này xây dựng từng phần với mã nguồn hoạt động.

Cập nhật

Bong bóng chat trên trình duyệt được kết nối qua máy chủ giữ khóa với API đám mây, minh họa cách thêm chatbot vào website

Điểm chính

  • Không bao giờ gọi API từ mã trình duyệt. Hãy giữ khóa trên máy chủ và công khai route /api/chat của riêng bạn.
  • API tương thích OpenAI, nên các SDK tiêu chuẩn hoạt động sau khi bạn đặt base URL và sử dụng mô hình uncensored.
  • Truyền phát phản hồi để trang web tải nhanh hơn và giới hạn lịch sử trên máy chủ.
  • Xử lý phản hồi 429 và đặt giới hạn cho mỗi khách truy cập, vì khóa đầy đủ cho phép 8 yêu cầu đồng thời.

Kiến trúc trong một hình ảnh

Cách thông thường để triển khai chatbot trong các dự án web là quy trình chuyển tiếp ba bước. Khách truy cập nhập vào hộp chat. Trang của bạn gửi tin nhắn đến máy chủ của bạn. Máy chủ gọi API mô hình với khóa bí mật của bạn và chuyển lại câu trả lời. Trình duyệt không bao giờ thấy khóa.

Điều này quan trọng vì mọi thứ trong JavaScript front-end đều là công khai. Nếu bạn đặt khóa trong thẻ script, bất kỳ ai mở công cụ nhà phát triển đều có thể sao chép nó và tiêu tốn số dư của bạn. Route backend cũng cung cấp một nơi để thêm giới hạn tốc độ, cắt lịch sử, ghi log và bộ lọc độ tuổi. Để xem hướng dẫn chi tiết hơn về một trang hoàn chỉnh, hãy xem hướng dẫn trò chuyện web.

Bước 1: lấy khóa và kiểm tra endpoint

Đăng ký bằng Google hoặc email và mật khẩu, sau đó nhận tín dụng dùng thử miễn phí trên API key page. Gói dùng thử có $0,50 tín dụng, hợp lệ trong 7 ngày, một người dùng một lần và không cần thanh toán. Lưu khóa dưới dạng biến môi trường, không lưu trong mã nguồn.

Kiểm tra xem nó hoạt động với curl trước khi viết mã ứng dụng:

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."}]}'

Lời gọi đầu tiên liệt kê các mô hình và lời gọi thứ hai trả về kết quả hoàn thành trò chuyện. Nếu cả hai đều thành công, khóa API và base URL của bạn đều đúng. Mã 401 có nghĩa là khóa API sai hoặc thiếu tiền tố Bearer.

Bước 2: viết route backend

Ví dụ dưới đây sử dụng Node 18 trở lên, Express và gói openai chính thức. Cài đặt chúng bằng npm install express openai và đặt "type": "module" trong 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"));

Ba chi tiết thực hiện công việc chính ở đây. Máy chủ tự xây dựng lại danh sách tin nhắn, vì vậy một khách truy cập không thể chèn một tin nhắn hệ thống giả mạo. Nó chỉ giữ lại 10 tin nhắn cuối cùng và cắt mỗi tin nhắn xuống 4.000 ký tự, điều này kiểm soát chi phí. Và nó luôn đặt rõ các vai trò, ánh xạ bất kỳ thứ gì không xác định thành user.

Bước 3: xây dựng hộp chat

Đặt mã này vào public/index.html. Nó sử dụng JavaScript thuần không có framework, vì vậy bạn có thể dán nó vào template hiện có.

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

Sử dụng textContent thay vì innerHTML cho đầu ra mô hình ngăn phản hồi chèn markup vào trang của bạn. Hãy giữ thói quen này ngay cả khi mô hình hoạt động tốt.

Bước 4: xử lý giới hạn và lỗi

Một khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Một khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Khi bạn vượt quá, API trả về HTTP 429 với mã lỗi: rate_limited cho yêu cầu mỗi phút hoặc concurrency cho quá nhiều yêu cầu cùng lúc. Khi quá tải tạm thời, nó cũng trả về 429 với header Retry-After: 5.

Hai quy tắc thực tế tiếp theo. Đầu tiên, hãy thử lại sau độ trễ 429 với độ trễ tăng dần ngắn và hiển thị một thông báo thân thiện cho khách truy cập nếu nó tiếp tục thất bại. Thứ hai, hãy nhớ rằng một yêu cầu truyền phát giữ slot độ đồng thời của nó cho đến khi luồng kết thúc. Nếu mười khách truy cập truyền phát cùng một lúc trên một khóa đầy đủ, hai trong số họ sẽ bị từ chối, vì vậy hãy thêm một hàng đợi nhỏ hoặc giới hạn mỗi khách truy cập trên máy chủ của bạn. Một bộ đếm bộ nhớ đơn giản được đánh dấu theo IP là đủ cho một trang web nhỏ.

Các header phản hồi giúp bạn gỡ lỗi: X-Request-Id xác định một lời gọi nếu bạn liên hệ hỗ trợ, và X-Balance-USD hiển thị tín dụng còn lại của bạn. Giới hạn thân bài yêu cầu là 8 MB, cao hơn nhiều so với nhu cầu của một cuộc trò chuyện, và cửa sổ ngữ cảnh là 100.000 token.

Những cạm bẫy khi triển khai

Mã ở trên hoạt động trên localhost. Đây là những vấn đề xuất hiện khi nó được đưa lên máy chủ thực tế.

  • Proxy đệm. Một số proxy ngược giữ lại các phản hồi truyền phát cho đến khi chúng hoàn tất, vì vậy câu trả lời xuất hiện cùng một lúc. Nếu bạn sử dụng nginx, hãy tắt đệm phản hồi cho tuyến trò chuyện. Kiểm tra truyền phát thông qua cùng một chuỗi proxy mà bạn sử dụng trong môi trường sản xuất, không chỉ trên máy tính xách tay của bạn.
  • Khóa trong kho lưu trữ. Hãy giữ khóa trong một biến môi trường hoặc kho bí mật và thêm bất kỳ tệp env cục bộ nào vào danh sách bỏ qua của bạn. Nếu một khóa rơi vào một kho lưu trữ công khai, hãy tạo một khóa mới và ngừng sử dụng khóa cũ.
  • Tin tưởng client. Trình duyệt gửi lịch sử chat, vì vậy khách truy cập có thể chỉnh sửa nó. Đó là lý do tại sao máy chủ trong bước 2 đặt role chính nó và cắt độ dài tin nhắn. Không bao giờ chấp nhận tin nhắn hệ thống từ client.
  • Gọi cross-origin. Nếu trang và backend của bạn nằm trên các domain khác nhau, trình duyệt sẽ chặn yêu cầu cho đến khi máy chủ của bạn gửi đúng header CORS. Phục vụ cả hai từ một origin sẽ tránh vấn đề này.
  • Chi phí mất kiểm soát. Một khách truy cập tự động có thể gửi hàng trăm tin nhắn. Đếm số yêu cầu theo IP hoặc phiên trên máy chủ và từ chối khi số lượng quá cao. Cũng giới hạn độ dài tin nhắn, như ví dụ đã làm.
  • Markdown và liên kết. Các mô hình thường trả về danh sách và code fences. Hãy quyết định xem bạn có render chúng hay hiển thị văn bản thuần, và không bao giờ chèn văn bản phản hồi dưới dạng HTML thô.

Một kiểm tra cuối cùng là bố cục di động. Phần lớn lưu lượng chat trên các trang web công cộng đến từ điện thoại, vì vậy hãy kiểm tra với màn hình hẹp, bàn phím phần mềm đang mở và kết nối không ổn định. Nếu stream bị gián đoạn giữa chừng, khách truy cập nên có thể gửi lại mà không làm mất mạch hội thoại.

Mở rộng bot sau này

Khi quy trình chuyển tiếp cơ bản hoạt động, cùng route đó có thể làm nhiều hơn, vì API hỗ trợ các tính năng tiêu chuẩn của OpenAI. Bạn có thể yêu cầu đầu ra có cấu trúc với JSON mode bằng cách đặt response_format thành {"type": "json_object"} và nói trong prompt rằng phản hồi phải là JSON. Điều này phù hợp với biểu mẫu dẫn khách tiềm năng, chuyển đổi tin nhắn văn bản tự do thành các trường như tên, chủ đề và mức độ khẩn cấp.

Gọi hàm cho phép mô hình yêu cầu máy chủ của bạn chạy một hàm, chẳng hạn như tra cứu đơn hàng hoặc kiểm tra giờ mở cửa. Bạn truyền danh sách tools, đọc tool_calls trong phản hồi, chạy hàm đó và gửi kết quả lại dưới dạng tin nhắn với role: "tool". Mô hình sau đó viết câu trả lời cuối cùng từ dữ liệu của bạn. Đây là cách bot website lấy thông tin thực tế thay vì đoán.

Các cài đặt sampling cũng mở cho bạn. Nhiệt độ thấp hơn phù hợp với các trung tâm hỗ trợ thực tế và nhiệt độ cao hơn phù hợp với kể chuyện. Thêm một thay đổi tại một thời điểm và so sánh kết quả trên cùng năm câu hỏi kiểm tra.

Bước 5: định hình bot và đưa vào hoạt động

Prompt hệ thống xác định bot của bạn. Hãy nói cho bot biết nó là ai, nó bao gồm những gì và câu trả lời nên dài bao nhiêu. Nếu nhân vật có tính cách, các ghi chú về thiết kế nhân vật đi sâu hơn. Vì mô hình được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người lớn hợp pháp, các hàng rào bảo vệ cho khán giả của bạn là do bạn viết: xác nhận độ tuổi, liên kết báo cáo và danh sách rõ ràng về những gì bot sẽ không thảo luận. Nội dung tình dục liên quan đến người chưa thành niên không bao giờ được phép. Xem trang về sử dụng có trách nhiệm và các biện pháp bảo vệ trước khi ra mắt.

Về chi phí, bạn trả $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra. Một câu trả lời với 1.200 token đầu vào và 300 token đầu ra tốn $0,00018 cộng với $0,00015, tức là $0,00033. Nạp tiền $20 bao gồm hơn 60.000 câu trả lời như vậy. Nạp tiền chạy từ $20 đến $500, với +5% từ $50, +10% từ $100 và +15% từ $200, thanh toán bằng USDT trên TRC20 hoặc USDC trên Base. Tín dụng không bao giờ hết hạn. Trang giá cả có chi tiết, và tài liệu liệt kê mọi tham số được hỗ trợ, bao gồm gọi hàm và chế độ JSON.

Trước khi ra mắt, hãy kiểm tra với một vài cuộc trò chuyện dài, theo dõi nhật ký cho 429 và xác nhận rằng máy chủ của bạn cắt lịch sử. Các prompt không được sử dụng để huấn luyện, nhưng bạn vẫn nên nói cho khách truy cập của bạn biết những gì bạn lưu trữ.

Hỏi đáp

Tôi có thể gọi API trực tiếp từ JavaScript trên trình duyệt không?

Bạn có thể, nhưng không nên. Khóa API sẽ hiển thị với mọi khách truy cập. Hãy định tuyến yêu cầu qua máy chủ của bạn và lưu khóa trong biến môi trường.

Những ngôn ngữ và SDK nào tương thích?

Bất kỳ SDK OpenAI hoặc máy khách HTTP nào. Đặt base URL thành https://api.uncensoredchatbotapi.com/v1, sử dụng khóa của bạn làm token bearer và đặt mô hình thành uncensored. Python, Node và curl đều tương thích.

Truyền phát (streaming) có hoạt động trong trình duyệt không?

Có. API truyền phát qua SSE với stream được đặt thành true. Ví dụ chuyển văn bản qua máy chủ của bạn với fetch và StreamReader.

Điều gì xảy ra khi tôi đạt giới hạn tốc độ?

Bạn nhận được HTTP 429 với mã rate_limited hoặc concurrency. Hãy đợi và thử lại. Đối với quá tải tạm thời, tiêu đề Retry-After là 5 giây.

Khóa của bạn chỉ cách một bước

Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.

Lấy khóa APIĐọc tài liệu